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

将 Ukrposhta MCP 接入 Claude

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

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

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

AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。

试试这样问

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 + Claude

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

前提条件

请查看连接器中提供的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN

第一步 — 获取凭据

  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 为 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

第三步 — 在 Claude 中添加连接器

你的服务器 URL: 在 AnythingMCP 中,打开 MCP Servers → 此连接器所在的服务器,并复制其 URL(https://cloud.anythingmcp.com/mcp/…)。在本指南中显示 YOUR_SERVER_ID 的地方使用它。

推荐路径:在 claude.ai web 上工作,无需编辑任何配置文件。

  1. 在 Claude 中,打开 Plugins(部分套餐仍显示为 Customize)→ Connectors。
  2. 点击 + Add,然后选择 Add custom connector。
  3. 输入名称,例如 Ukrposhta,以及远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Continue,保留检测到的设置,再次点击 Continue。
  4. 选择 Sign in now,点击 Add 并登录 AnythingMCP(OAuth)以允许访问。

以下所有工具将出现在你的聊天中:开始输入提示。

可用工具

工具功能
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 的标签。"

常见问题

它是否适用于 Claude Code 和 Claude Desktop? 是的,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。

密钥来自哪里? 仅来自商业合同:Ukrposhta 在你的 API 合同附录中发送生产 eCom 令牌、StatusTracking 令牌和对方令牌。沙盒密钥在此处无效。

它涵盖了什么? 追踪、你的货物和组、PDF 标签、国内价格估算、路线检查、客户和地址,以及带有地区、地方、街道、邮政编码和邮局营业时间的地址分类器。

哪些工具安装时关闭? ukrposhta_create_shipment 和 ukrposhta_delete_shipment。仅在 AI 应该创建或删除货物时在连接器页面上启用它们。

下一步

这份指南对你有帮助吗?

2 分钟将 Ukrposhta 连接到 Claude

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

相关指南

连接器

将 Ukrposhta MCP 接入 ChatGPT

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 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除货物的功能已关闭。合同持有人和对方令牌。

连接器

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

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