Amazon Vendor Central MCPでGemini CLIと接続

💡 インストール不要？cloud.anythingmcp.comに直接アクセスして。 サインインし、Connectors → Amazon Vendor Centralをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerもgit cloneもローカルサーバーも不要です。

Amazon Vendor Central + Gemini

Selling Partner APIを通じたAmazon Vendor Central：小売購入注文、確認、出荷確認、請求書、ラベル付きのダイレクトフルフィルメント注文、梱包明細書と在庫、取引状況およびベンダーレポート。プライベートベンダーアプリのAmazonリフレッシュトークンでログイン。

前提条件

コネクタに組み込まれた完全なセットアップ手順を参照してください（コネクタを選択したときにアプリ内ストアに表示されます）。このコネクタに必要な環境変数は次のとおりです：

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, SPAPI_MARKETPLACE_ID

ステップ1 — 資格情報を取得する

セットアップには約20分かかります。Amazonによる開発者プロファイルのレビューが必要です。

1. Vendor CentralでIntegrationを開き、次にAPI Integrationを選択し、Developer Profileを完成させます。Data Accessの下でPrivate Developer: I build application(s) that integrate my own company with Amazon Services APIsを選択し、必要な役割を選んでRegisterを選択します。Amazonがプロファイルをレビューし、次のステップに関するケースを開きます。
2. 同じページでAdd new app clientを選択し、フォームを完成させ、Amazonが選択肢を提供するところでVendorsにチェックを入れ、役割を選択します。次に、LWA credentialsの下でViewを選択し、クライアント識別子をSPAPI_CLIENT_IDに、クライアントシークレットをSPAPI_CLIENT_SECRETにコピーします。
3. あなたのベンダーアカウントのためにAuthorize appを選択します。Amazonがrefresh tokenを表示します（Atzr|で始まります）：それをSPAPI_REFRESH_TOKENに貼り付けます。
4. SPAPI_ENDPOINTで地域を選択し（北米、ヨーロッパ、または極東）、あなたのAmazonストアのマーケットプレイスIDをSPAPI_MARKETPLACE_IDに入力します。例えば、ATVPDKIKX0DER（米国）、A1PA6795UKMFR9（ドイツ）、A1F83G8C2ARO7P（英国）、APJ6JRA9NG5V4（イタリア）、A13V1IB3VIYZZH（フランス）、A1RKKUPIHCS9HS（スペイン）、A1VC38T7YXB528（日本）。

役割：小売ツールにはAmazon Fulfillmentの役割が必要です。ダイレクトフルフィルメントツールにはDirect-to-Consumer Shipping (Restricted)が必要で、これは顧客の住所を含むため制限された役割です。Amazonは、付与する前にデータ保護に関するさらなる情報を求めます。ベンダーレポートにはBrand Analyticsが必要です。役割なしでの呼び出しは403で応答します。

どこから始めるか：amazon_vendor_list_purchase_ordersでpurchase_order_stateがNewのものは、Amazonが注文した内容を示します；amazon_vendor_get_purchase_orderは1つの注文の詳細を提供します。

小売調達：amazon_vendor_list_purchase_orders、amazon_vendor_get_purchase_order、amazon_vendor_list_purchase_order_statuses（受け入れた数量と受領した数量）。amazon_vendor_submit_acknowledgementsで注文に応答し、amazon_vendor_submit_shipment_confirmationsで出荷を発表し、その後amazon_vendor_list_shipmentsとamazon_vendor_list_transport_labelsで追跡します。確認と出荷確認はAmazonへの拘束力のある応答であるため、amazon_vendor_submit_acknowledgementsとamazon_vendor_submit_shipment_confirmationsはオフに設定されており、amazon_vendor_submit_invoicesも同様です：AIがそれらを送信する必要があるときにコネクタページでオンに切り替えてください；それぞれの確認を求められます。

ダイレクトフルフィルメント（あなたがAmazonの顧客に出荷する場合）：amazon_vendor_list_df_orders、amazon_vendor_get_df_order、amazon_vendor_acknowledge_df_orders、amazon_vendor_list_df_packing_slips、amazon_vendor_get_df_packing_slip、amazon_vendor_list_df_customer_invoices、amazon_vendor_list_df_shipping_labels、amazon_vendor_get_df_shipping_label、amazon_vendor_submit_df_shipment_confirmationsおよびamazon_vendor_update_df_inventory。ラベルを作成するための輸送を予約する：amazon_vendor_request_df_shipping_labelsとamazon_vendor_create_df_shipping_labelsはオフに設定されており、amazon_vendor_acknowledge_df_orders、amazon_vendor_submit_df_shipment_confirmations、amazon_vendor_submit_df_invoicesも同様です。

送信は非同期です：すべての送信ツールはtransactionIdで応答し、他には何も返しません。結果をamazon_vendor_get_transaction_status（小売）またはamazon_vendor_get_df_transaction_status（ダイレクトフルフィルメント）で読み取ります：Processing、SuccessまたはFailureとエラー。成功と表示されるまで送信を完了したとは報告しないでください。

レポート（3ステップ）：amazon_vendor_create_report、次にamazon_vendor_get_reportがDONEになるまで、最後にamazon_vendor_download_report_document。

フィールドノート：リスト呼び出しは、1回の呼び出しで最大7日間をカバーします；ダイレクトフルフィルメントリストにはcreated_afterとcreated_beforeの両方が必要です。時間はISO 8601形式です。数量には単位が付随します（小売の場合はCasesまたはEaches、ダイレクトフルフィルメントの場合はEach）；金額は通貨コード付きの10進数の文字列です。partyIdは販売者のためのあなたのベンダーコードと、出荷元および出荷先のための倉庫コードです。リストページにはpagination.nextTokenがあります。

レート制限：操作ごとに1秒あたり10回の呼び出し、バーストは10（取引状況：バースト20）。429が返された場合は、少し待ってから再度呼び出してください。

ステップ2 — アダプタをインストールする

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ3 — Geminiにコネクタを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が Amazon Vendor Central のツールを呼び出せるようになりました。

利用可能なツール

例のプロンプト

• "今週入ってきた新しいAmazon購入注文は何で、どの数量を要求していますか？"
• "注文番号2JK3S9VCのアイテムと出荷ウィンドウを表示してください。"
• "どのダイレクトフルフィルメント注文がまだ出荷ラベルを必要としていますか？"
• "取引12345-abcdeを確認してください：私が提出した請求書はAmazonに受け入れられましたか？"
• "先週のベンダー売上レポートをリクエストし、準備ができたら教えてください。"

FAQ

資格情報はどこから来ますか？ Vendor Centralのプライベートアプリから（Integration、API Integration）AmazonがあなたのDeveloper Profileをレビューした後に取得します。LWAクライアントIDとシークレットをコピーし、Authorize appを選択してリフレッシュトークンを取得し、地域とマーケットプレイスIDを入力します。AWSキーは必要ありません。

どの役割が必要ですか？ 小売ツールにはAmazon Fulfillmentが必要で、ダイレクトフルフィルメントツールには制限された役割であるDirect-to-Consumer Shippingが必要です。また、レポートにはBrand Analyticsが必要です。これはベンダー（1P）向けです；Seller Centralの販売者はAmazon Seller Centralコネクタを使用します。

どのツールがオフに設定されていますか？ Amazonへの拘束力のある応答：amazon_vendor_submit_acknowledgements、amazon_vendor_submit_shipment_confirmations、amazon_vendor_submit_invoices、amazon_vendor_acknowledge_df_orders、amazon_vendor_request_df_shipping_labels、amazon_vendor_create_df_shipping_labels、amazon_vendor_submit_df_shipment_confirmationsおよびamazon_vendor_submit_df_invoices。AIがそれらを送信する必要があるときにコネクタページでオンに切り替えてください。

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタランディングページ
• Claudeに接続する