ShipSaving

ShipSaving MCP Server

中文文档

ShipSaving の物流 REST API をラップする MCP（Model Context Protocol）サーバーです。Claude などの AI アシスタントが、自然言語で配送業務を実行できるようにします。

機能

• 配送管理 — 複数の配送業者の料金比較、配送の作成、支払いとラベルの生成、ラベルの無効化、荷物の追跡
• 注文管理 — ストア注文の同期、検索、一括ラベル印刷、発送済みへの変更、キャンセル
• 住所録 — 住所の照会、作成、検証
• 荷物テンプレート — 荷物の寸法を保存して再利用
• 配送業者 — 接続済み配送業者アカウントと利用可能なサービスレベルの一覧表示
• ストア連携 — 接続済みの E コマースストア（Shopify など）の一覧表示
• 分析 — 合計節約額、送料分析
• 請求 — ウォレット残高、取引履歴

クイックスタート

前提条件

• Node.js 18+
• ShipSaving App Key（ShipSaving → Settings → API で取得）

Claude Code CLI でインストール（推奨）

claude mcp add shipsaving \
  -e SHIPSAVING_APP_KEY=sk_your_app_key \
  -- npx -y shipsaving-mcp

Claude Desktop でインストール

設定ファイルを編集します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shipsaving": {
      "command": "npx",
      "args": ["-y", "shipsaving-mcp"],
      "env": {
        "SHIPSAVING_APP_KEY": "sk_your_app_key"
      }
    }
  }
}

保存後、Claude Desktop を再起動します。

インストールの確認

claude mcp list
# shipsaving should show status: Connected

利用可能なツール

配送管理

ツール	説明
get_shipping_rates	複数の配送業者の料金を比較し、最安値と最速の料金を表示
create_draft_shipment	配送の下書きを作成（支払いはまだ行いません）
pay_shipment	配送料金を支払い、ラベルを生成
void_label	未使用のラベルを無効化／返金
search_shipments	さまざまな条件で配送を検索
get_shipment_detail	配送の詳細情報を取得
track_shipment	追跡番号で荷物を追跡
get_insurance_rates	配送保険の料金を照会

注文管理

ツール	説明
search_orders	ステータス、ストア、日付、キーワードで注文を検索
get_order_detail	注文の詳細を取得
create_order	注文を手動で作成
buy_label_from_order	既存の注文のラベルを購入
mark_order_shipped	注文を発送済みにする
cancel_order	注文をキャンセル
sync_store_orders	ストア注文の同期を開始
get_order_tags	すべての注文タグを一覧表示

住所録

ツール	説明
list_addresses	住所録のエントリーを照会
create_address	新しい住所を追加
update_address	既存の住所を更新
validate_address	住所が配達可能か検証

荷物テンプレート

ツール	説明
list_packages	保存済み荷物テンプレートを一覧表示
list_predefined_packages	配送業者が提供する荷物タイプを一覧表示
create_package	再利用可能な荷物テンプレートを作成

配送業者とストア

ツール	説明
list_carriers	接続済み配送業者アカウントを一覧表示
get_service_levels	配送業者ごとに利用可能なサービスレベルを照会
list_stores	接続済みの E コマースストアを一覧表示

分析と請求

ツール	説明
get_total_savings	ShipSaving による合計節約額を確認
get_shipping_analysis	期間ごとの配送データを分析
get_wallet_info	ウォレット残高を照会
get_transaction_history	取引履歴を照会

使用例

配送料金を比較：

Compare rates from ZIP 90001 to 10001 for a 10x8x6 inch, 2 lb package

荷物を発送：

Ship from John Smith, 123 Main St, Los Angeles, CA 90001
to Jane Doe, 456 Park Ave, New York, NY 10001
Package: 10x8x6 inches, 2 lbs, choose cheapest option

ラベルを一括印刷：

Sync my Shopify orders, then print labels for all pending orders
using 6x6x6 inch boxes, 1 lb each, cheapest carrier, no insurance

荷物を追跡：

Track package 1Z999AA10123456784

環境変数

変数	必須	デフォルト	説明
SHIPSAVING_APP_KEY	はい	—	ShipSaving App Key（sk_ プレフィックス）
SHIPSAVING_API_BASE_URL	いいえ	https://app-gateway.shipsaving.com	API のベース URL
SHIPSAVING_TIMEOUT_MS	いいえ	60000	リクエストのタイムアウト（ミリ秒）
SHIPSAVING_LOG_FILE	いいえ	—	ログファイルのパス（デフォルトではログは stderr に出力されます）

開発

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Debug with MCP Inspector
SHIPSAVING_API_BASE_URL=https://app-gateway.shipsaving.com \
SHIPSAVING_APP_KEY=sk_your_app_key \
npx @modelcontextprotocol/inspector node dist/index.js

トラブルシューティング

「command not found」 — Node.js 18 以降をインストールしてください：nodejs.org

「Failed to connect」 — エラー出力を確認するため、サーバーを手動で実行してみてください：

SHIPSAVING_APP_KEY=sk_your_app_key npx -y shipsaving-mcp

入力待ちで停止する場合、サーバーは正常に起動しています。すぐにエラーが発生する場合は、問題が表示されます。

npx キャッシュをクリアするには：

rm -rf ~/.npm/_npx

ライセンス

MIT