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 Server 的完整參考。

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


| 屬性 | 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 許可
<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 服務動作的許可範圍。


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

### 機會管理
<a name="mcp-config-opportunity-management"></a>


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

### 資金計劃
<a name="mcp-config-funding-programs"></a>


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

### Marketplace 存取
<a name="mcp-config-marketplace-access"></a>


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

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

**合作夥伴帳戶管理 (`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角色 | 

## 目錄環境
<a name="mcp-config-catalog-environments"></a>


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

## 工作階段管理
<a name="mcp-config-session-management"></a>


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

## 檔案上傳
<a name="mcp-config-file-upload"></a>


| 屬性 | 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查詢參數 | 

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

1. 將檔案上傳至AWS帳戶 ID 字首下適當的 S3 儲存貯體。

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

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

S3 URI 格式範例：

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

## 錯誤代碼
<a name="mcp-config-error-codes"></a>


| 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 | 伺服器端錯誤。重試 請求。 | 

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

伺服器會強制執行每個帳戶速率限制：


| 作業 | 持續費率 | 爆量 | 
| --- | --- | --- | 
| sendMessage | 每分鐘 2 個請求 | 10 | 
| 所有其他操作 | 每分鐘 10 個請求 | 20 | 

如果您超過這些限制，伺服器會傳回錯誤碼 `-32004`(LIMIT\_EXCEEDED)。在用戶端中實作具有抖動的指數退避，以正常處理速率限制。

## 串流 (SSE) 事件類型
<a name="mcp-config-sse-events"></a>

在 `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 串流完成的最終事件 | 

## 後續步驟
<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`工具的詳細文件