AWS Partner Central API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 AWS Partner Central API 참조를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
구성 참조
이 페이지에서는 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 쿼리 파라미터를 포함해야 합니다. |
업로드 워크플로
AWS계정 ID 접두사 아래의 해당 S3 버킷에 파일을 업로드합니다.
업로드에서
versionId반환된를 포함하여 S3 URI를 기록해 둡니다.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 스트림이 완료되었음을 나타내는 최종 이벤트 |
다음 단계
도구 참조 -
sendMessage및getSession도구에 대한 세부 설명서
