DHL PaketとMicrosoft CopilotをMCPで連携

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → DHL Paket Versand (Geschäftskunden) をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

DHL Parcel DE Shipping + Microsoft Copilot

自社の DHL 法人契約（Geschäftskundenkonto）で、AI から DHL Paket の発送を手配します。公式の Parcel DE Shipping API v2 を使い、予約前の発送データの確認、発送の予約と追跡番号およびラベルの取得、ラベルの再ダウンロード、発送の取り消し、日次締め（Tagesabschluss）、マニフェストの取得ができます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

DHL_API_KEY, DHL_API_SECRET, DHL_GKP_USERNAME, DHL_GKP_PASSWORD

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

セットアップは約 15 分で、これに DHL がアプリを承認するまでの時間が加わります。DHL Geschäftskundenportal（GKP）にアクセスできる DHL の法人契約と、developer.dhl.com のアカウントが必要です。

1. developer.dhl.com で My Apps → Create App を開き、API Parcel DE Shipping (Post & Parcel Germany) を追加します。DHL がアプリを承認したら、API Key を DHL_API_KEY に、API Secret を DHL_API_SECRET にコピーします。
2. Geschäftskundenportal で発送を作成できるユーザーを選び、ユーザー名を DHL_GKP_USERNAME に、パスワードを DHL_GKP_PASSWORD に入力します。専用のシステムユーザーが最適です（Benutzerverwaltung → Systembenutzer anlegen）。個人の GKP ユーザーでも動きますが、そのパスワードは定期的に期限切れになります。
3. コネクターをインストールします。Authorize with Provider の手順はありません。AnythingMCP が 4 つの値をアクセストークン（OAuth2 パスワードグラント）に交換し、自動で更新します。
4. GKP の Vertragsdaten で請求番号を確認し、テスト用の発送で dhl_parcel_de_validate_shipments を試します。DHL は本番の予約と同じように確認しますが、何も作成されず、請求もされません。

請求番号（Abrechnungsnummer）: 各発送には 14 文字の billingNumber が必要です。10 桁の顧客番号（EKP）、商品の手続きコード 2 桁、参加番号（Teilnahme、通常は 01）2 桁を続けたものです。DHL Paket（手続き 01）で参加番号が 01 なら、EKP の後に 0101 を付けます。AI に EKP を一度伝えれば、番号は AI が組み立てます。

商品: V01PAK DHL Paket（手続き 01）、V62KP DHL Kleinpaket（62、Warenpost の後継）、V53WPAK DHL Paket International（53）、V54EPAK 欧州の法人向け DHL Europaket（54）、V66WPI Warenpost International（66）。追加できるサービス（指定の隣人、指定の置き場所または配達日、指名本人のみ、隣人への配達なし、年齢の目視確認、受取人の署名、追加保険、代金引換、大型貨物、Premium、GoGreen Plus、DHL Retoure、営業所への転送）は、商品と契約によって異なります。

できること:

• dhl_parcel_de_validate_shipments は住所、商品、サービス、請求番号を確認し、予約時と同じメッセージを返します。何も作成されず、請求もされません。
• dhl_parcel_de_create_shipments は 1 回の呼び出しで最大 30 件の発送を予約し、それぞれの発送番号（追跡番号）とラベルを、リンクで、または includeDocs: include を指定した場合は base64 で返します。予約した発送は当日中に取り消さない限り DHL から請求されるため、AI は予約前に確認を求め、新しいデータは先に検証します。
• dhl_parcel_de_get_labels は最大 30 件の発送番号について、ラベルと税関書類を再ダウンロードします。
• dhl_parcel_de_cancel_shipments はまだ締められていない発送を取り消します。通常はその日の終わりまで可能です。取り消した発送は請求されず、そのラベルは無効になります。
• dhl_parcel_de_close_out は夕方の自動締めを待たずに、一部またはすべての発送の日次締め（Tagesabschluss）を今すぐ行います。締めた発送は取り消せなくなります。
• dhl_parcel_de_get_manifest はある日のマニフェスト（Einlieferungsliste）を返します。締めた発送を請求番号ごとにまとめた PDF と、どの発送がどのシートに載っているかの情報です。

インストール時には 6 つのツールすべてが有効です。発送の予約、取り消し、締めを行うツールも含みます。AI に発送データの確認だけをさせる場合は、コネクターのページで dhl_parcel_de_create_shipments、dhl_parcel_de_cancel_shipments、dhl_parcel_de_close_out をオフにしてください。

レスポンスの読み方: レスポンスには status と、発送ごとに 1 件ずつリクエスト順に並んだ items リストがあります。HTTP 207 は一部の発送が失敗したことを意味し、各項目の sstatus と validationMessages に理由が示されます。住所に関する弱い警告（「Die Adresse konnte nicht geprüft werden」）があっても発送は予約されます。mustEncode: true を指定すると、DHL は照合できない住所を拒否します。

追跡: 予約した発送を追跡するには、発送番号を使って DHL Shipment Tracking コネクターを利用します。

制限: 1 リクエストあたり最大 30 件の発送。呼び出しが速すぎると DHL は 429 を返します。少し待ってから再試行してください。

よくあるエラー: 401 は DHL がログインを拒否したことを意味します。DHL_API_KEY と DHL_API_SECRET が Parcel DE Shipping API を含む承認済みアプリのものか、GKP のユーザー名とパスワードが正しいかを確認してください。個人の GKP パスワードは期限切れになるため、ポータルで更新する必要があります。

ステップ 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 ウィンドウで試します。DHL Parcel DE 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 は使えません。

利用可能なツール

プロンプトの例

• 「予約はせずに、Anna Schmidt, Hauptstraße 5, 79098 Freiburg 宛ての 2 kg の DHL Paket を検証して。」
• 「その発送を予約して、追跡番号とラベルのリンクを教えて。」
• 「発送 00340434161234567890 を取り消して。お客様が注文をキャンセルした。」
• 「今日の日次締めをして、マニフェストをちょうだい。」
• 「この 3 件の発送番号のラベルをもう一度ダウンロードして。」

FAQ

どの 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 に接続
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続