Amazon Shipping MCPでMicrosoft Copilotと連携

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

Amazon Shipping + Microsoft Copilot

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 — Microsoft Copilotにコネクタを追加する

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

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。Amazon Shipping のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

例のプロンプト

• "マンチェスター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が使用する必要がある場合のみ、コネクタページでオンにしてください。

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

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