如何将 Nova Poshta 连接到 Gemini — 通过 MCP

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Nova Poshta、粘贴凭证、生成 MCP API key — 完成。无 Docker、无 git clone、无本地服务器。

Nova Poshta + Gemini

Nova Poshta（Нова Пошта），乌克兰的包裹承运商：一次最多跟踪 100 个运单，查找城市、网点或自提柜，计算运费和送达日期，并列出你自己的发货记录。物流跟踪和查询无需 API 密钥。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

(none — public API)

步骤 1 — 获取凭证

1. 物流跟踪、城市和网点搜索、运费及送达日期计算均无需密钥，不需要做任何设置。
2. 只有 nova_poshta_list_shipments（你自己的运单）需要密钥。在 new.novaposhta.ua 的 Nova Poshta 企业账户中打开 Settings → Security，点击 Create key，接受 API 条款，然后将密钥填入 NOVA_POSHTA_API_KEY。密钥有效期为一年；密钥过期后所有调用都会失败，因此请及时续期或清空该变量。
3. nova_poshta_track_parcels 最多接受 100 个运单（TTN）号码。加上寄件人或收件人的电话号码即可获取完整记录；不加则只能获取状态。
4. 查询运费和送达日期时，先用 nova_poshta_search_settlements 解析城市，然后将其 DeliveryCity 值（而不是 Ref）连同服务类型一起传给 nova_poshta_get_delivery_price 或 nova_poshta_get_delivery_date。服务类型可选 Warehouse（网点）、Doors（地址）或 Postomat（自提柜）。

日期格式为 DD.MM.YYYY，重量单位为 kg，声明价值以 UAH 计。即使调用失败，Nova Poshta 也会返回 HTTP 200，因此助手会读取 success 和 errors；未知的跟踪号码会返回“Номер не знайдено”（未找到该号码）。文本为乌克兰语，许多记录还带有俄语的 DescriptionRu。

步骤 2 — 安装 adapter

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 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list）— anythingmcp 应显示为已连接。
4. 开始输入提示 — Gemini CLI 现在可以调用 Nova Poshta 的工具。

可用工具

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT