기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

MCP 서버 연결

모델 컨텍스트 프로토콜(MCP) 서버는 외부 관찰성 도구, 사용자 지정 모니터링 시스템 및 운영 데이터 소스의 데이터에 대한 액세스를 제공하여 AWS DevOps 에이전트의 조사 기능을 확장합니다. 이 가이드에서는 MCP 서버를 AWS DevOps 에이전트에 연결하는 방법을 설명합니다.

요구 사항

MCP 서버를 연결하기 전에 서버가 다음 요구 사항을 충족하는지 확인합니다.

보안 고려 사항

MCP 서버를 AWS DevOps Agent에 연결할 때 다음 보안 측면을 고려하세요.

MCP 도구의 최대 도구 길이는 64입니다.

프롬프트 주입 및 공동 책임 모델에 대한 AWS DevOps 에이전트 보안 자세한 내용은 섹션을 참조하세요.

MCP 서버 등록(계정 수준)

MCP 서버는 AWS 계정 수준에서 등록되고 해당 계정의 모든 에이전트 스페이스 간에 공유됩니다. 그러면 개별 에이전트 스페이스가 각 MCP 서버에 필요한 특정 도구를 선택할 수 있습니다.

1단계: MCP 서버 세부 정보

2단계: 권한 부여 흐름

MCP 서버의 인증 방법을 선택합니다.

OAuth 클라이언트 자격 증명 - MCP 서버가 OAuth 클라이언트 자격 증명 흐름을 사용하는 경우:

OAuth 3LO(3레깅 OAuth) - MCP 서버가 인증에 OAuth 3LO를 사용하는 경우:

API 키 - MCP 서버가 API 키 인증을 사용하는 경우:

AWS SigV4 - MCP 서버가 AWS 서명 버전 4 인증을 사용하는 경우:

3단계: 권한 부여 구성

선택한 인증 방법을 기반으로 추가 권한 부여 파라미터를 구성합니다.

OAuth 클라이언트 자격 증명의 경우:

OAuth 3LO의 경우:

API 키의 경우:

For AWS SigV4:

AWS SigV4 인증을 사용하면 AWS DevOps 에이전트가 요청 서명을 위해 AWS 서명 버전 4를 사용하는 MCP 서버에 연결할 수 있습니다. 이는 Amazon API Gateway 또는 SigV4 인증을 지원하는 기타 AWS 서비스에서 호스팅되는 MCP 서버에 유용합니다.

4단계: 검토 및 제출

에이전트 스페이스에서 MCP 도구 구성

계정 수준에서 MCP 서버를 등록한 후 해당 서버에서 특정 에이전트 스페이스에 사용할 수 있는 도구를 구성할 수 있습니다.

이제AWS DevOps 에이전트는이 에이전트 스페이스에서 조사하는 동안 MCP 서버의 허용 목록에 있는 도구를 사용할 수 있습니다.

MCP 서버 연결 관리

인증 자격 증명 업데이트 - 인증 자격 증명을 업데이트해야 하는 경우 MCP 서버를 다시 등록해야 합니다. AWS DevOps 에이전트 콘솔의 기능 공급자 페이지로 이동하여 MCP 서버를 찾고 활성 연결을 제거한 다음 등록 취소를 클릭합니다. 그런 다음 새 인증 자격 증명으로 MCP 서버를 등록하고 에이전트 스페이스와 필요한 연결을 다시 생성합니다.

연결된 MCP 서버 보기 - 에이전트 스페이스에 연결된 모든 MCP 서버를 보려면 에이전트 스페이스를 선택하고 기능 탭으로 이동하여 MCP 서버 섹션을 확인합니다. 여기에서 선택한 도구를 업데이트할 수도 있습니다.

MCP 서버 연결 제거 - 에이전트 공간에서 MCP 서버를 연결 해제하려면 MCP 서버 섹션에서 서버를 선택하고 제거를 클릭합니다. MCP 서버 등록을 완전히 삭제하려면 먼저 모든 에이전트 스페이스에서 제거한 다음 계정 수준 등록을 삭제합니다.

SigV4 인증을 위한 IAM 역할 생성

AWS SigV4 인증을 사용하는 경우 AWS DevOps Agent는 계정의 IAM 역할을 수임하여 MCP 서버에 대한 요청에 서명합니다. 이 역할에는 AWS DevOps 에이전트 서비스 보안 주체(aidevops.amazonaws.com)가 혼동된 대리자 보호와 함께 이를 수임할 수 있도록 허용하는 신뢰 정책이 있어야 합니다.

신뢰 정책

다음 신뢰 정책을 사용하여 IAM 역할을 생성합니다. REGION를 AWS 리전(예: us-east-1)으로 바꾸고를 AWS 계정 IDACCOUNT_ID로 바꿉니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "aidevops.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "ACCOUNT_ID"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:aidevops:REGION:ACCOUNT_ID:service/*"
        }
      }
    }
  ]
}

신뢰 정책에는 혼동된 대리자 문제를 방지하기 위한 다음 조건이 포함됩니다.

권한 정책

MCP 서버를 호출하는 데 필요한 최소 권한을 부여하는 권한 정책을 역할에 연결합니다. 예를 들어 MCP 서버가 Amazon API Gateway 뒤에 호스팅되는 경우 역할에 API Gateway 리소스에 대한 execute-api:Invoke 권한이 있어야 합니다.

다중 리전 서명(SigV4a)

MCP 서버가 여러 AWS 리전에 배포된 경우 다중 리전 서명에 SigV4a(서명 버전 4a)를 사용할 수 있습니다. 이를 활성화하려면 SigV4 권한 부여를 구성할 때를 AWS 리전*으로 입력합니다. SigV4a는 비대칭 서명을 사용하므로 서명된 단일 요청이 여러 리전에서 유효할 수 있습니다.

관련 주제