Amazon Shipping MCPでGemini CLIと連携

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

Amazon Shipping + Gemini

Amazon Shipping API v2 (SP-API)は、Amazonをキャリアとして利用する企業向けです：料金の比較、荷物の追跡、ラベルや書類の再取得、ロッカーや受取カウンターの検索、集荷フォームの確認ができます。購入、一括購入、キャンセルは含まれていますが、オフになっています。Amazon Logisticsの役割を持つプライベートSP-APIアプリです。

前提条件

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

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

ステップ1 — 認証情報を取得する

セットアップには約20分かかります。プラスAmazonレビューが必要です。

1. Amazon Shippingアカウントが必要です。Amazonの販売者はSeller Centralアカウントを使用し、他の配送業者はhttps://solutionproviderportal.amazon.comでアカウントを作成し（販売者アカウントは不要）、開発者の身分確認を完了します。
2. 開発者プロファイルを完成させます：データアクセスにはプライベート開発者：自社をAmazon Services APIと統合するアプリケーションを構築しますを選択し、役割にはAmazon Logisticsを選択します。Amazonからの回答は約5営業日以内です。
3. AmazonShipping_YourCompanyという名前のSP-APIアプリクライアントを作成し、ShippingビジネスエンティティとAmazon Logistics役割を設定し、制限された（PII）データアクセスの委任にはいいえと答えます。
4. LWA認証情報の下で表示を選択し、クライアント識別子（amzn1.application-oa2-client.…）をSPAPI_CLIENT_IDに、クライアントシークレットをSPAPI_CLIENT_SECRETにコピーします。
5. 自分のアカウントのためにアプリを認証し（アプリを認証）、リフレッシュトークン（Atzr|…）をSPAPI_REFRESH_TOKENにコピーします。
6. SPAPI_ENDPOINTに地域を選択し、AMAZON_SHIPPING_BUSINESS_IDに自分のAmazon Shipping国を選択します。アメリカ合衆国：北アメリカ。イギリス、フランス、イタリア、スペイン、インド、アラブ首長国連邦、サウジアラビア、エジプト：ヨーロッパ。日本：極東。

コネクタはhttps://api.amazon.com/auth/o2/tokenでリフレッシュトークンを1時間のアクセストークンに交換し、x-amz-access-tokenヘッダーに送信します；x-amzn-shipping-business-idヘッダーには国が含まれます。変数はAmazon Seller Centralコネクタと同じ名前ですが、アプリはAmazon Logisticsの役割を持っている必要があります：それがない販売アプリの認証情報は403を返します。

最初の実際のラベルの前に：Amazonは新しい統合ごとにテストラベルを生成し、承認を受けることを求めます（Amazon Shipping Test Label Guide）その後、最初の出荷日を確認します。それが完了するまで購入ツールはオフのままにしてください。

どこから始めるか：amazon_shipping_get_ratesを使用して、発送元住所、宛先、1つのパッケージを指定すると、サービスと価格が返されます；amazon_shipping_get_trackingは追跡IDとキャリアIDで荷物を追跡します。

料金：amazon_shipping_get_ratesは、各パッケージに自分のpackageClientReferenceId、寸法、重量、保険価値、少なくとも1つのアイテムが必要です。channel_details.channelTypeは、自分のショップからの注文にはEXTERNAL、Amazonの注文にはAMAZON（Amazonの注文ID付き）です。応答にはrequestTokenとサービスごとのrateIdが含まれます；両方とも購入に必要で、10分後に期限切れになります。料金がrequiresAdditionalInputsと表示される場合は、amazon_shipping_get_additional_inputsでスキーマを確認してください。

追跡と書類：amazon_shipping_get_trackingは要約ステータスとイベント履歴を返します；amazon_shipping_get_shipment_documentsは購入したパッケージのラベルを再取得します（base64）し、出荷IDと自分のpackageClientReferenceIdが必要です。amazon_shipping_get_access_pointsは郵便番号近くのロッカーとカウンターを見つけます。

集荷フォーム：amazon_shipping_get_unmanifested_shipmentsはまだマニフェストを待っているものを表示し、amazon_shipping_get_collection_form_historyとamazon_shipping_get_collection_formは以前のフォームを読み、amazon_shipping_get_carrier_accountsはリンクされたキャリアアカウントをリストします。amazon_shipping_generate_collection_formはキャリアの未処理の出荷を完了させ、オフの状態でインストールされます。

購入（オフの状態）：amazon_shipping_purchase_shipmentは料金を購入し、amazon_shipping_one_click_shipmentは料金リクエストなしでサービスIDで購入し、amazon_shipping_direct_purchase_shipmentはAmazonが選択したサービスでAmazonの注文を購入し、amazon_shipping_cancel_shipmentは引き渡し前に購入した出荷をキャンセルします。各購入はAmazon Shippingアカウントに請求されます。冪等性キーを渡し、再試行時に再利用してください。タイムアウトが発生しても二重購入はありません。

フォーマット：金額はvalueとunit（通貨）を持つオブジェクトです；重量はGRAM、KILOGRAM、OUNCEまたはPOUNDを使用し、寸法はINCHまたはCENTIMETERを使用します；時間はISO 8601です。応答はpayloadでラップされ、失敗はerrorsとして返され、code、message、detailsのリストが含まれます。

制限：ほとんどの操作で1秒あたり80回の呼び出し、バーストで100回；応答ヘッダーx-amzn-RateLimit-Limitは適用された制限を示します。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 Shipping のツールを呼び出せるようになりました。

利用可能なツール

例のプロンプト

• "マンチェスターM1 1AEからロンドンSW1A 1AAへの2kgの荷物のAmazon Shipping料金を比較してください。"
• "Amazon Shippingの荷物QA0123456789を追跡し、最後のスキャンを教えてください。"
• "郵便番号EC1A 1BB近くのAmazonロッカーを見つけてください。"
• "今朝購入した出荷のラベルを再取得してください。"
• "まだ集荷フォームに載っていない出荷はどれですか？"

よくある質問

認証情報はどこから来ますか？ Amazon Logisticsの役割を持つプライベートSP-APIアプリから、Seller Centralで作成するか、販売者アカウントなしでAmazon Solution Provider Portalで作成します。LWAクライアントIDとシークレットをコピーし、自分のアカウントのためにアプリを認証してリフレッシュトークンを取得し、地域とAmazon Shipping国を選択します。

どの国をカバーしていますか？ Amazon Shippingが運営されている国：アメリカ合衆国、イギリス、フランス、イタリア、スペイン、インド、アラブ首長国連邦、サウジアラビア、エジプト、日本です。Amazonをキャリアとして利用する荷物のためのもので、Amazonからの注文でないものにも適用されます。

ラベルを購入したり、出荷をキャンセルしたりできますか？ amazon_shipping_purchase_shipment、amazon_shipping_direct_purchase_shipment、amazon_shipping_one_click_shipment、amazon_shipping_cancel_shipment、amazon_shipping_generate_collection_formはオフの状態でインストールされます。AIが使用する必要がある場合のみ、コネクタページでオンにしてください。

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

次のステップ

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