組態參考

此頁面提供連線至 和設定 Partner Central Agent MCP Server 的完整參考。

Endpoint

屬性	Value
URL	https://partnercentral-agents-mcp.us-east-1.api.aws/mcp
區域	us-east-1 僅限 （維吉尼亞北部）
通訊協定	透過 HTTPS 的 JSON-RPC 2.0
串流	伺服器傳送事件 (SSE)
身分驗證	AWS Signature 第 4 版
SigV4 服務名稱	partnercentral-agents-mcp
TLS 要求	TLS 1.2 或更新版本

IAM 許可

除非另有說明，否則所有 IAM 動作都會使用 partnercentral: 字首。

MCP 通訊協定存取

授予 MCP 通訊協定存取權的最簡單方法是將 AWSMcpServiceActionsFullAccess受管政策連接至您的 IAM 身分。此政策包含與 MCP 伺服器互動所需的所有許可。對於精細控制，您可以使用 IAM 政策中的 aws:IsMcpServiceAction條件索引鍵來限定 MCP 服務動作的許可範圍。

Action	說明
partnercentral:UseSession	建立、更新和擷取對話工作階段

機會管理

Action	說明
partnercentral:List*	列出機會、解決方案和其他 Partner Central 資源
partnercentral:Get*	擷取個別機會和其他資源的詳細資訊
partnercentral:CreateOpportunity	建立機會
partnercentral:UpdateOpportunity	修改機會欄位 （舞台、結束日期、收入等）
partnercentral:SubmitOpportunity	提交AWS檢閱的機會
partnercentral:AssignOpportunity	指派機會給合作夥伴代表
partnercentral:AssociateOpportunity	將機會連結到另一個資源 （解決方案等）
partnercentral:DisassociateOpportunity	移除機會與其他資源之間的連結
partnercentral:StartEngagementFromOpportunityTask	提交從機會開始參與的機會

資金計劃

Action	說明
partnercentral:ListBenefitAllocations	列出您帳戶的可用利益分配
partnercentral:ListBenefitApplications	列出提交的 利益應用程式
partnercentral:CreateBenefitApplication	建立新的利益應用程式 (MAP、POC、WMP)
partnercentral:GetBenefitApplication	擷取特定利益應用程式的詳細資訊
partnercentral:UpdateBenefitApplication	更新待定利益應用程式
partnercentral:AssociateBenefitApplicationResource	將資源連結至利益應用程式
partnercentral:DisassociateBenefitApplicationResource	從利益應用程式移除資源連結

Marketplace 存取

Action	說明
aws-marketplace:DescribeEntity	擷取市場實體的詳細資訊
aws-marketplace:SearchAgreements	搜尋市場協議
aws-marketplace:ListEntities	列出市集實體

加入代理程式

合作夥伴帳戶管理 (partnercentral)：

Action	說明
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)：

Action	說明
aws-marketplace:ListEntities	列出 Marketplace 實體 （例如賣方實體）
aws-marketplace:DescribeEntity	擷取 Marketplace 實體的完整詳細資訊
aws-marketplace:DescribeChangeSet	檢查已提交變更集的狀態
aws-marketplace:StartChangeSet	提交 Marketplace 變更集 （例如，賣方設定檔更新）

IAM — 服務連結角色 (iam)：

Action	說明
iam:GetRole	檢查 Marketplace 轉售授權服務連結角色是否存在
iam:CreateServiceLinkedRole	建立AWSServiceRoleForMarketplaceResaleAuthorization角色

目錄環境

目錄	說明
"AWS"	生產環境。所有操作都會影響即時合作夥伴資料。
"Sandbox"	隔離的測試環境。不會影響生產資料。使用 進行開發和驗證。

工作階段管理

屬性	Value
工作階段 ID 格式	UUID v4 加上session-字首 （例如 session-550e8400-e29b-41d4-a716-446655440000)
工作階段建立	在不使用 的第一次sendMessage呼叫時自動執行 sessionId
工作階段到期	工作階段建立後 48 小時 （絕對過期，非閒置型）

檔案上傳

屬性	Value
每則訊息的最大檔案數	3
影像大小限制	3.75 MB
文件大小限制	4.5 MB
允許擴充功能	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 儲存貯體。

2. 請注意 S3 URI，包括上傳versionId傳回的 。

3. 在sendMessage呼叫中包含 檔案做為document內容區塊。

S3 URI 格式範例：

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

錯誤代碼

Code	名稱	描述
-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) 事件類型

在 sendMessage 呼叫true中將 stream 設定為 時，伺服器會傳回具有下列事件類型的伺服器傳送事件：

事件類型	說明
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工具的詳細文件