Easyship

Easyship MCP — 配送と物流を自動化する AI エージェントプラグイン

すべての AI ツールを Easyship のグローバルな配送プラットフォームに接続し、自然言語で配送業務全体を管理できます。

このプラグインを使うと、エージェントから配送料金の確認、配送の作成、ラベルの購入、荷物の追跡、集荷の予約、住所の検証、請求、分析を利用できます。詳しくは、API ドキュメントをご覧ください。

UPS、FedEx、DHL Express、USPS、Canada Post、Australia Post、Royal Mail など、200 以上の国と地域で利用できる 550 以上の配送業者サービスに、Cursor、Claude、Gemini、Codex などから直接アクセスできます。

インストール

• Cursor の場合：Settings -> Marketplace で「easyship」を検索するか、Settings -> Tools & MCP から手動で追加します。"

• Claude Code の場合：チャットで次の 2 つのコマンドを実行します。

  /plugin marketplace add easyship/easyship-mcp-plugin
  /plugin install easyship@easyship-mcp-plugin
  

• Gemini CLI の場合：ターミナルで次のコマンドを実行します。

  gemini extensions install https://github.com/easyship/easyship-mcp-plugin
  

• OpenAI Codex の場合：Codex CLI で、 ~/.codex/config.toml に次の内容を追加します。

  [mcp_servers.easyship]
  url = "https://mcp.easyship.com/mcp"
  http_headers = { "Authorization" = "Bearer YOUR_TOKEN" }
  

• VS Code の場合：コマンドパレット（CMD+SHIFT+P）を開き、Chat: Install Plugin From Source を実行します。 次の URL を貼り付けます。

  https://github.com/easyship/easyship-mcp-plugin
  

利用できる機能

• 料金の比較：割引料金、お届け予定日、税金および関税の見積もりを含む、550 以上の配送業者の選択肢を比較できます
• 配送管理：ラベルの購入や書類の取得を含め、配送を最初から最後まで作成、更新、追跡、キャンセル、管理できます
• 集荷の予約：利用可能な時間枠を確認し、配送業者の集荷を予約して、既存の集荷を管理できます
• 住所の検証：米国内および海外の配送先住所を検証できます
• 請求：取引および請求書類を確認できます
• 分析：配送量の推移、主な配送先、配送業者の利用状況、ステータスの内訳、販売チャネルの実績を確認できます

その他のインストール方法

プラットフォームがプラグインに対応していない場合は、MCP サーバーを直接インストールできます。

Easyship Dashboard → Connect → API から API トークンを取得します。

ヒント： .env.example を .env にコピーし、API トークンを追加してください。一部のローカル環境では、このファイルが自動的に読み込まれます。

⚠️ セキュリティに関する注意：チャットウィンドウで API トークンを共有しないでください。誤ってプロンプトに貼り付けた場合は、Easyship Dashboard ですぐに API キーを無効化し、新しいキーに切り替えてください。

注：MCP アクション用の独立したテスト環境はありません。ラベルの生成など、クレジットを消費するアクションには実際の料金が発生します。初回の実行では、スコープを制限したテスト用 API トークンの使用をおすすめします。

各クライアントでは、次の 2 つの接続方法を利用できます。

方法	仕組み	Python が必要ですか？
リモート	Streamable HTTP 経由で mcp.easyship.com に接続します	いいえ
ローカル	uvx 経由で、お使いのマシン上の easyship-mcp パッケージを実行します	はい

---

Claude Desktop

設定を編集する前にClaude Desktop を終了し、保存後に再起動してください。

OS	設定ファイル
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

トップレベルの mcpServers オブジェクトにマージします（存在しない場合は作成します）。

リモート：

{
  "mcpServers": {
    "easyship": {
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

ローカル（uvx）：

{
  "mcpServers": {
    "easyship": {
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

マシンに uv をインストールする必要があります。

---

Claude Code

リモート：

claude mcp add --transport http easyship \
  https://mcp.easyship.com/mcp \
  --header 'Authorization: Bearer YOUR_TOKEN'

ローカル（uvx）：

export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"
claude mcp add easyship -- uvx easyship-mcp

---

Cursor

プロジェクトの .cursor/mcp.json（または全体設定の場合は ~/.cursor/mcp.json）に追加します。

リモート：

{
  "mcpServers": {
    "easyship": {
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

ローカル（uvx）：

{
  "mcpServers": {
    "easyship": {
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

---

VS Code

プロジェクトの .vscode/mcp.json に追加します：

リモート：

{
  "servers": {
    "easyship": {
      "type": "http",
      "url": "https://mcp.easyship.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

ローカル（uvx）：

{
  "servers": {
    "easyship": {
      "type": "stdio",
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

---

Gemini CLI

gemini mcp add --transport http easyship \
  https://mcp.easyship.com/mcp \
  --header 'Authorization: Bearer YOUR_TOKEN'

---

Codex CLI

~/.codex/config.toml に追加します：

[mcp_servers.easyship]
url = "https://mcp.easyship.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_TOKEN" }

---

その他のクライアント

Streamable HTTP に対応する MCP クライアントの場合は、次の URL を指定します：

URL:    https://mcp.easyship.com/mcp
Header: Authorization: Bearer YOUR_TOKEN

stdio ベースのクライアントでは、環境変数に EASYSHIP_API_ACCESS_TOKEN を設定して uvx easyship-mcp を実行します。

使用例

配送料金を取得する：

「香港からニューヨークへ、1.5kg の荷物（30×20×15 cm）を送る場合の配送方法を教えてください。」

配送状況を追跡する：

「配送番号 ESSG10006001 を追跡してください」

集荷を予約する：

「配送番号 ESSG10006001 の集荷を、最短で利用可能な日に予約してください」

住所を検証する：

「次の住所を検証してください：215 Clayton St, San Francisco, CA 94117」

配送データを分析する：

「今四半期の主な配送先を教えてください」

「最もよく利用している配送業者はどこですか？」

サポートが必要ですか？

• Easyship API ドキュメント
• Easyship MCP ドキュメント
• Easyship サポート
• GitHub の課題

プライバシーポリシー

Easyship MCP Connector はステートレスなプロキシとして動作し、独自のサーバーにユーザーデータ、認証情報、配送情報を保存しません。このコネクターを通じて処理されるすべてのデータには、Easyship のデータ取り扱い方針が適用されます。

このコネクターによるデータの取り扱い：

• データ収集： 個人データや配送内容は収集されません。運用上のリクエストメタデータ（エンドポイント、ステータスコード、セッション ID）は、監視目的でログに記録されます。
• 使用と保存： アクセストークンは MCP クライアント（例：Claude）が保持し、このサーバーによってディスクに書き込まれたり、ログに記録されたりすることはありません。
• 第三者との共有： お客様のデータは、リクエストを処理する目的に限り Easyship の API に送信され、Easyship のシステムのみによって管理されます。
• 保持： このコネクターは個人データや配送内容を保持しません。運用上のリクエストメタデータのログは、監視目的で保持されます。配送情報または個人データの保持については、Easyship のシステムのみによって管理されます。
• お問い合わせ： データの取り扱いについてご質問がある場合は、Easyship プライバシーポリシーをご覧いただくか、[email protected] までお問い合わせください。

API バージョン

このサーバーは Easyship API v2024-09 を対象としています。

ライセンス

MIT