概要
出荷業者向けのUSPS API:米国の住所を検証し、ZIPコードを検索し、国内および国際価格を比較し、配達日と配送オプションを取得し、荷物を追跡し、郵便局、ドロップオフサイト、パーセルロッカーを見つけます。ラベル、払い戻し、ピックアップ、SCANフォームが含まれていますが、オフになっています。USPSカスタマーオンボーディングポータル内のアプリのコンシューマキーとシークレット。
ガイド付きセットアップ
USPS を Meta Muse に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで USPS を接続して、MCP URL を Meta Muse に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
USPS のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → USPSをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
USPS + Meta Muse
出荷業者向けのUSPS API:米国の住所を検証し、ZIPコードを検索し、国内および国際価格を比較し、配達日と配送オプションを取得し、荷物を追跡し、郵便局、ドロップオフサイト、パーセルロッカーを見つけます。ラベル、払い戻し、ピックアップ、SCANフォームが含まれていますが、オフになっています。USPSカスタマーオンボーディングポータル内のアプリのコンシューマキーとシークレット。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
USPS_CLIENT_ID, USPS_CLIENT_SECRET, USPS_API_HOST
ステップ1 — 資格情報を取得する
設定には約15分かかります。
- https://cop.usps.com/cop-navigator?wf=API でUSPSカスタマーオンボーディングポータルを開き、USPSビジネスアカウントでサインインするか、そこで新しいアカウントを作成します。このポータルはUSPS API用にアカウントを準備します。
- ポータルの上部でMy Appsを選択し、アプリを追加します。
- アプリを開き、CredentialsでConsumer Keyを
USPS_CLIENT_IDに、Consumer SecretをUSPS_CLIENT_SECRETにコピーします。 USPS_API_HOSTでAPIアドレスを選択します:本番環境https://apis.usps.com、またはメール業者用のテスト環境https://apis-tem.usps.com。どちらも同じ本番資格情報を使用します。テストホストで作成されたラベルには透かしがあり、料金は発生しません。USPSは追跡を除くすべてのAPIのテストホストを公開していますので、主に追跡を行う場合は本番環境を使用してください。- オプションとして、ラベルと契約価格用に、
USPS_CRID、USPS_MID、USPS_EPS_ACCOUNT_NUMBERにそれぞれCRID、Mailer ID、エンタープライズ支払いアカウント番号を入力します。これらはビジネスカスタマーゲートウェイアカウントのビジネスサービス管理者が持っています。
コネクタは選択したホストの/oauth2/v3/tokenにコンシューマキーとシークレットを送信し(クライアント資格情報)、約8時間有効なベアラートークンを取得し、それを再利用して更新します。
新しいアプリが使用できるもの:すべてのアプリはUSPSのデフォルト製品から始まります:OAuth、住所、国内価格、国際価格、ロケーション、サービス基準、配送オプション、追跡。したがって、住所、価格、配達日、配送オプション、追跡、郵便局、ドロップオフロケーションはすぐに機能します。キャリアピックアップ、支払い、ラベル、国際ラベル、SCANフォームにはUSPSの承認が必要です:これらを取得するには、Email Usページ(https://emailus.usps.com/s/usps-APIs)でUSPS APIサービスリクエストを行ってください。ラベルAPIは、USPS Ship(発送および返送ラベル)および郵便料金を支払うエンタープライズ支払いアカウント(EPS)への登録も必要です。パーセルロッカー(usps_find_parcel_lockers)および国際サービス基準(usps_get_international_service_standard)には独自のスコープがあります。これらが403で応答する場合は、同様にUSPSにリクエストしてください。
開始する場所:usps_get_city_stateを使用してZIPコードで接続を確認します。見積もりには、usps_search_shipping_optionsがすべてのサービスの価格と配達日を1回の呼び出しで返します。usps_search_domestic_pricesおよびusps_search_international_pricesは、追加サービスを含む価格の内訳を提供します。
住所:usps_validate_addressは米国の住所を標準化し、ZIP+4、DPVConfirmation(Yは確認済み、Dは二次番号が欠落、Sは二次番号が未確認、Nは未確認)、business(YまたはN)、およびvacantを返します。usps_get_zip_codeは都市と州の通りのZIPコードを見つけ、usps_get_city_stateはZIPコードの都市と州を見つけます。州は2文字のコードです。米国の住所(領土および軍事住所を含む)のみが対象です。
価格:荷物はポンドで計量され、インチで測定されます。手紙、フラット、カードはオンスで計量されます。price_type COMMERCIALはオンラインで購入したラベルの料金、RETAILは郵便局のカウンター価格、CONTRACTはaccount_typeおよびaccount_numberが必要です。usps_search_domestic_pricesは、rateOptionsを返し、totalBasePrice、totalPrice、および追加サービスを含みます。usps_list_domestic_pricesは、各製品のSKU、rateIndicator、およびprocessingCategoryを含むすべての適格製品をリストします。usps_search_letter_pricesはファーストクラスメールの手紙、フラット、はがきの価格を提供します。海外の場合:usps_search_international_prices(オプションで、アイテムごとの関税および税金を含む)、usps_list_international_pricesおよびusps_search_international_letter_prices。郵送日は今日から最大7日先まで可能です。金額は米ドルです。USPS_GROUND_ADVANTAGEはファーストクラスパッケージサービスおよびリテールグラウンドに取って代わりました。
配達日:usps_get_delivery_estimatesは、特定の日に受け付けられた郵便物の予定配達日を提供し、受け入れ締切時間(cutOffTime、HHMMローカル)を含みます。usps_get_service_standardsは、郵便クラスごとの標準的な配達日数を提供し、usps_get_international_service_standardは「5-9営業日での配達予定」といった文を返します。サービス基準は目標であり、保証ではありません。
追跡:usps_track_packageは1つの番号を追跡し、usps_track_packagesは最大35の番号を一度に追跡します。両方ともTracking 3.2を使用します。レガシーTracking 3.0 APIは2027年7月31日に廃止されます。応答にはstatusCategory、statusSummary、trackingEvents(eventTimestampはイベントのローカル時間、GMTTimestampはUTC)、deliveryDateExpectation、およびuniqueTrackingIDが含まれます。バッチは、いくつかの番号が失敗した場合にHTTP 207で応答し、各失敗した番号には独自のerrorが含まれます。usps_register_tracking_notificationsは、追跡メール用に最大3つのメールアドレスを登録し、usps_request_proof_of_deliveryは配達証明書をメールで送信します。両方とも追跡応答のuniqueTrackingIDが必要で、USPSからのメールを送信し、費用はかかりません。
ロケーション:usps_find_post_officesはZIPコード、都市と州、住所、または座標(半径はマイル単位、デフォルトは20マイル)で検索し、各サービスの営業時間をリストします。usps_find_dropoff_locationsは、目的地ZIPコードごとにParcel Select、USPS Connect、Package Servicesのドロップオフ施設をリストします。usps_find_parcel_lockersはパーセルロッカーを見つけます。
ピックアップ:usps_check_pickup_eligibilityおよびusps_get_pickupは読み取り専用です。usps_schedule_pickupは無料のキャリアピックアップを予約し(月曜日から土曜日)、usps_cancel_pickupは1つをキャンセルします。両方ともオフになっています。ここでピックアップを変更することはできません:キャンセルして新しいものを予約してください。
ラベル(オフになっています):すべてのラベル呼び出しには支払い承認トークンが必要です。usps_create_payment_authorizationを使用してCRID、Mailer ID、EPSアカウントを指定すると、paymentAuthorizationTokenが返されます。これをusps_create_label、usps_create_return_label、usps_create_international_label、usps_cancel_label、またはusps_cancel_international_labelに渡します。ラベルはJSON形式で返されます:labelMetadataには追跡番号と郵便料金が含まれ、labelImageはbase64形式(デフォルトは4x6 PDF)です。ラベルを作成すると、EPSアカウントから郵便料金が購入されます。キャンセルの応答はCANCELEDで、USPSが払い戻しリクエストを開いた場合はDISPUTEDとともにdisputeIdが返されます。usps_get_payment_accountはアカウントを読み取り、amountが指定されている場合は資金が十分かどうかを示します。usps_create_scan_formは、1つのPS Form 5630に多くのラベルを配置し、単一の受け入れスキャンで各パッケージを記録します。これらのツールは、USPSがラベルAPIを承認した後にのみオンにし、最初にテストホストで試してください。
エラー:失敗はerrorとして返され、code、message、およびerrorsのリスト(title、detail、source.parameter)が含まれます。400は間違ったフィールドを示します。401は資格情報が間違っているか、トークンが期限切れであることを意味します。403はアプリがそのAPIを持っていないことを示します(デフォルト製品の外にあります)。404はUSPSが何も見つけられなかったことを示します。たとえば、未知の追跡番号です。
制限:各アプリには時間あたりの呼び出しのクォータがあります。429は次の時間まで使用できないことを意味します。USPSはEmail Usページを通じてリクエストに応じてクォータを引き上げます。日付はYYYY-MM-DD形式です。
ステップ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 — Museにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。
- Muse で Settings → Connectors を開き、Add custom connector を選びます。
- MCP サーバーの URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを貼り付けます。 - Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
- チャットで、
USPSのツールが必要になる依頼を Muse にしてみましょう。
チャットから設定することもできます(Web、iOS・Android アプリ、WhatsApp)。Muse に次のメッセージを送ってください:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
usps_validate_address | 1つの米国住所を検証し、標準化します。USPS標準形式でaddressを返します(streetAddress、city、state、ZIPCode、ZIPPlus4)… |
usps_get_city_state | 5桁のZIPコードの都市と州を検索します。city(大文字)、state(2文字)、ZIPCodeを返します。安価な呼び出しとして使用されます… |
usps_get_zip_code | 都市と州の通り住所のZIPコードとZIP+4を見つけます。標準化された通り、city、stateを含むaddressを返します… |
usps_search_domestic_prices | 郵便クラスごとに国内パッケージの価格を計算し、追加サービスを含みます。適格製品ごとに1つのrateOptionsを返します… |
usps_list_domestic_prices | 国内パッケージが適格なすべての製品をリストし、基本価格と追加サービスなしで表示します。rateOptionsを返します… |
usps_search_letter_prices | 米国内で送信されるファーストクラスメールの手紙、フラット(大封筒)、またははがきの価格を計算します。totalBasePriceとrates(SKU… |
usps_search_international_prices | 国際的なパッケージの価格を計算し、追加サービスを含め、リクエストに応じてアイテムごとの関税および税金を含みます。適格製品ごとに1つのrateOptionsを返します… |
usps_list_international_prices | 国際的なパッケージが適格なすべての製品をリストし、基本価格と追加サービスなしで表示します。rateOptionsを返します… |
usps_search_international_letter_prices | ファーストクラスメール国際手紙、フラットまたははがきの価格を計算します。totalBasePrice、rates(SKU、description、price、fees)を返します… |
usps_get_delivery_estimates | 特定の日に受け付けられた郵便物の配達日を推定します。郵便クラスごとに1つのエントリを持つリストを返し、serviceStandard(日数)を含みます… |
usps_get_service_standards | 2つのZIPコード間の郵便クラスごとの標準的な配達日数を取得します。mailClass、daysを含むリストを返します… |
usps_get_international_service_standard | 国への国際郵便クラスの期待される配達時間を取得します。countryCode、mailClassを返します… |
usps_search_shipping_options | 1つのパッケージを1回の呼び出しで発送するすべての方法を比較します:価格と配達の約束を一緒に、国内または国際的に。返されるのは… |
usps_track_package | 1つのUSPSパッケージをTracking 3.2で追跡します。trackingNumber、uniqueTrackingID、mailClass、status、statusCategory(例… |
usps_track_packages | 最大35のUSPSパッケージを1回の呼び出しでTracking 3.2で追跡します。各番号に対して1つの結果を返し、trackingNumber、uniqueTrackingID… |
usps_register_tracking_notifications | 1つのパッケージに関するUSPS追跡メール用に最大3つのメールアドレスを登録します:配達予定の更新、配達活動、またはすべての更新。必要なもの… |
usps_request_proof_of_delivery | 配達されたパッケージの配達証明書(または電子的な返送受領書)を最大3人の受取人にメールで送信します。必要なものは… |
usps_find_post_offices | ZIPコード、住所、または座標の近くにある郵便局やその他の小売場所を見つけます。最も近いものから返されるのはlocations… |
usps_find_dropoff_locations | Parcel Select、USPS Connect、Package Servicesの郵便物を目的地ZIPコードごとにドロップオフできる施設を見つけます… |
usps_find_parcel_lockers | ZIPコードまたは都市と州でUSPSパーセルロッカーを見つけます。facilityID、locationName、locationAddressを含むロッカーのリストを返します… |
usps_check_pickup_eligibility | USPSが住所で無料のキャリアピックアップを提供しているかどうかを確認します。住所が標準化された形式である場合、200で応答します… |
usps_get_pickup | 確認番号でスケジュールされたキャリアピックアップを取得します。confirmationNumber、pickupDate、およびcarrierPickupRequest(住所… |
usps_get_payment_account | エンタープライズ支払いアカウントまたは許可を確認します。アカウントの詳細を返し、amountが指定されている場合はsufficientFunds(trueまたはfalse)を返します… |
usps_create_payment_authorization | すべてのラベル呼び出しに必要な支払い承認トークンを取得します:ビジネスをPAYERおよびLABEL_OWNERとして名前付けし、CRID、Mailer ID、… |
usps_create_label | 郵便料金を購入し、エンタープライズ支払いアカウントから支払い承認トークンで国内配送ラベルを作成します。返されるのは… |
usps_create_return_label | 顧客がパッケージを返送するための国内返送ラベルを作成します(to_addressはあなたの返送先住所、from_addressは顧客の住所です)。… |
usps_cancel_label | 未使用の国内ラベルをキャンセルするか、郵便料金の払い戻しをリクエストします。trackingNumber、status(CANCELED、または払い戻しリクエストがある場合はDISPUTED)を返します… |
usps_create_international_label | 郵便料金を購入し、国際ラベルを作成します。税関フォーム(ファーストクラスパッケージ国際サービス、優先郵便国際… |
usps_cancel_international_label | 未使用の国際ラベルをキャンセルするか、郵便料金の払い戻しをリクエストします。追跡番号、status(CANCELEDまたはDISPUTED)、および… |
usps_schedule_pickup | あなたの住所でパッケージの無料USPSキャリアピックアップを予約します(月曜日から土曜日;当日分は午前2時中央時間まで)。返されるのは… |
usps_cancel_pickup | 確認番号でスケジュールされたキャリアピックアップをキャンセルします。キャンセル時に200で応答します。インストールはオフになっています:キャンセルは… |
usps_create_scan_form | ラベルを1つのバーコードにリンクするSCANフォーム(PS Form 5630)を作成します。これにより、受け入れ時に単一のスキャンで各パッケージを記録します。返されるのは… |
例のプロンプト
- "USPSパッケージ9400111899223197428490はどこですか?"
- "1600 Pennsylvania Ave NW, Washington DC 20500は有効な住所ですか?そのZIP+4は何ですか?"
- "明日発送する3ポンドの箱のUSPS価格と配達日を比較してください。"
- "トロントへの2ポンドのパッケージのUSPS優先郵便料金はいくらですか?"
- "ZIP 60614の近くで土曜日に開いている郵便局を見つけてください。"
FAQ
USPSの資格情報はどこから来ますか? USPSカスタマーオンボーディングポータル(cop.usps.com)内のアプリから、USPSビジネスアカウントでサインインして取得します:My Appsを開き、アプリを追加し、そのConsumer KeyとConsumer Secretをコピーします。本番ホストまたはメール業者用のテスト環境を選択してください。どちらも同じ資格情報を使用します。
すぐに機能するものと、USPSの承認が必要なものは何ですか? 住所、価格、配達日、配送オプション、追跡、ロケーションはすべての新しいアプリで機能します。キャリアピックアップ、支払い、ラベル、SCANフォームにはUSPSの承認が必要です。USPS APIサービスリクエストを通じて承認を取得してください。ラベルにはUSPS Shipとエンタープライズ支払いアカウントも必要です。
どのツールがオフになってインストールされますか? 購入または予約を行うツール:usps_create_payment_authorization、usps_create_label、usps_create_return_label、usps_cancel_label、usps_create_international_label、usps_cancel_international_label、usps_schedule_pickup、usps_cancel_pickup、およびusps_create_scan_form。USPSが承認した後、コネクタページでオンにし、AIが使用できるようにしてください。
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?