如何通过 MCP 将 Aymakan 连接到 Gemini

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

Aymakan + Gemini

在 AI 智能体中使用沙特快递 Aymakan：按运单号或订单参考号跟踪货件，列出你的货件，获取 AWB 面单链接，查询取件请求和时间段、城市、PUDO 网点、仓库和已保存的地址。也包含创建和取消货件及取件，但安装时处于关闭状态。

前提条件

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

AYMAKAN_API_KEY

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个沙特快递公司 Aymakan 的客户账号。

1. 登录 Aymakan 客户后台。
2. 打开 Technical → AyMakan API，复制 API 密钥（security code）。
3. 把它原样粘贴到 AYMAKAN_API_KEY，不要加 Bearer 字样。
4. 安装连接器并运行 aymakan_ping：logged_in 必须显示 Yes。

请使用正式环境的密钥：Aymakan 开发环境的密钥在这里会返回 Invalid Credentials。在后台重新生成密钥后旧密钥会失效，所以也要更新其他仍在使用它的集成。

可读取的内容：按运单号或你自己的订单参考号查询货件，包括收件和取件信息、货到付款金额、重量、件数、当前状态以及中英阿双语的完整状态历史；账号下全部货件的列表，含派送尝试次数和主要日期；面单（AWB）链接；你的取件请求、可上门取件的城市以及某一天的空闲时间段；Aymakan 派送覆盖的城市；储物柜和合作门店等 PUDO 网点；Aymakan 的仓库；以及账号中保存的取件地址。

面单只能在揽收前获取：只有货件仍处于 AY-0001 状态（已创建、尚未揽收）时，Aymakan 才会返回面单 PDF 链接。揽收之后 API 会返回 422，所以请在快递员上门前打印面单。对于多个货件，AI 可以获取一个包含全部面单的 PDF。

按你的订单号查询：只适用于创建时填写了参考号的货件，而且只能查到你自己账号的货件。不存在的参考号会返回 No Shipments Found。

安装时关闭：aymakan_create_shipment、aymakan_cancel_shipment、aymakan_create_pickup_request 和 aymakan_cancel_pickup_request。它们会预约或取消真实的快递服务，因此需要管理员有意识地开启。即便开启后，AI 也会先展示货件（收件人、城市、货到付款金额、件数）、运单号或取件请求，等你同意后再执行。货件只能在 AY-0001 状态下取消，取件请求只能在待处理或处理中时取消。

限制：货件列表固定每页 100 条（每页约 110 KB），所以查询单个货件时 AI 会改用跟踪查询。Aymakan 对每个客户每天的取件请求数量有限制。

常见错误：401 Invalid Credentials 表示密钥错误、重新生成前的旧密钥或开发环境密钥。422 会在消息中给出原因，例如 No Shipments Found、按字段的校验错误，或为已经过了 AY-0001 的货件请求面单。

该连接器不处理货到付款结算或发票；在管理员开启相关工具之前，它也不会预约或取消货件和取件。

步骤 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 现在可以调用 Aymakan 的工具。

可用工具

示例提示

• “运单 AY2866494373 和 AY2866494374 现在到哪里了？”
• “找到我们订单参考号 10045 对应的货件，给我看完整的状态历史。”
• “这周我的哪些货件派送了不止一次？分别在哪些城市？”
• “把今天创建、还没被揽收的所有货件的面单合成一个 PDF 给我。”
• “明天还有哪些取件时间段可以预约？我还有哪些取件请求在等待处理？”

FAQ

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

下一步

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