MCP 経由で EasyPost を Gemini に接続する方法

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

EasyPost + Gemini

AI に EasyPost で発送させます。住所の検証、契約キャリアのリアルタイム運賃の比較、配送ラベルの購入、形式変換、保険付与、返金、荷物の追跡、税関申告の準備、スキャンフォームの作成ができます。テストキーは無料です。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

EASYPOST_API_KEY

ステップ 1 — 認証情報を取得

1. https://app.easypost.com/signup で EasyPost の無料アカウントを作成します。API キーが表示される前に、EasyPost からウォレットと発送元住所の設定を求められます。新しいアカウントでは、先に会社情報を入力する簡単なセキュリティチェックが必要になる場合があります。EasyPost がそれを承認するとキーが表示されます。
2. API キーのページ https://app.easypost.com/account/settings?tab=api-keys（Account settings → API keys）を開きます。Test キー（無料、ラベルは無効）または Production キー（実際のラベルを購入）をコピーします。
3. それを EASYPOST_API_KEY に貼り付け、コネクターをインストールします。
4. easypost_list_addresses を実行してキーを確認します。新しいアカウントでは一覧が空の場合があります。

テストか本番か: キーで決まります。テストキーではラベルは無料で無効になり、追跡には EasyPost のテストコード EZ1000000001 から EZ7000000007 だけが使えます。各コードが 1 つのステータス（発送前、配達済み、差出人へ返送など）に対応します。接続済みのキャリアアカウントの一覧表示（easypost_list_carrier_accounts）には本番キーが必要です。

購入には費用がかかるため、先に確認します: 本番キーでは、easypost_buy_shipment と easypost_insure_shipment が EasyPost のウォレットに即時に課金します。購入前に AI がキャリア、サービス、料金、両方の住所を示し、あなたの承認を待ちます。購入後に付ける保険は保険金額の 1%、最低 1 USD です。easypost_refund_shipment は未使用のラベルを無効にし、無効にしたラベルはその後使えません。返金には数日から数週間かかります（USPS のラベルは 30 日以内、UPS と FedEx は 90 日以内が対象です）。

発送の流れ: easypost_create_shipment に宛先、発送元住所、荷物を渡すと、契約キャリアのリアルタイム運賃が料金と配達日数つきで返ります。AI と一緒に運賃を選ぶと、AI が easypost_buy_shipment でラベルを購入し、ラベルのリンク（PNG、easypost_convert_label で PDF や ZPL も取得可能）、追跡番号、公開の追跡ページを受け取ります。荷物は easypost_get_tracker で追跡でき、ほかで購入したラベルも含め任意の追跡番号の追跡を easypost_create_tracker で開始できます。AI は住所の検証や、集荷時にキャリアが 1 枚だけスキャンすればよいスキャンフォームの作成もできます。

単位と国際発送: 重量はオンス、寸法はインチです（1 kg は 35.27 oz、1 cm は 0.394 in）。金額は通貨の指定がなければ USD です。国際発送では、AI がまず税関品目と税関申告書を作成し、それを発送に添付します。

よくあるエラー: 401 UNAUTHORIZED または 403 APIKEY.INACTIVE: キーがない、間違っている、または無効化されています。403 MODE.UNAUTHORIZED: その呼び出しには本番キーが必要です。402 PAYMENT_REQUIRED: ウォレットに残高がありません。ADDRESS.VERIFY.FAILURE、SHIPMENT.POSTAGE.FAILURE、SHIPMENT.CUSTOMS_INFO.REQUIRED などの 422 エラーは、住所、購入、または不足している税関データの問題を示します。429: リクエストが多すぎます。少し待ってから再試行してください。

このコネクターは、集荷、注文、返品、Webhook、ユーザーと API キー、レポート、キャリアアカウントの接続は扱いません。

ステップ 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 が EasyPost のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「重さ 3 lb、12 x 10 x 6 インチの荷物を当社の倉庫からこのシカゴの住所へ送る場合の運賃を比較して、最安と最速の選択肢を見せてください。」
• 「追跡番号 1Z999AA10123456784 の荷物は今どこにあり、いつ届く予定ですか。」
• 「この顧客の住所を確認して、発送前に修正が必要な点があれば教えてください。」
• 「その発送のラベルを USPS の最安運賃で購入してください。ただし購入前に、キャリア、サービス、料金、両方の住所を見せてください。」

FAQ

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

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続