Shipcloud MCP by usefulapi

usefulapi による Shipcloud MCP

接続

• Claude（claude.ai、Desktop）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://shipcloud.usefulapi.io/mcp を貼り付けます。
• Claude Code: claude mcp add --transport http shipcloud https://shipcloud.usefulapi.io/mcp を実行し、続いて /mcp を実行してログインします。
• VS Code: VS Code に追加。
• Cursor およびその他のクライアント： リモート MCP サーバーとして URL を追加します：

{
  "mcpServers": {
    "shipcloud": {
      "url": "https://shipcloud.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで Shipcloud の認証情報を求めます。

手順ごとのセットアップ、認証情報の確認方法、FAQ：https://usefulapi.io/shipcloud/

ツール

ツール	種類	機能
shipcloud_get_account	読み取り	アカウントを取得
shipcloud_list_carriers	読み取り	配送業者を一覧表示
shipcloud_get_default_address	読み取り	デフォルトの住所を取得
shipcloud_list_shipments	読み取り	発送を一覧表示
shipcloud_get_shipment	読み取り	発送を取得
shipcloud_get_shipment_quote	読み取り	発送料金の見積もりを取得
shipcloud_create_prepared_shipment	書き込み	発送を準備（ラベルなし）
shipcloud_create_shipment_with_label	書き込み	配送ラベルを購入（料金が発生します）
shipcloud_delete_shipment	書き込み	発送を削除／ラベルをキャンセル
shipcloud_list_trackers	読み取り	追跡情報を一覧表示
shipcloud_get_tracker	読み取り	追跡情報を取得
shipcloud_create_tracker	書き込み	追跡番号で発送を追跡
shipcloud_list_pickup_requests	読み取り	集荷依頼を一覧表示
shipcloud_get_pickup_request	読み取り	集荷依頼を取得
shipcloud_create_pickup_request	書き込み	配送業者に集荷を依頼
shipcloud_find_dropoff_locations	読み取り	集荷場所と持ち込み場所を検索
shipcloud_list_addresses	読み取り	保存済みの住所を一覧表示
shipcloud_get_address	読み取り	保存済みの住所を取得
shipcloud_create_address	書き込み	住所を保存
shipcloud_list_orders	読み取り	注文を一覧表示
shipcloud_get_order	読み取り	注文を取得
shipcloud_list_webhooks	読み取り	Webhook を一覧表示
shipcloud_usage_status	メタ	使用状況（無料プランの利用回数）
shipcloud_request_feature	メタ	不足している機能をリクエスト
shipcloud_upgrade	メタ	Pro または Pro+ にアップグレード
shipcloud_cancel_subscription	メタ	Pro サブスクリプションをキャンセル

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアントは実行前に確認する必要があります。meta ツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。

料金

プラン	料金	上限
Free（Shipcloud の顧客ごと）	$0	月 50 回のツール呼び出し
Pro（Shipcloud の顧客ごと）	$9/月 または $90/年（2 か月無料）	無制限*

*このサーバーでの Pro の公正利用上限は、月 10,000 回のツール呼び出しです。それ以上必要な場合は、[email protected] までご連絡ください。

Pro はこのサーバーのみが対象です。shipcloud_upgrade で登録してください（Stripe Checkout のリンクが返されます）。shipcloud_cancel_subscription でいつでもキャンセルできます。キャンセル後も有料期間の終了までは Pro を利用できます。現在の期間分の返金はありません。また、期間終了前に shipcloud_upgrade を実行するとキャンセルが取り消されます。あるいは [email protected] までご連絡ください。

ライセンス

MIT

アカウントアクセスとデータ

お客様ご自身が管理するキーのみを、お客様の承認および処理指示に基づいて接続してください。キーはアカウントのメールアドレス → API Key から確認できます。サンドボックスキーではテスト用ラベルが発行され、ライブキーでは実際の配送業者料金が発生する場合があります。ベンダーのプラン、配送業者の利用資格および料金はそれぞれ別のものです。これはお客様が承認した独立した接続であり、パートナーの承認を得ているとは主張していません。

キーは暗号化されます。要求された差出人／宛先住所、注文および追跡情報は、接続先の AI クライアントおよび LLM プロバイダーに届きます。そこで処理する権限のあるデータのみを接続してください。アクセスを停止するには Shipcloud でキーを無効にし、この接続を停止するには UsefulAPI を切断してください。課金は顧客番号に基づき、通常、サンドボックス／ライブキーおよびキーのローテーションをまたいで適用されます。

ラベルの購入、発送の削除／ラベルのキャンセル、および配送業者への集荷依頼には、明示的な確認が必要です。集荷には料金が発生する場合があり、これらのツールからキャンセルすることはできません。準備済みの発送にはラベルもラベル料金もありません。任意で通知メールを指定すると、Shipcloud からそのアドレスに追跡メールが送信されます。不確実な結果についてはメモと結果で説明します。操作が自動的に再実行されることはありません。

参照情報の照会と同一インスタンス内のガードにより、ラベルの重複購入を減らしますが、Worker インスタンス間での処理はアトミックではありません。参照ごとに購入処理を直列化してください。配送業者の処理が完了するまでに時間がかかると、タイムアウトする場合があります。購入を繰り返す前に Shipcloud を確認してください。ラベル購入を報告するには、有効な作成 ID と HTTPS のラベル URL が必要です。削除には、仕様に記載された204の確認応答が必要です。

全22個のツールを、現在のベンダーのドキュメントとローカルモックを使用して検証しました。実際の顧客の配送データ、ラベル、集荷または料金はテストしていません。