概要
ウクライナのビジネス顧客向けのUkrposhta (Укрпошта) API:出荷追跡、出荷およびPDFラベル、国内価格見積もり、ルートチェック、クライアントおよび住所、郵便局と営業時間を含む住所分類器。出荷の作成と削除はオフになっています。契約者トークンと相手方トークン。
ガイド付きセットアップ
Ukrposhta を ChatGPT に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Ukrposhta を接続して、MCP URL を ChatGPT に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
ChatGPT のプラグインディレクトリにある AnythingMCP プラグインは、AnythingMCP Cloud 上で社内データベース(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB、読み取り専用)への質問に答えます。掲載ページを開き (新しいタブで開きます)、Install plugin をクリックしてください。それ以外のコネクタは、AnythingMCP の MCP URL を使ってカスタム MCP サーバーとして ChatGPT に追加します。
こう聞いてみよう
Ukrposhta のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?直接 cloud.anythingmcp.com を使用してください。 サインインし、Connectors → Ukrposhtaをクリックし、認証情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Ukrposhta + ChatGPT
ウクライナのビジネス顧客向けのUkrposhta (Укрпошта) API:出荷追跡、出荷およびPDFラベル、国内価格見積もり、ルートチェック、クライアントおよび住所、郵便局と営業時間を含む住所分類器。出荷の作成と削除はオフになっています。契約者トークンと相手方トークン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN
ステップ1 — 認証情報を取得する
- UkrposhtaとAPI契約を結ぶ(ビジネス顧客サービス、[email protected])。契約により、プロダクションキーが記載された付属書を受け取ります。
- PRODUCTION BEARER eComを
UKRPOSHTA_ECOM_BEARERに、PRODUCTION BEARER StatusTrackingをUKRPOSHTA_TRACKING_BEARERに、PROD_COUNTERPARTY TOKENをUKRPOSHTA_COUNTERPARTY_TOKENにコピーします。
サンドボックスキー(SANDBOX ...)はここでは機能しません:このコネクタはプロダクションホストを呼び出します。eComベアラーは住所分類器とラベルサービスも開きます。追跡には独自のベアラーがあり、相手方トークンはクライアントと出荷に関する呼び出しでアカウントを識別します。
開始する場所:ukrposhta_track_shipmentまたはukrposhta_get_last_statusをバーコードで使用します。アカウントの出荷については、ukrposhta_get_shipment_by_barcodeまたはukrposhta_list_sender_shipmentsを送信者のクライアントUUIDで使用します。
追跡:ukrposhta_track_shipment(すべてのイベント)、ukrposhta_get_last_status、ukrposhta_get_last_statuses(最大50のバーコード)およびukrposhta_get_shipment_route。langにenを渡して英語のイベント名を取得します。
出荷:ukrposhta_get_shipment、ukrposhta_get_shipment_by_barcode、ukrposhta_list_sender_shipments、ukrposhta_get_shipment_lifecycle、ukrposhta_list_shipment_groups、ukrposhta_list_group_shipments、およびukrposhta_get_label(PDF)。出荷前に、ukrposhta_check_routeおよびukrposhta_calculate_domestic_price(UAH、契約割引なし)を使用します。
出荷の作成はUkrposhtaの順序に従います:送信者と受信者のためにukrposhta_create_address、各クライアントのためにukrposhta_create_client(または再利用:ukrposhta_get_client、ukrposhta_find_clients_by_phone、ukrposhta_get_address)、次にukrposhta_create_shipment、その後ラベルを作成します。ukrposhta_create_shipmentとukrposhta_delete_shipmentはオフにインストールされています:作成された出荷は引き渡し時に課金され、削除されたものは復元できません。住所とクライアントは無料です。
住所分類器:ukrposhta_search_regions、ukrposhta_search_districts、ukrposhta_search_cities、ukrposhta_search_streets、ukrposhta_get_house_postcode、ukrposhta_get_city_by_postcode、および郵便局のためにukrposhta_find_post_offices_by_postcode、ukrposhta_find_post_offices_near、ukrposhta_get_post_office_hours。回答は大文字のフィールド名を持つEntries.Entryリストとして返されます;idは文字列です。
単位と落とし穴:重さはグラム、サイズはセンチメートル、金額はUAH。配達タイプ:W2W(郵便局から郵便局へ)、W2D(玄関先へ)、D2W(玄関先から郵便局へ)およびD2D(玄関先から玄関先へ)。RESTRICTED_ACCESSとマークされた郵便番号は、送信者または返送先住所としてのみ使用できます。ステータス:CREATED(まだ引き渡されていない)、REGISTERED、DELIVERING、IN_DEPARTMENT(オフィスで待機中)、DELIVERED、RETURNING、RETURNED、CANCELLED、DELETED。時間はキエフの現地時間です。
ステップ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 — ChatGPTにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、Add をクリックして Add custom MCP server を選びます。
- 名前を入力します(例: Name:
Ukrposhta)。 - Connection の Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| ツール | 何をするか |
|---|---|
ukrposhta_track_shipment | バーコードによる1つの出荷の完全なステータス履歴:イベントステップごと、日付、郵便局のインデックスと名前、イベントコードおよびeventName(例… |
ukrposhta_get_last_status | バーコードによる1つの出荷の最新のステータス:日付、郵便局のインデックスと名前、イベントコード、eventNameおよびeventReason。読み取り専用 |
ukrposhta_get_last_statuses | 最大50の出荷の最新のステータスを一度に取得し、Ukrposhtaが知らないバーコードも含む:バーコードごとの日付、郵便局、イベントコードおよび… |
ukrposhta_get_shipment_route | バーコードによる出荷の出発地と目的地(国と地域)。読み取り専用 |
ukrposhta_get_shipment | UUIDによるアカウントの1つの出荷を読み取る:バーコード、タイプ、送信者および受信者のクライアントと住所、配達タイプ、パッケージ(重さ… |
ukrposhta_get_shipment_by_barcode | バーコードによるアカウントの1つの出荷を読み取る(ukrposhta_get_shipmentと同じフィールド)。読み取り専用 |
ukrposhta_list_sender_shipments | 1つの送信者クライアントのために作成された出荷のリスト:uuid、バーコード、受信者、配達タイプ、パッケージ、価格およびライフサイクルステータス。読み取り専用 |
ukrposhta_get_shipment_lifecycle | eCom側からの1つの出荷の現在のステータス:shipmentUuid、shipmentBarcode、ステータス(CREATED、REGISTERED、DELIVERING、IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | 1つのクライアントの出荷グループ(フォーム103aの登録)のリスト:uuid、名前、タイプ、作成日、クローズフラグおよび出荷数… |
ukrposhta_list_group_shipments | 1つの出荷グループ内の出荷のリスト:uuid、バーコード、受信者、パッケージ、価格およびライフサイクルステータス。読み取り専用 |
ukrposhta_get_label | 作成した出荷の住所ラベル(ステッカー)をPDFファイルとしてダウンロード:デフォルトで100 x 100 mm、またはA4またはA5シートに印刷します。印刷する… |
ukrposhta_calculate_domestic_price | 出荷を作成する前にウクライナ国内の出荷の価格を見積もる:配達価格はUAH、rawDeliveryPrice、postPayDeliveryPrice… |
ukrposhta_check_route | Ukrposhtaが2つの郵便番号間で配達できるか確認する:コード(利用可能な場合はSUCCESS)、説明およびmrtps(モバイル郵便局の… |
ukrposhta_get_client | アカウントの1つのクライアント(送信者または受信者)を読み取る:uuid、タイプ(INDIVIDUAL、PRIVATE_ENTREPRENEUR、COMPANY)、名前、firstName、lastName… |
ukrposhta_find_clients_by_phone | 電話番号でアカウントのクライアントを見つける:uuid、名前、タイプ、住所。読み取り専用 |
ukrposhta_get_address | ukrposhta_create_addressで作成された住所を読み取る:id、郵便番号、地域、地区、都市、通り、家番号、アパート番号、国… |
ukrposhta_create_address | クライアントまたは出荷のために使用する住所を作成します。郵便番号のみが必要です;玄関先配達のために通りと家を追加します。無料;回答は… |
ukrposhta_create_client | ukrposhta_create_addressの住所でクライアント(送信者または受信者)を作成します。個人および個人事業主はfirst_nameが必要です… |
ukrposhta_create_shipment | 送信者クライアントから受信者クライアントへの国内出荷を作成します。バーコードと価格が付与され、引き渡し時に課金されます… |
ukrposhta_delete_shipment | ステータスがCREATED(まだ引き渡されていない)である出荷を削除します。元に戻すことはできません。オフにインストールされています |
ukrposhta_find_post_offices_by_postcode | 郵便番号を担当する郵便局:ID、PO_SHORTおよびPO_LONG(名前)、ADDRESS、PHONE、TYPE_LONG、LATITUDE、LONGITUDE、POSTTERMINAL… |
ukrposhta_find_post_offices_near | ポイントの近くの郵便局、最も近いものから:ID、名前、住所、郵便番号、距離、座標およびタイプ。読み取り専用 |
ukrposhta_get_post_office_hours | 郵便番号による郵便局の営業時間:曜日ごとの開店時間と閉店時間および休憩。読み取り専用 |
ukrposhta_get_city_by_postcode | 郵便番号の地域、地区および地域、そのIDを含む。読み取り専用 |
ukrposhta_search_regions | 名前の一部で地域(州)を見つける、ウクライナ語または英語で:REGION_ID、REGION_UA、REGION_EN、KOATUUおよびKATOTTGコード。両方を空白のままにします… |
ukrposhta_search_districts | 名前で地域の地区を見つける:DISTRICT_ID、UAおよびENの名前、地域。読み取り専用 |
ukrposhta_search_cities | 名前で地域や地区内の地域を見つける:CITY_ID、UAおよびENの名前、タイプ(都市、村)、地区、地域および… |
ukrposhta_search_streets | 名前で地域の通りを見つける:STREET_ID、UAおよびENの名前、通りのタイプ。読み取り専用 |
ukrposhta_get_house_postcode | 通りの家の郵便番号:家番号とPOSTCODE。読み取り専用 |
例のプロンプト
- "Ukrposhtaの小包0503112345678はどこですか?"
- "昨日の発送からのこれら10のバーコードの最新のステータスを表示してください。"
- "キエフ01001からリヴィウ79000までの2kgの小包はいくらですか?"
- "郵便番号65000の近くにある郵便局はどこで、土曜日の営業時間はいつですか?"
- "出荷0503112345678のラベルをダウンロードしてください。"
FAQ
キーはどこから来ますか? ビジネス契約からのみ:UkrposhtaはプロダクションeComベアラー、StatusTrackingベアラーおよび相手方トークンをAPI契約の付属書に送信します。サンドボックスキーはここでは機能しません。
何をカバーしていますか? 追跡、出荷およびグループ、PDFラベル、国内価格見積もり、ルートチェック、クライアントおよび住所、地域、地名、通り、郵便番号および営業時間を持つ郵便局を含む住所分類器。
どのツールがオフにインストールされていますか? ukrposhta_create_shipmentとukrposhta_delete_shipment。AIが出荷を作成または削除する必要がある場合のみ、コネクタページでオンにしてください。
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?