AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 [AWS Partner Central API 참조](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 구성 참조
이 페이지에서는 Partner Central Agent MCP 서버에 연결하고 구성하기 위한 전체 참조를 제공합니다.
## 엔드포인트
| 속성 | 값 |
| --- | --- |
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp |
| 리전 | us-east-1 (버지니아 북부)만 해당 |
| 프로토콜 | HTTPS를 통한 JSON-RPC 2.0 |
| 스트리밍 | Server-Sent Events(SSE) |
| Authentication | AWS서명 버전 4 |
| SigV4 서비스 이름 | partnercentral-agents-mcp |
| TLS 요구 사항 | TLS 1.2 이상 |
## IAM 권한
달리 명시되지 않는 한 모든 IAM 작업은 `partnercentral:` 접두사를 사용합니다.
### MCP 프로토콜 액세스
MCP 프로토콜 액세스 권한을 부여하는 가장 간단한 방법은 `AWSMcpServiceActionsFullAccess` 관리형 정책을 IAM 자격 증명에 연결하는 것입니다. 이 정책에는 MCP 서버와 상호 작용하는 데 필요한 모든 권한이 포함됩니다. 세분화된 제어를 위해 IAM 정책의 `aws:IsMcpServiceAction` 조건 키를 사용하여 특히 MCP 서비스 작업에 대한 권한의 범위를 지정할 수 있습니다.
| 작업 | 설명 |
| --- | --- |
| partnercentral:UseSession | 대화 세션 생성, 업데이트 및 검색 |
### 기회 관리
| 작업 | 설명 |
| --- | --- |
| partnercentral:List\* | 기회, 솔루션 및 기타 Partner Central 리소스 나열 |
| partnercentral:Get\* | 개별 기회 및 기타 리소스에 대한 세부 정보 검색 |
| partnercentral:CreateOpportunity | 기회 생성 |
| partnercentral:UpdateOpportunity | 기회 필드 수정(스테이지, 종료일, 수익 등) |
| partnercentral:SubmitOpportunity | AWS검토할 기회 제출 |
| partnercentral:AssignOpportunity | 파트너 담당자에게 기회 할당 |
| partnercentral:AssociateOpportunity | 기회를 다른 리소스(솔루션 등)에 연결 |
| partnercentral:DisassociateOpportunity | 기회와 다른 리소스 간의 링크 제거 |
| partnercentral:StartEngagementFromOpportunityTask | 기회에서 참여를 시작할 수 있는 기회 제출 |
### 자금 지원 프로그램
| 작업 | 설명 |
| --- | --- |
| partnercentral:ListBenefitAllocations | 계정에 사용 가능한 혜택 할당 나열 |
| partnercentral:ListBenefitApplications | 제출된 혜택 애플리케이션 나열 |
| partnercentral:CreateBenefitApplication | 새 혜택 애플리케이션(MAP, POC, WMP) 생성 |
| partnercentral:GetBenefitApplication | 특정 혜택 애플리케이션의 세부 정보 검색 |
| partnercentral:UpdateBenefitApplication | 보류 중인 혜택 애플리케이션 업데이트 |
| partnercentral:AssociateBenefitApplicationResource | 리소스를 혜택 애플리케이션에 연결 |
| partnercentral:DisassociateBenefitApplicationResource | 혜택 애플리케이션에서 리소스 링크 제거 |
### Marketplace 액세스
| 작업 | 설명 |
| --- | --- |
| aws-marketplace:DescribeEntity | 마켓플레이스 개체의 세부 정보 검색 |
| aws-marketplace:SearchAgreements | 마켓플레이스 계약 검색 |
| aws-marketplace:ListEntities | 마켓플레이스 엔터티 나열 |
### 온보딩 에이전트
**파트너 계정 관리(`partnercentral`):**
| 작업 | 설명 |
| --- | --- |
| partnercentral:ListPartners | 계정에 대한 파트너 등록 나열 |
| partnercentral:GetPartner | 파트너 등록 및 프로필 세부 정보 검색 |
| partnercentral:GetProfileVisibility | 현재 프로필 가시성 검색(PUBLIC/PRIVATE) |
| partnercentral:GetAllianceLeadContact | 제휴 책임자 연락처 정보 검색 |
| partnercentral:GetProfileUpdateTask | 보류 중인 비동기 프로필 업데이트 상태 확인 |
| partnercentral:StartProfileUpdateTask | 파트너 프로필 업데이트 제출(비동기) |
| partnercentral:CancelProfileUpdateTask | 보류 중인 프로필 업데이트 작업 취소 |
| partnercentral:PutProfileVisibility | 프로필 가시성을 PUBLIC 또는 PRIVATE로 변경 |
| partnercentral:PutAllianceLeadContact | 제휴 리드 연락처 업데이트(이름, 제목, 이메일) |
| partnercentral:SendEmailVerificationCode | 이메일 기반 도메인/연락처 변경에 대한 확인 코드 전송 |
| partnercentral:AssociateAwsTrainingCertificationEmailDomain | 훈련 인증 추적을 위한 이메일 도메인 연결 |
| partnercentral:DisassociateAwsTrainingCertificationEmailDomain | 연결된 훈련 인증 이메일 도메인 제거 |
| partnercentral:GetAccountConnections | 활성 계정 연결 나열(예: 자회사 링크) |
| partnercentral:GetConnectionInvitations | 보류 중인 전송 및 수신된 연결 초대 나열 |
| partnercentral:CreateConnectionInvitation | 다른AWS계정으로 연결 초대 전송 |
| partnercentral:CancelConnectionInvitation | 보류 중인 발신 연결 초대 취소 |
| partnercentral:RespondConnectionInvitation | 수신 연결 초대 수락 또는 거부 |
| partnercentral:CancelConnection | 활성 계정 연결 취소 |
| partnercentral:ManageConnectionPreferences | 연결된 계정 간 공유 기본 설정 가져오기 또는 업데이트 |
**Marketplace 판매자 설정(`aws-marketplace`):**
| 작업 | 설명 |
| --- | --- |
| aws-marketplace:ListEntities | Marketplace 엔터티 나열(예: 판매자 엔터티) |
| aws-marketplace:DescribeEntity | Marketplace 개체의 전체 세부 정보 검색 |
| aws-marketplace:DescribeChangeSet | 제출된 변경 세트의 상태 확인 |
| aws-marketplace:StartChangeSet | Marketplace 변경 세트 제출(예: 판매자 프로필 업데이트) |
**IAM - 서비스 연결 역할(`iam`):**
| 작업 | 설명 |
| --- | --- |
| iam:GetRole | Marketplace 재판매 권한 부여 서비스 연결 역할이 존재하는지 확인 |
| iam:CreateServiceLinkedRole | AWSServiceRoleForMarketplaceResaleAuthorization 역할 만들기 |
## 카탈로그 환경
| 카탈로그 | 설명 |
| --- | --- |
| "AWS" | 프로덕션 환경. 모든 작업은 라이브 파트너 데이터에 영향을 미칩니다. |
| "Sandbox" | 격리된 테스트 환경. 프로덕션 데이터에 영향을 미치지 않습니다. 개발 및 검증에 사용합니다. |
## 세션 관리
| 속성 | 값 |
| --- | --- |
| 세션 ID 형식 | session- 접두사가 있는 UUID v4(예: session-550e8400-e29b-41d4-a716-446655440000) |
| 세션 생성 | 가 없는 첫 번째 sendMessage 호출 시 자동 sessionId |
| 세션 만료 | 세션 생성 후 48시간(비활동 기반이 아닌 절대 만료) |
## 파일 업로드
| 속성 | 값 |
| --- | --- |
| 메시지당 최대 파일 수 | 3 |
| 이미지 크기 제한 | 3.75MB |
| 문서 크기 제한 | 4.5MB |
| 허용된 확장 | doc, docx, pdf, png, jpeg, xlsx, csv, txt |
| S3 버킷(프로덕션) | aws-partner-central-marketplace-ephemeral-writeonly-files |
| 업로드 경로 | s3://{bucket}/{aws-account-id}/ |
| S3 URI 요구 사항 | versionId 쿼리 파라미터를 포함해야 합니다. |
### 업로드 워크플로
1. AWS계정 ID 접두사 아래의 해당 S3 버킷에 파일을 업로드합니다.
1. 업로드에서 `versionId` 반환된를 포함하여 S3 URI를 기록해 둡니다.
1. `sendMessage` 호출에 파일을 `document` 콘텐츠 블록으로 포함합니다.
S3 URI 형식의 예:
```
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
```
## 오류 코드
| 코드 | 이름 | 설명 |
| --- | --- | --- |
| -32001 | AUTHENTICATION\_FAILURE | SigV4 서명이 유효하지 않거나 자격 증명이 만료되었습니다. |
| -31004 | TOOL\_PERMISSION\_DENIED | IAM 자격 증명에이 작업에 필요한 partnercentral: 작업이 없음 |
| -32002 | ACCESS\_DENIED | 일반 액세스 거부됨(계정이 등록되지 않음, 리전 불일치 등) |
| -32004 | LIMIT\_EXCEEDED | 속도 제한 또는 할당량을 초과했습니다. 지수 백오프를 사용하여 재시도합니다. |
| -30001 | RESOURCE\_NOT\_FOUND | 요청된 리소스(세션, 기회 등)가 존재하지 않음 |
| -32600 | INVALID\_REQUEST | 잘못된 JSON-RPC 요청 또는 잘못된 파라미터 |
| -32603 | INTERNAL\_ERROR | 서버 측 오류입니다. 요청을 다시 시도하세요. |
## 속도 제한
서버는 계정당 속도 제한을 적용합니다.
| 연산 | 지속 속도 | 버스트 |
| --- | --- | --- |
| sendMessage | 분당 요청 2개 | 10 |
| 기타 모든 작업 | 분당 요청 10개 | 20 |
이러한 제한을 초과하면 서버가 오류 코드`-32004`(LIMIT\_EXCEEDED)를 반환합니다. 클라이언트에서 지터를 사용하여 지수 백오프를 구현하여 속도 제한을 정상적으로 처리합니다.
## 스트리밍(SSE) 이벤트 유형
`stream`가 `sendMessage` 호출`true`에서 로 설정된 경우 서버는 다음 이벤트 유형과 함께 Server-Sent Events를 반환합니다.
| 이벤트 유형 | 설명 |
| --- | --- |
| stream\_start | 스트림 연결 설정됨 |
| assistant-response.start | 에이전트가 응답 생성을 시작했습니다. |
| assistant-response.delta | 에이전트 응답의 증분 텍스트 청크 |
| assistant-response.completed | 에이전트가 응답 생성을 완료했습니다. |
| server-tool-use | 에이전트가 내부 도구를 호출하고 있음(읽기 작업) |
| server-tool-response | 내부 도구 호출 결과 |
| tool\_approval\_request | 에이전트가 쓰기 작업에 대한 인적 승인을 요청하고 있습니다. |
| stream\_end | 스트림 연결 닫기 |
| done | SSE 스트림이 완료되었음을 나타내는 최종 이벤트 |
## 다음 단계
+ [**도구 참조**](https://docs.aws.amazon.com/partner-central/latest/APIReference/mcp-tools-reference.html) - `sendMessage` 및 `getSession` 도구에 대한 세부 설명서