连接器指南阅读约 3 分钟29 个 MCP 工具7 种语言

Ukrposhta MCP 服务器:物流、运费与邮局

Ukrposhta (Укрпошта) API 适用于乌克兰的商业客户:货物跟踪、发货和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除发货功能已关闭。合同持有人和对方令牌。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Ukrposhta

Ukrposhta

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

个工具

29

区域

INTL

类别

物流

身份验证

API credentials

所需环境变量

UKRPOSHTA_ECOM_BEARERUKRPOSHTA_TRACKING_BEARERUKRPOSHTA_COUNTERPARTY_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

Ukrposhta (Укрпошта) API 适用于乌克兰的商业客户:货物跟踪、发货和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除发货功能已关闭。合同持有人和对方令牌。

引导式设置

2 分钟将 Ukrposhta 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Ukrposhta,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Ukrposhta 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Ukrposhta · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Ukrposhta,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Ukrposhta

Ukrposhta (Укрпошта) API 适用于乌克兰的商业客户:货物跟踪、发货和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除发货功能已关闭。合同持有人和对方令牌。

设置

  1. 与 Ukrposhta 签署 API 合同(商业客户服务,[email protected])。签署合同后,你将收到包含生产密钥的附件。
  2. 将 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 为英文事件名称。

发货: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。时间为基辅当地时间。

先决条件:UKRPOSHTA_ECOM_BEARER,UKRPOSHTA_TRACKING_BEARER,UKRPOSHTA_COUNTERPARTY_TOKEN

本地安装连接器

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

打开 http://localhost:3000/connectors/store,选择 Ukrposhta 并粘贴在先决条件下列出的环境变量。

可用工具

工具功能
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在创建发货之前估算乌克兰境内发货的价格:交付价格以 UAH 计,原始交付价格,邮费交付价格…
ukrposhta_check_route检查 Ukrposhta 是否在两个邮政编码之间提供服务:代码(可用时为 SUCCESS)、描述和 mrtps(移动邮局的…
ukrposhta_get_client读取你账户中的一个客户(发件人或收件人):uuid、类型(个人、私人企业、公司)、名称、名、姓…
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通过名称的一部分查找地区(州),可以使用乌克兰语或英语: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 的标签。"

下一步

这份指南对你有帮助吗?

2 分钟将 Ukrposhta 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Ukrposhta,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

相关指南

连接器

将 Ukrposhta MCP 接入 ChatGPT

Ukrposhta (Укрпошта) 为乌克兰的商业客户提供 API:货物追踪、货物和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除货物的功能已关闭。合同持有人和对方令牌。

连接器

将 Ukrposhta MCP 接入 Claude

Ukrposhta (Укрпошта) 为乌克兰的商业客户提供 API:货物追踪、货物和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除货物的功能已关闭。合同持有人和对方令牌。

连接器

将 Ukrposhta MCP 接入 Microsoft Copilot

Ukrposhta (Укрпошта) 为乌克兰的商业客户提供 API:货物追踪、货物和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除货物的功能已关闭。合同持有人和对方令牌。

连接器

将 Ukrposhta MCP 接入 Cursor

Ukrposhta (Укрпошта) 为乌克兰的商业客户提供 API:货物追踪、货物和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除货物的功能已关闭。合同持有人和对方令牌。

连接器

将 Ukrposhta MCP 接入 Gemini CLI

Ukrposhta (Укрпошта) 为乌克兰的商业客户提供 API:货物追踪、货物和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除货物的功能已关闭。合同持有人和对方令牌。

连接器

将 Ukrposhta MCP 接入 Meta Muse

Ukrposhta (Укрпошта) 为乌克兰的商业客户提供 API:货物追踪、货物和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除货物的功能已关闭。合同持有人和对方令牌。