概要
荷主向けのUPS API:追跡番号や参照番号で荷物を追跡し、米国の住所を検証し、料金や輸送時間を比較し、ドロップオフおよびアクセスポイントの場所を見つけ、着陸コストを見積もり、ラベルを回復し、ピックアップを見積もります。出荷の作成、無効化、ピックアップは含まれますが、オフになっています。UPS開発者ポータルからのOAuthクライアントIDとシークレット。
ガイド付きセットアップ
UPS を Gemini に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで UPS を接続して、MCP URL を Gemini に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
UPS のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセス。 サインインして、Connectors → UPSをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
UPS + Gemini
荷主向けのUPS API:追跡番号や参照番号で荷物を追跡し、米国の住所を検証し、料金や輸送時間を比較し、ドロップオフおよびアクセスポイントの場所を見つけ、着陸コストを見積もり、ラベルを回復し、ピックアップを見積もります。出荷の作成、無効化、ピックアップは含まれますが、オフになっています。UPS開発者ポータルからのOAuthクライアントIDとシークレット。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
ステップ1 — 認証情報を取得
設定には約10分かかります。
- https://developer.ups.com に、荷主アカウントを所有するups.comプロファイルでサインインし、アプリケーションを作成するページを開きます(必要に応じて最初に登録してください)。
- UPS技術を自分のビジネスに統合したいと伝え、アプリが請求するUPSアカウント番号を選択し、アプリの名前を付けます。
- コネクタが使用する製品を追加します:追跡, 住所検証, 料金, 輸送時間, ロケーター, およびオフになっているツールのための配送, ピックアップ, 着陸コスト見積もり。欠落している製品は、そのツールに対して401または403の応答を返します。
- クライアントIDを
UPS_CLIENT_IDに、クライアントシークレットをUPS_CLIENT_SECRETにコピーします。 - 6文字のUPSアカウント番号(荷主番号)を
UPS_ACCOUNT_NUMBERに入力します。
コネクタは、https://onlinetools.ups.com/security/v1/oauth/token(クライアント資格情報、HTTP Basic)でクライアントIDとシークレットを交換し、短命のベアラートークンを取得し、自動的に更新します。これらは本番用の資格情報です;UPSテストシステム(wwwcie.ups.com)は使用されません。
開始する場所:ups_track_packageを追跡番号で。料金を知りたい場合は、ups_shop_ratesが2つの住所間のすべてのサービスを比較し、ups_get_rateが1つのサービスの料金を提供します;ups_get_time_in_transitは料金なしで配達日を提供します。
追跡:ups_track_package(任意の追跡番号)、ups_track_by_reference(自分の参照、例:注文番号、アカウント内)およびups_track_shipment_packages(複数パッケージの出荷のすべてのパッケージ)。日付はYYYYMMDD、時間はスキャンのローカル時間でHHMMSS;gmtDate、gmtTimeおよびgmtOffsetはUTCの同じ瞬間を示します。currentStatus.descriptionから状態を読み取り、activityからスキャンを取得します(新しいものから順に)。
住所と場所:ups_validate_addressは、米国およびプエルトリコのストリートアドレスのみをカバーします。ups_find_locationsは、UPSがサービスを提供する任意の国の住所近くのドロップオフ場所およびUPSアクセスポイントの場所を見つけます。
料金:ups_shop_ratesおよびups_get_rateは、荷主番号としてアカウント番号を送信します。公開料金がデフォルトで返されます;NegotiatedRatesIndicatorを使用してrating_optionsを渡すと、契約料金がNegotiatedRateChargesに表示されます。金額は隣に記載された通貨の文字列です。重量はLBSまたはKGS、寸法はINまたはCM:出発国の単位を使用します。ups_quote_landed_costは、国境を越える出荷の関税や税金を見積もり、アイテムごとにHSコードを使用するのが最適です。
ラベルと出荷:ups_recover_labelは、既存の出荷のラベルを再取得し、費用はかかりません。ups_create_shipmentはUPSがアカウントに請求する出荷を作成し、ups_void_shipmentはピックアップ前に出荷をキャンセルします;両方ともオフにインストールされています。アシスタントが実際の出荷を作成する必要がある場合のみ、コネクタでオンにしてください。UPSのフィールド名は呼び出しによって異なります:料金ツールはパッケージングをPackagingTypeと呼び、出荷ツールはPackagingと呼びます。
ピックアップ:ups_get_pickup_rateはオンコールピックアップの見積もりを行い、ups_get_pending_pickupsは予約済みのピックアップをリストします。ups_create_pickupはドライバーを予約し、料金がかかり、ups_cancel_pickupはPRNでキャンセルします;両方ともオフにインストールされています。
エラー:UPSはresponse.errorsで応答し、codeとmessageのリストを返します。401は資格情報またはトークンが拒否されたことを意味し、403はアプリがその製品にアクセスできないか、UPSがアカウントをブロックしたことを意味します。404はUPSがその番号のデータをまだ持っていないことを示し(ラベルは最初のスキャン後または作成後数時間で表示されます)、429はアプリのクォータが使い果たされたことを意味します。
制限:UPSはアプリおよび製品ごとにクォータを設定し、その数値をAPIファイルに公開していません;429は待機して後で再試行することを意味します。1回の呼び出しで1つの番号を追跡するのが文書化された使用法です:長いリストを迅速にループしないでください。
ステップ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" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します(またはシェルでgemini mcp list)。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう — Gemini CLI が
UPSのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 機能 |
|---|---|
ups_track_package | 追跡番号で1つのUPSパッケージを追跡します:コードと説明付きの現在の状態、すべてのスキャン(YYYYMMDD形式の日付、HHMMSS形式のローカル時間… |
ups_track_by_reference | あなたのUPSアカウントの出荷を、出荷に付けた参照番号(注文番号、請求書番号)で見つけて追跡します。同じ… |
ups_track_shipment_packages | 複数パッケージのUPS出荷のすべてのパッケージを、いずれかの追跡番号から追跡します:パッケージごとに追跡番号、現在の状態、最後… |
ups_validate_address | 米国またはプエルトリコのストリートアドレスをUPSデータと照合します。ValidAddressIndicator、AmbiguousAddressIndicator…を返します。 |
ups_get_rate | 出荷のための1つのUPSサービスの料金を見積もります。RateResponse.RatedShipmentを返し、サービスコード、請求重量、輸送、サービス…を含みます。 |
ups_shop_rates | 2つの住所間で利用可能なすべてのUPSサービスを比較します。サービスごとに1つのRatedShipmentを返し、そのコード、請求…を含みます。 |
ups_get_time_in_transit | 2つの場所間で利用可能なUPSサービスをemsResponse.servicesの下にリストします:serviceLevelとserviceLevelDescription… |
ups_find_locations | 住所近くのUPSドロップオフ場所を見つけます:UPSアクセスポイントの場所、UPSストア、顧客センター、ドロップボックス。返される… |
ups_quote_landed_cost | 国際出荷のための関税、税金、仲介手数料を出荷前に見積もります(UPS着陸コスト見積もり)。商品ごとに…を返します。 |
ups_recover_label | 追跡番号で既存の出荷のラベルを再取得します。LabelRecoveryResponse.LabelResultsを返し、ラベルを…として返します。 |
ups_get_pickup_rate | 住所でのオンコールUPSピックアップの料金を見積もりますが、予約はしません。PickupRateResponse.RateResultを返し、料金タイプ…を含みます。 |
ups_get_pending_pickups | まだ実施されていないあなたのUPSアカウントで予約されたピックアップをリストします。PickupPendingStatusResponse.PendingStatusを返し、ピックアップ…を含みます。 |
ups_create_shipment | UPS出荷とそのラベルを作成します。この呼び出しが成功すると、UPSは出荷をあなたのアカウントに請求しますので、このツールは… |
ups_void_shipment | 作成されたがまだピックアップされていないUPS出荷、またはその単一のパッケージを無効にします。元に戻すことはできません:ラベルは…になります。 |
ups_create_pickup | オンコールUPSピックアップを予約します:指定された日にドライバーが住所に来ます。UPSはあなたのアカウントにピックアップ料金を請求しますので、このツールは… |
ups_cancel_pickup | ピックアップリクエスト番号(PRN)で予約されたUPSピックアップをキャンセルします。元に戻すことはできません;新しいピックアップを予約する必要があります。返される… |
例のプロンプト
- "UPSパッケージ1Z999AA10123456784はどこですか?"
- "シカゴ60601からオースティン78701までの5ポンドの箱のUPS料金を比較してください。"
- "1600 Amphitheatre Pkwy, Mountain View, CA 94043は有効な住所ですか?"
- "今日出荷された場合、アトランタからUPSグラウンドパッケージはシアトルにいつ到着しますか?"
- "10115ベルリン近くのUPSアクセスポイントの場所を見つけてください。"
よくある質問
UPSの認証情報はどこから来ますか? UPS開発者ポータル(developer.ups.com)で、荷主アカウントを所有するups.comプロファイルで作成されたアプリから取得します。追跡、住所検証、料金、輸送時間、ロケーターの製品を追加し、次にクライアントIDとクライアントシークレットをコピーします。UPS_ACCOUNT_NUMBERはあなたの6文字の荷主番号です。
何をカバーし、何をカバーしないのですか? 番号または参照による追跡、米国住所の検証(米国およびプエルトリコのみ)、料金および輸送時間、ドロップオフおよびアクセスポイントの場所、着陸コストの見積もり、ラベルの回復およびピックアップの見積もりをカバーします。これは本番用の資格情報を使用し、UPSテストシステムは使用しません。
出荷を作成したり、ピックアップを予約したりできますか? ups_create_shipment、ups_void_shipment、ups_create_pickup、およびups_cancel_pickupはオフにインストールされており、費用がかかります。AIがそれらを使用する必要がある場合のみ、アプリに配送およびピックアップの製品を追加し、コネクタページでオンにしてください。
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?