AWS Partner Central API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、 AWS Partner Central API リファレンスを参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
設定リファレンス
このページでは、 Partner Central Agent MCP Server に接続して設定するための完全なリファレンスを提供します。
Endpoint
| プロパティ | 値 |
|---|---|
| [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 アクセス許可
特に明記されていない限り、すべての IAM アクションは partnercentral: プレフィックスを使用します。
MCP プロトコルアクセス
MCP プロトコルアクセスを許可する最も簡単な方法は、AWSMcpServiceActionsFullAccessマネージドポリシーを IAM アイデンティティにアタッチすることです。このポリシーには、MCP サーバーとやり取りするために必要なすべてのアクセス許可が含まれます。きめ細かな制御のために、IAM ポリシーの aws:IsMcpServiceAction条件キーを使用して、特に MCP サービスアクションに対するアクセス許可の範囲を設定できます。
| [アクション] | 説明 |
|---|---|
partnercentral:UseSession |
会話セッションの作成、更新、取得 |
オポチュニティ管理
| [アクション] | 説明 |
|---|---|
partnercentral:List* |
機会、ソリューション、その他の Partner Central リソースを一覧表示する |
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 |
メリットアプリケーションからリソースリンクを削除する |
Marketplace アクセス
| [アクション] | 説明 |
|---|---|
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 |
プロファイルの可視性を 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 ロールを作成する |
カタログ環境
| カタログ | 説明 |
|---|---|
"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-ephemeral-writeonly-files |
| アップロードパス | s3://{bucket}/{aws-account-id}/ |
| S3 URI 要件 | versionId クエリパラメータを含める必要があります |
ワークフローをアップロードする
AWSアカウント ID プレフィックスの下にある適切な S3 バケットにファイルをアップロードします。
アップロードによって
versionId返された を含む S3 URI に注意してください。sendMessage呼び出しに ファイルをdocumentコンテンツブロックとして含めます。
S3 URI 形式の例:
s3://aws-partner-central-marketplace-ephemeral-writeonly-files/123456789012/my-document.pdf?versionId=abc123
エラーコード
| コード | 名前 | 説明 |
|---|---|---|
-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 |
サーバー側のエラー。リクエストを再試行します。 |
レート制限
サーバーはアカウントごとのレート制限を適用します。
| 運用 | 持続率 | [Burst] (バースト) |
|---|---|---|
sendMessage |
1 分あたり 2 個のリクエスト | 10 |
| その他すべてのオペレーション | 1 分あたり 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ツールの詳細なドキュメント