DHL PaketとGemini CLIをMCPで連携

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

DHL Parcel DE Shipping + Gemini

自社の 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 — 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 が DHL Parcel DE Shipping のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

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

FAQ

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

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続