摘要
Ukrposhta (Укрпошта) 为乌克兰的商业客户提供 API:货物追踪、货物和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除货物的功能已关闭。合同持有人和对方令牌。
引导式设置
2 分钟将 Ukrposhta 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Ukrposhta,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。
试试这样问
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
第一步 — 获取凭据
- 与 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。时间为基辅当地时间。
第二步 — 安装适配器
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
第三步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 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 | 通过条形码获取单个货物的完整状态历史:按事件步骤、日期、邮局索引和名称、事件代码和事件名称(例如… |
ukrposhta_get_last_status | 通过条形码获取单个货物的最新状态:日期、邮局索引和名称、事件代码、事件名称和事件原因。只读 |
ukrposhta_get_last_statuses | 一次最多获取 50 个货物的最新状态,以及 Ukrposhta 不知道的条形码:按条形码日期、邮局、事件代码和… |
ukrposhta_get_shipment_route | 通过条形码获取货物的起点和终点(国家和地区)。只读 |
ukrposhta_get_shipment | 通过 uuid 读取你账户中的单个货物:条形码、类型、发件人和收件人客户及地址、交付类型、包裹(重量… |
ukrposhta_get_shipment_by_barcode | 通过条形码读取你账户中的单个货物(与 ukrposhta_get_shipment 相同的字段)。只读 |
ukrposhta_list_sender_shipments | 列出为单个发件人客户创建的货物:uuid、条形码、收件人、交付类型、包裹、价格和生命周期状态。只读 |
ukrposhta_get_shipment_lifecycle | 从 eCom 侧获取单个货物的当前状态:shipmentUuid、shipmentBarcode、状态(CREATED、REGISTERED、DELIVERING、IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | 列出单个客户的货物组(103a 表格的注册):uuid、名称、类型、创建日期、关闭标志和货物数量。… |
ukrposhta_list_group_shipments | 列出单个货物组中的货物:uuid、条形码、收件人、包裹、价格和生命周期状态。只读 |
ukrposhta_get_label | 下载你创建的货物的地址标签(贴纸),以 PDF 文件形式提供:默认 100 x 100 mm,或在 A4 或 A5 纸上。打印… |
ukrposhta_calculate_domestic_price | 在创建货物之前估算乌克兰境内货物的价格:deliveryPrice 以 UAH 为单位,rawDeliveryPrice、postPayDeliveryPrice… |
ukrposhta_check_route | 检查 Ukrposhta 是否在两个邮政编码之间提供服务:代码(可用时为 SUCCESS)、描述和 mrtps(移动邮局的… |
ukrposhta_get_client | 读取你账户中的单个客户(发件人或收件人):uuid、类型(INDIVIDUAL、PRIVATE_ENTREPRENEUR、COMPANY)、名称、名、姓… |
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(名称)、地址、电话、类型、纬度、经度、邮政终端… |
ukrposhta_find_post_offices_near | 附近的邮局,按距离排序:ID、名称、地址、邮政编码、距离、坐标和类型。只读 |
ukrposhta_get_post_office_hours | 通过邮政编码获取邮局的营业时间:按工作日的开闭时间和休息时间。只读 |
ukrposhta_get_city_by_postcode | 邮政编码的地区、区和省份及其 ID。只读 |
ukrposhta_search_regions | 通过名称的一部分查找地区(oblasts),可以使用乌克兰语或英语:REGION_ID、REGION_UA、REGION_EN、KOATUU 和 KATOTTG 代码。两个… |
ukrposhta_search_districts | 通过名称查找某个地区的区:DISTRICT_ID、乌克兰语和英语的名称、地区。只读 |
ukrposhta_search_cities | 通过名称查找地方,选项包括地区和区:CITY_ID、乌克兰语和英语的名称、类型(城市、村庄)、区、地区和… |
ukrposhta_search_streets | 通过名称查找某个地方的街道:STREET_ID、乌克兰语和英语的名称、街道类型。只读 |
ukrposhta_get_house_postcode | 街道上房屋的邮政编码:门牌号和邮政编码。只读 |
示例提示
- "Ukrposhta 包裹 0503112345678 在哪里?"
- "显示昨天发货的这 10 个条形码的最新状态。"
- "从基辅 01001 到利沃夫 79000 的 2 公斤包裹多少钱?"
- "邮政编码 65000 附近有哪些邮局,周六的营业时间是什么?"
- "下载货物 0503112345678 的标签。"
常见问题
密钥来自哪里? 仅来自商业合同:Ukrposhta 在你的 API 合同附录中发送生产 eCom 令牌、StatusTracking 令牌和对方令牌。沙盒密钥在此处无效。
它涵盖了什么? 追踪、你的货物和组、PDF 标签、国内价格估算、路线检查、客户和地址,以及带有地区、地方、街道、邮政编码和邮局营业时间的地址分类器。
哪些工具安装时关闭? ukrposhta_create_shipment 和 ukrposhta_delete_shipment。仅在 AI 应该创建或删除货物时在连接器页面上启用它们。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?