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>


| プロパティ | 値 | 
| --- | --- | 
| [URL] | https://partnercentral-agents-mcp.us-east-1.api.aws/mcp | 
| リージョン | us-east-1 (バージニア北部) のみ | 
| プロトコル | HTTPS 経由の JSON-RPC 2.0 | 
| ストリーミング | サーバー送信イベント (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\* | 機会、ソリューション、その他の 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>


| [アクション] | 説明 | 
| --- | --- | 
| 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>


| [アクション] | 説明 | 
| --- | --- | 
| 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 | プロファイルの可視性を PUBLIC または PRIVATE に変更する | 
| partnercentral:PutAllianceLeadContact | 提携リードの連絡先 (名前、タイトル、E メール) を更新する | 
| partnercentral:SendEmailVerificationCode | E メールベースのドメイン/連絡先の変更の検証コードを送信する | 
| partnercentral:AssociateAwsTrainingCertificationEmailDomain | E メールドメインをリンクしてトレーニング証明書を追跡する | 
| partnercentral:DisassociateAwsTrainingCertificationEmailDomain | リンクされたトレーニング証明書 E メールドメインを削除する | 
| 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-ephemeral-writeonly-files | 
| アップロードパス | s3://{bucket}/{aws-account-id}/ | 
| S3 URI 要件 | versionId クエリパラメータを含める必要があります | 

### ワークフローをアップロードする
<a name="mcp-config-upload-workflow"></a>

1. AWSアカウント ID プレフィックスの下にある適切な S3 バケットにファイルをアップロードします。

1. アップロードによって`versionId`返された を含む S3 URI に注意してください。

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>


| コード | 名前 | 説明 | 
| --- | --- | --- | 
| -32001 | AUTHENTICATION\_FAILURE | SigV4 署名が無効であるか、認証情報の有効期限が切れています | 
| -31004 | TOOL\_PERMISSION\_DENIED | IAM ID にこのオペレーションに必要な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>

サーバーはアカウントごとのレート制限を適用します。


| 運用 | 持続率 | [Burst] (バースト) | 
| --- | --- | --- | 
| sendMessage | 1 分あたり 2 個のリクエスト | 10 | 
| その他すべてのオペレーション | 1 分あたり 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` ツールの詳細なドキュメント