ヤマト運輸「送り状発行システム B2クラウド」を TypeScript API + MCP サーバーから操作。
宛先と品名だけで、送り状 PDF と 12桁追跡番号が返ってくる。
curl -X POST https://your-app.vercel.app/api/b2/print \
-H "Content-Type: application/json" \
-d '{
"shipments": [{
"service_type": "0",
"consignee_name": "山田太郎",
"consignee_telephone_display": "03-1234-5678",
"consignee_zip_code": "100-0014",
"consignee_address1": "東京都",
"consignee_address2": "千代田区",
"consignee_address3": "永田町1-7-1",
"item_name1": "化粧品"
}]
}'
# → { "tracking_number": "389717757822", "pdf_download_path": "..." }ブラウザ UI と完全互換のプロトコルを Node.js に移植。実機で踏み抜いた 12 個の落とし穴をすべて自動回避。74 項目の E2E テストで品質を保証。
POST 1回で check→save→print→PDF→tracking を自動実行。12.5秒で追跡番号付き PDF が返る。
auto_shortest: true を付けるだけで配達日と最短時間帯を自動算出。LLM が配達日数を推測する必要なし。
クール不可地域（利島/式根島/御蔵島/青ヶ島/小笠原）を自動検知。service_type × is_cool の不正組み合わせも即エラー。
Claude / ChatGPT / Cursor から「送り状を出して」「最短で届けて」で即利用。Swagger UI でインタラクティブドキュメント付き。
環境変数 3 つ入れるだけで即稼働。Serverless Functions で運用コストほぼゼロ。
HMAC-SHA256 署名 + 60秒有効期限。ステートレスでセキュアなダウンロードリンク。
Cookie 失効を検知して自動リトライ。CSRF ヘッダも自動付与。セッション管理不要。
発払い・着払い・コレクト・コンパクト・ネコポス・DM・タイムまで全 11 種類をカバー。
実機検証に基づく実測値。ヤマト B2クラウドへの認証から PDF 取得まですべて含んだ所要時間。
Vercel にデプロイして、環境変数を設定するだけ。
「Vercel にデプロイ」ボタンから。必須の環境変数は B2_CUSTOMER_CODE / B2_CUSTOMER_PASSWORD / MCP_API_KEY の 3 つ。
Vercel の環境変数に B2_DEFAULT_SHIPPER_NAME / TEL / ZIP / ADDR1〜3 を設定すると、毎回の送り状作成で省略できます。
claude.ai → Settings → MCP Connectors に URL を登録。または curl で直接 API を叩く。詳しくはドキュメント →
堀が公開している MCP サーバー群。すべて Claude.ai / Cursor / ChatGPT 等から利用可能。
| サーバー | ツール | 説明 |
|---|---|---|
| b2cloud-api ← 今ここ | 14 | ヤマト B2クラウド送り状発行 API/MCP |
| cloudflare-mcp | 69 | Cloudflare 統合（Tunnel/DNS/Workers/Pages/R2/KV/SSL/Access） |
| hubspot-ma-mcp | 128 | HubSpot MA（CRM/Marketing/Knowledge Store） |
| msgraph-mcp-server | 48 | Microsoft Graph API（Exchange/Teams/OneDrive/SharePoint） |
| playwright-devtools-mcp | 57 | Playwright + Chrome DevTools（ブラウザ自動化） |
| proxmox-mcp-server | 35 | Proxmox VE 仮想化基盤操作 |
| printer-mcp-server | — | CUPS ネットワークプリンタ制御（Kyocera TASKalfa） |
| yamato-printer-mcp-server | — | ヤマト送り状サーマルプリンタ（ラズパイ + WS-420B） |
| ssh-mcp-server | 10 | SSH クライアント（セッション管理/非同期コマンド） |
| mac-remote-mcp | 34 | macOS リモート制御（Shell/GUI/ファイル/アプリ） |
| gemini-image-mcp | 4 | Gemini/Imagen 画像生成 |
| runpod-mcp | 36 | RunPod GPU FaaS（Pods/Endpoints/Jobs） |
| firecrawl-mcp | — | Firecrawl セルフホスト Web スクレイピング |
| ad-ops-mcp | 62 | 広告運用自動化（Google Ads/Meta/GBP/X） |