APC Overnight MCP

apc-mcp

Claude、Cursor、Windsurf など、MCP 対応の AI から APC Overnight の荷物を予約し、ラベルを作成して追跡・キャンセルできます。

APC Overnight New Horizon API v3（Integration Guide Edition 2.0.5）を使用して構築されています。

できること

MCP に対応した AI に、次の 6 つのツールを提供します。

ツール	機能
book_shipment	貨物を作成します。22 桁の WayBill を返します。
book_batch_and_label	複数の貨物を一度に予約し、すべてのラベルをまとめた印刷用 PDF を返します。
get_label	配送ラベルをディスクに保存します。PDF、ZPL（サーマルプリンター）、PNG に対応しています。
track_shipment	現在のステータスと追跡履歴全体を取得します。
cancel_shipment	貨物がマニフェストに登録される前にキャンセルします。
list_services	この MCP が対応するすべての APC サービスと ProductCodes を一覧表示します。

内部では、APC アカウントの認証情報を使って https://apc.hypaship.com/api/3.0 と通信します。

プロンプトの例

MCP を AI クライアントにインストールすると、次のように依頼できます。

「倉庫から Alex Taylor 宛てに翌日集荷を予約してください。住所は 45 High Street, Manchester M1 1AA、重量は 15 kg、荷物は 1 個、参照番号は INV-4412 です。」

「この住所への土曜日 12:00 配達を予約してから、ラベルを PDF で出してください。」

「今週の APC 貨物をすべて追跡してください。まだ配達されていないものはどれですか？」

「この 5 件の WayBill のラベルを ZPL で印刷して、サーマルプリンターに送れるようにしてください。」

「注文が 10 件あります。すべて APC の翌日配達で予約して、印刷できる PDF を 1 つ作成してください。」（AI は book_batch_and_label を呼び出し、結合した PDF のパスを返します。）

「WayBill 2018041910099660000599 をキャンセルしてください。顧客が注文をキャンセルしました。」

「明日の正午までに配達される、最も安い APC サービスはどれですか？」（AI は list_services を呼び出して判断します）

AI が住所の解析、サービスの選択、エラーからの復旧を処理します。ビジネス上の判断はお客様が行います。

ビジネス向けワークフローのアイデア

この MCP を任意の AI エージェントに接続すれば、実際の配送業務を自動化できます。

• 毎日の注文処理。 毎朝、AI が EC プラットフォームから新しい注文を読み込み、それぞれに適切なサービスレベルの APC 便を予約して、追跡番号を顧客に送信します。
• サーマルプリンターのワークフロー。 ラベルを ZPL で取得し、PDF への変換を介さずに Zebra、Rollo などのプリンターへ直接送信できます。
• 当日締め切り前の振り分け。 APC の締め切り時刻より前に、翌日午前 10 時配達と通常の翌日配達の対象となる注文を AI が確認し、それぞれに利用可能な最速のサービスを予約します。
• 一括マニフェスト。 数百件の貨物を含むスプレッドシートを AI に渡します。AI がすべてを予約し、デポごとにラベルを 1 つのドキュメントにまとめ、検証に失敗したものを通知します。
• 複数配送業者の比較。 royalmail-mcp と併せてインストールすると、AI が予約時に APC と Royal Mail を比較し、宛先ごとに最も安い、または最も速い方法を選びます。
• カスタマーサービスの振り分け。 顧客から荷物の現在地を尋ねられた際、AI が track_shipment を呼び出し、最新のスキャン情報をわかりやすく要約して返信の下書きを作成します。

互換性

stdio トランスポートに対応する任意の MCP クライアントで動作します。

• Claude Desktop
• Cursor
• Windsurf
• Claude Code
• Zed

ChatGPT、Smithery などのリモート専用 MCP クライアントでは HTTP トランスポートが必要ですが、現時点では含まれていません。必要な場合は、優先して対応できるよう issue を作成してください。

インストール

npm install -g apc-mcp

インストールせずに実行する場合：

npx apc-mcp

設定

APC の認証情報は、APC ポータルへのログインに使用するものと同じです。

[email protected]
APC_PASSWORD=your-apc-account-password
APC_BASE_URL=https://apc.hypaship.com/api/3.0

サーバーの隣にある .env ファイルに設定するか、MCP クライアントの設定で指定してください（以下を参照）。

テスト時は https://apc-training.hypaship.com/api/3.0 を使用してください。APC には、アカウントに課金されたり実際の荷物が発送されたりしないトレーニング用エンドポイントがあります。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "apc": {
      "command": "npx",
      "args": ["-y", "apc-mcp"],
      "env": {
        "APC_USERNAME": "[email protected]",
        "APC_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "apc": {
      "command": "npx",
      "args": ["-y", "apc-mcp"],
      "env": {
        "APC_USERNAME": "[email protected]",
        "APC_PASSWORD": "your-password"
      }
    }
  }
}

対応サービス

よく使われるコードの一部です。全 APC 製品タイプを網羅する 60 種類以上の ProductCode の完全なカタログを確認するには、list_services を実行してください。

キー	APC サービス	ProductCode
next-day	翌日配送パーセル（16:00 まで、標準）	ND16
next-day-1200	翌日配送パーセル（12:00 まで）	ND12
next-day-1000	翌日配送パーセル（10:00 まで）	ND10
next-day-0900	翌日配送パーセル（09:00 まで）	ND09
two-five-day	2～5 日配送パーセル（エコノミー）	TDAY
saturday-1200	土曜配送パーセル（12:00 まで）	NS12
next-day-light	翌日配送軽量便（16:00 まで）	LW16
courier-pack	翌日配送クーリエパック（16:00 まで）	CP16
mail-pack	翌日配送メールパック（16:00 まで）	MP16
liquid	翌日配送液体製品（16:00 まで）	LP16
limited-quantity	翌日配送数量制限品（16:00 まで）	LQ16
non-conveyable	翌日配送コンベヤー不可品（16:00 まで）	NC16
excess	翌日配送大型パーセル（16:00 まで）	XS16
ireland-road	アイルランド向け道路輸送サービス（2～5 日）	ROAD
second-class-mail	第 2 種郵便（Whistl）	POST

さらに 45 種類以上あります。各製品タイプの 09:00／10:00／12:00 便、すべての土曜便、軽量便、クーリエパック、メールパック、液体製品、コンベヤー不可品の 2～5 日配送エコノミー便が含まれます。

わかりやすいキー（next-day）または ProductCode（ND16）のどちらでも指定できます。どちらも使用できます。利用できるサービスは APC との契約によって異なります。通常とは異なるコードについては、デポにご確認ください。

注意事項

• APC がラベルを生成している間、get_label は最大約 15 秒間自動的に再試行するため、通常は book_shipment と get_label の間に待機する必要はありません。
• cancel_shipment が機能するのは、荷物が発送データとして登録される前だけです。APC に集荷された後は、APC ポータルからキャンセルする必要があります。
• ラベル形式：標準プリンターには PDF、Zebra または Rollo のサーマルプリンターには ZPL、画面表示には PNG を使用します。

アカウントごとのサービス利用可否

すべての APC アカウントで、すべての ProductCode が有効になっているわけではありません。時間指定サービス（09:00、10:00）、2～5 日配送エコノミー（TDAY）、特殊製品（液体、数量制限品、コンベヤー不可品）は、デポに有効化を依頼する必要がある追加サービスであることがよくあります。

次の応答が表示された場合は、アカウントまたはルーティングの問題であり、この MCP のバグではありません。

• 228 NO Services available — 指定したサービスは、その集荷先と配達先の郵便番号の組み合わせでは、お客様のアカウントで有効になっていません。
• 119 ProductCode (XXXX) is not one of the possible options — そのコードは、お客様の契約に含まれていません。

追加サービスを有効にするには、APC のデポまたは CMS Team（01922 702587）にご連絡ください。

複数個口の荷物

numberOfPieces > 1 の場合、MCP は totalWeightKg を各荷物に均等に配分し、個数ごとに 1 つの Item エントリーを送信します（APC では、NumberOfPieces とアイテム数を一致させる必要があります）。荷物ごとに異なる重量や寸法を指定する必要がある場合は、完全な items 配列を渡してください。MCP はその内容をそのまま使用します。

セキュリティ

APC のユーザー名とパスワードを使うと、アカウントに完全にアクセスできます。パスワードと同様に取り扱ってください。

• .env を git にコミットしないでください。このリポジトリの .gitignore では、すでに除外されています。
• 認証情報をチャットメッセージや共有ドキュメントに貼り付けないでください。
• 認証情報が漏えいした場合は、APC ポータルで変更してください。

プライバシーとデータの取り扱い

この MCP はすべてお使いのマシン上で動作します。顧客データ、認証情報、API トラフィックが、作者の所有または運営するサーバーを経由することはありません。

データの流れは次のとおりです。

• AI アシスタントに提供した配送情報は、お使いのアカウントで AI プロバイダー（たとえば Claude を使用している場合は Anthropic）に送信されます。
• 予約リクエストは、APC の認証情報を使って APC Overnight に送信されます。
• ラベルはローカルディスクの ~/Downloads/parcel-toolkit/ に保存されます（PARCEL_TOOLKIT_LABELS_DIR 環境変数で変更できます）。

英国の事業でこれを使用する場合、UK GDPR におけるデータ管理者はお客様です。実際の対応として、次をおすすめします。

1. Anthropic とのデータ処理契約を締結できるよう、一般消費者向けの Claude.ai ではなく、Claude Team、Claude Enterprise、または Claude API を直接使用してください。一般消費者向けプランでは、最低限、プライバシー設定で「Help improve Claude」をオフにしてください。
2. 決済プロバイダーやメールサービスと同様に、プライバシーポリシーで Anthropic と APC Overnight をサブプロセッサとして記載してください。
3. 追加の法的審査を受けずに、このツールを特別カテゴリーのデータ（健康情報、生体情報、子どものデータ）に使用することは避けてください。
4. このソフトウェアは MIT ライセンスのもと、「現状のまま」提供されます。作者はデータ処理者ではなく、お客様のコンプライアンス義務について一切責任を負いません。これらの義務はデータ管理者であるお客様が負います。

貢献

課題やプルリクエストは github.com/catrinmdonnelly/apc-mcp で歓迎しています。APC が API を変更した場合や、お使いのアカウント種別で特殊なケースが発生した場合は、送信したリクエスト本文と受け取ったレスポンスを添えて課題を作成してください（事前に認証情報を削除してください）。

関連 MCP

Royal Mail Click & Drop については、royalmail-mcp をご覧ください。

免責事項

このプロジェクトは APC Overnight Ltd と提携、承認、または後援を受けていません。「APC Overnight」と「New Horizon」は、それぞれの所有者の商標です。ご自身の責任でご使用ください。

ライセンス

MIT。LICENSE をご覧ください。