AWS Partner Central API 参考已重新构建。有关支持的 API 操作的更多信息，请参阅 AWS Partner Central API 参考。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
配置引用
本页提供了连接和配置 Partner Central Agent MCP 服务器的完整参考。
端点
| 属性 | 值 |
|---|---|
| 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 权限
除非另有说明，否则所有 IAM 操作都使用partnercentral:前缀。
MCP 协议访问
授予 MCP 协议访问权限的最简单方法是将AWSMcpServiceActionsFullAccess托管策略附加到您的 IAM 身份。此策略包括与 MCP 服务器交互所需的所有权限。为了实现精细控制，您可以使用 IAM 策略中的aws:IsMcpServiceAction条件密钥来确定权限范围，专门针对 MCP 服务操作。
| 处理建议 | 说明 |
|---|---|
partnercentral:UseSession |
创建、更新和检索对话会话 |
机会管理
| 处理建议 | 说明 |
|---|---|
partnercentral:List* |
列出机会、解决方案和其他合作伙伴中心资源 |
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 |
从福利申请中移除资源链接 |
市场访问权限
| 处理建议 | 说明 |
|---|---|
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 |
将个人资料可见性更改为公开或私人 |
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 角色 |
目录环境
| 目录 | 说明 |
|---|---|
"AWS" |
生产环境。所有操作都会影响实时合作伙伴数据。 |
"Sandbox" |
隔离的测试环境。对生产数据没有影响。用于开发和验证。 |
会话管理
| 属性 | 值 |
|---|---|
| 会话 ID 格式 | 带session-前缀的 UUID v4（例如）session-550e8400-e29b-41d4-a716-446655440000 |
| 会话创建 | 首次sendMessage通话时自动通话，不用 sessionId |
| 会话到期 | 会话创建后 48 小时（绝对到期，不基于非活动状态） |
文件上传
| 属性 | 值 |
|---|---|
| 每封邮件的最大文件数 | 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查询参数 |
上传工作流程
将您的文件上传到AWS账户 ID 前缀下的相应的 S3 存储桶。
记下包括上传
versionId返回的 S3 URI。将该文件作为
document内容块包含在sendMessage通话中。
S3 URI 格式示例：
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
错误代码
| 代码 | 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 错误。重试请求。 |
速率限制
服务器强制执行每个账户的速率限制：
| 操作 | 持续汇率 | 突增 |
|---|---|---|
sendMessage |
每分钟 2 个请求 | 10 |
| 所有其他操作 | 每分钟 10 个请求 | 20 |
如果超过这些限制，服务器将返回错误代码 -32004 (LIMIT_UXCHERED)。在客户端中使用抖动实现指数级退避，以优雅地处理速率限制。
直播 (SSE) 事件类型
当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 直播已完成 |
后续步骤
工具参考 —
sendMessage和getSession工具的详细文档