对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
配置引用
本页提供连接和配置 Partner Central 代理 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 协议访问
作为经过 AWS 身份验证的身份，默认情况下，您拥有对 MCP 服务器的协议访问权限。您无需明确的 IAM 允许即可访问协议。
对于 OAuth 身份验证，需要以下登录权限：
| 处理建议 | 说明 |
|---|---|
signin:AuthorizeOAuth2Access |
授权基于浏览器的 OAuth 流程 |
signin:CreateOAuth2Token |
发行和刷新 OAuth 访问令牌 |
要限制 MCP 访问权限，请在上应用显式拒绝。partnercentral:InvokeMcp
机会管理
| 处理建议 | 说明 |
|---|---|
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 |
获取或更新关联账户之间的共享偏好 |
商城卖家设置 (aws-marketplace)：
| 处理建议 | 说明 |
|---|---|
aws-marketplace:ListEntities |
列出商城实体（例如，卖方实体） |
aws-marketplace:DescribeEntity |
检索商城实体的完整详细信息 |
aws-marketplace:DescribeChangeSet |
检查已提交的变更集的状态 |
aws-marketplace:StartChangeSet |
提交商城变更集（例如，卖家资料更新） |
IAM — 服务相关角色 (iam)：
| 处理建议 | 说明 |
|---|---|
iam:GetRole |
检查商城转售授权服务相关角色是否存在 |
iam:CreateServiceLinkedRole |
创建 AWSServiceRoleForMarketplaceResaleAuthorization 角色 |
目录环境
| 目录 | 说明 |
|---|---|
"AWS" |
生产环境。所有操作都会影响实时合作伙伴数据。 |
"Sandbox" |
隔离的测试环境。对生产数据没有影响。用于开发和验证。 |
会话管理
| 属性 | 值 |
|---|---|
| 会话 ID 格式 | 带session-前缀的 UUID v4（例如，）session-550e8400-e29b-41d4-a716-446655440000 |
| 会话创建 | 第一次sendMessage通话时自动通话，没有 sessionId |
| 会话到期 | 会话创建后 48 小时（绝对到期，不是基于不活动） |
文件上传
| 属性 | 值 |
|---|---|
| 每条消息的最大文件数 | 3 |
| 图像大小限制 | 3.75 兆字节 |
| 文档大小限制 | 4.5 兆字节 |
| 允许的扩展 | doc, docx, pdf, png,
jpeg, xlsx, csv,
txt |
| S3 存储桶（生产） | aws合作伙伴中心商城临时只写文件 |
| 上传路径 | s3://{bucket}/{aws-account-id}/ |
| S3 URI 要求 | 必须包含versionId查询参数 |
上传工作流程
使用您的 AWS 账户 ID 前缀将您的文件上传到相应的 S3 存储桶。
注意 S3 URI，包括上传时
versionId返回的 URI。在
sendMessage通话中将该文件作为document内容块包括在内。
示例 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_EXCEED)。在客户端中使用抖动实现指数回退，以正常处理速率限制。
直播 (SSE) 事件类型
在sendMessage调用true中设置stream为时，服务器返回具有以下 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工具的详细文档
