AWS Partner Central API 参考已重新构建。有关支持的 API 操作的更多信息，请参阅 [AWS Partner Central API 参考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 配置引用
<a name="mcp-configuration-reference"></a>

本页提供了连接和配置 Partner Central Agent MCP 服务器的完整参考。

## 端点
<a name="mcp-config-endpoint"></a>


| 属性 | 值 | 
| --- | --- | 
| URL | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp | 
| Region | us-east-1仅限（弗吉尼亚北部） | 
| 协议 | JSON-RPC 2.0 通过 HTTPS | 
| 流式传输 | Server-Sent 活动 (SSE) | 
| 身份验证 | AWS签名版本 4 | 
| sigv4 服务名称 | partnercentral-agents-mcp | 
| TLS 要求 | TLS 1.2 或更高版本 | 

## IAM 权限
<a name="mcp-config-iam-permissions"></a>

除非另有说明，否则所有 IAM 操作都使用`partnercentral:`前缀。

### MCP 协议访问
<a name="mcp-config-protocol-access"></a>

授予 MCP 协议访问权限的最简单方法是将`AWSMcpServiceActionsFullAccess`托管策略附加到您的 IAM 身份。此策略包括与 MCP 服务器交互所需的所有权限。为了实现精细控制，您可以使用 IAM 策略中的`aws:IsMcpServiceAction`条件密钥来确定权限范围，专门针对 MCP 服务操作。


| 处理建议 | 说明 | 
| --- | --- | 
| partnercentral:UseSession | 创建、更新和检索对话会话 | 

### 机会管理
<a name="mcp-config-opportunity-management"></a>


| 处理建议 | 说明 | 
| --- | --- | 
| partnercentral:List\* | 列出机会、解决方案和其他合作伙伴中心资源 | 
| partnercentral:Get\* | 检索个人机会和其他资源的详细信息 | 
| partnercentral:CreateOpportunity | 创造机会 | 
| partnercentral:UpdateOpportunity | 修改机会字段（阶段、截止日期、收入等） | 
| partnercentral:SubmitOpportunity | 提交机会进行AWS审核 | 
| partnercentral:AssignOpportunity | 向合作伙伴代表分配机会 | 
| partnercentral:AssociateOpportunity | 将机会链接到其他资源（解决方案等） | 
| partnercentral:DisassociateOpportunity | 移除机会与其他资源之间的链接 | 
| partnercentral:StartEngagementFromOpportunityTask | 提交机会以从机会开始互动 | 

### 资助计划
<a name="mcp-config-funding-programs"></a>


| 处理建议 | 说明 | 
| --- | --- | 
| partnercentral:ListBenefitAllocations | 列出您账户的可用福利分配 | 
| partnercentral:ListBenefitApplications | 列出已提交的福利申请 | 
| partnercentral:CreateBenefitApplication | 创建新的福利申请（MAP、POC、WMP） | 
| partnercentral:GetBenefitApplication | 检索特定福利申请的详细信息 | 
| partnercentral:UpdateBenefitApplication | 更新待处理的福利申请 | 
| partnercentral:AssociateBenefitApplicationResource | 将资源链接到福利申请 | 
| partnercentral:DisassociateBenefitApplicationResource | 从福利申请中移除资源链接 | 

### 市场访问权限
<a name="mcp-config-marketplace-access"></a>


| 处理建议 | 说明 | 
| --- | --- | 
| aws-marketplace:DescribeEntity | 检索商城实体的详细信息 | 
| aws-marketplace:SearchAgreements | 搜索市场协议 | 
| aws-marketplace:ListEntities | 列出市场实体 | 

### 入职代理
<a name="mcp-config-onboarding-agent"></a>

**合作伙伴账户管理 (`partnercentral`)：**


| 处理建议 | 说明 | 
| --- | --- | 
| partnercentral:ListPartners | 列出该账户的合作伙伴注册情况 | 
| partnercentral:GetPartner | 检索合作伙伴注册和个人资料详情 | 
| partnercentral:GetProfileVisibility | 检索当前的个人资料可见性 (PUBLIC/PRIVATE) | 
| partnercentral:GetAllianceLeadContact | 检索联盟负责人联系信息 | 
| partnercentral:GetProfileUpdateTask | 检查待处理的异步配置文件更新的状态 | 
| partnercentral:StartProfileUpdateTask | 提交合作伙伴资料更新（异步） | 
| partnercentral:CancelProfileUpdateTask | 取消待处理的个人资料更新任务 | 
| partnercentral:PutProfileVisibility | 将个人资料可见性更改为公开或私人 | 
| partnercentral:PutAllianceLeadContact | 更新联盟牵头联系人（姓名、职务、电子邮件） | 
| partnercentral:SendEmailVerificationCode | 为基于电子邮件的更改发送 domain/contact 验证码 | 
| 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 角色 | 

## 目录环境
<a name="mcp-config-catalog-environments"></a>


| 目录 | 说明 | 
| --- | --- | 
| "AWS" | 生产环境。所有操作都会影响实时合作伙伴数据。 | 
| "Sandbox" | 隔离的测试环境。对生产数据没有影响。用于开发和验证。 | 

## 会话管理
<a name="mcp-config-session-management"></a>


| 属性 | 值 | 
| --- | --- | 
| 会话 ID 格式 | 带session-前缀的 UUID v4（例如）session-550e8400-e29b-41d4-a716-446655440000 | 
| 会话创建 | 首次sendMessage通话时自动通话，不用 sessionId | 
| 会话到期 | 会话创建后 48 小时（绝对到期，不基于非活动状态） | 

## 文件上传
<a name="mcp-config-file-upload"></a>


| 属性 | 值 | 
| --- | --- | 
| 每封邮件的最大文件数 | 3 | 
| 图像大小限制 | 3.75 MB | 
| 文档大小限制 | 4.5 MB | 
| 允许的扩展 | doc, docx, pdf, png, jpeg, xlsx, csv, txt | 
| S3 存储桶（生产） | aws-partner-central marketplace-phemeral-writeonly | 
| 上传路径 | s3://{bucket}/{aws-account-id}/ | 
| S3 网址要求 | 必须包含versionId查询参数 | 

### 上传工作流程
<a name="mcp-config-upload-workflow"></a>

1. 将您的文件上传到AWS账户 ID 前缀下的相应的 S3 存储桶。

1. 记下包括上传`versionId`返回的 S3 URI。

1. 将该文件作为`document`内容块包含在`sendMessage`通话中。

S3 URI 格式示例：

```
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
```

## 错误代码
<a name="mcp-config-error-codes"></a>


| 代码 | Name | 说明 | 
| --- | --- | --- | 
| -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 | Server-side 错误。重试请求。 | 

## 速率限制
<a name="mcp-config-rate-limits"></a>

服务器强制执行每个账户的速率限制：


| 操作 | 持续汇率 | 突增 | 
| --- | --- | --- | 
| sendMessage | 每分钟 2 个请求 | 10 | 
| 所有其他操作 | 每分钟 10 个请求 | 20 | 

如果超过这些限制，服务器将返回错误代码 `-32004` (LIMIT\_UXCHERED)。在客户端中使用抖动实现指数级退避，以优雅地处理速率限制。

## 直播 (SSE) 事件类型
<a name="mcp-config-sse-events"></a>

当`stream`在`sendMessage`调用`true`中设置为时，服务器会返回具有以下 Server-Sent 事件类型的事件：


| 事件类型 | 说明 | 
| --- | --- | 
| stream\_start | 直播连接已建立 | 
| assistant-response.start | 代理已开始生成响应 | 
| assistant-response.delta | 代理响应的增量文本块 | 
| assistant-response.completed | 代理已完成响应的生成 | 
| server-tool-use | 代理正在调用内部工具（读取操作） | 
| server-tool-response | 内部工具调用的结果 | 
| tool\_approval\_request | 代理正在请求人工批准写入操作 | 
| stream\_end | 直播连接关闭 | 
| done | 最后一个事件，表示 SSE 直播已完成 | 

## 后续步骤
<a name="mcp-config-next-steps"></a>
+ [https://docs.aws.amazon.com/partner-central/latest/APIReference/mcp-tools-reference.html](https://docs.aws.amazon.com/partner-central/latest/APIReference/mcp-tools-reference.html) — `sendMessage` 和`getSession`工具的详细文档