跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Aymakan，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
在 AI 智能体中使用沙特快递 Aymakan：按运单号或订单参考号跟踪货件，列出你的货件，获取 AWB 面单链接，查询取件请求和时间段、城市、PUDO 网点、仓库和已保存的地址。也包含创建和取消货件及取件，但安装时处于关闭状态。
试试这样问
Aymakan 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Aymakan、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Aymakan + Microsoft Copilot
在 AI 智能体中使用沙特快递 Aymakan：按运单号或订单参考号跟踪货件，列出你的货件，获取 AWB 面单链接，查询取件请求和时间段、城市、PUDO 网点、仓库和已保存的地址。也包含创建和取消货件及取件，但安装时处于关闭状态。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
AYMAKAN_API_KEY
步骤 1 — 获取凭证
设置大约需要 2 分钟。你需要一个沙特快递公司 Aymakan 的客户账号。
- 登录 Aymakan 客户后台。
- 打开 Technical → AyMakan API，复制 API 密钥（security code）。
- 把它原样粘贴到
AYMAKAN_API_KEY，不要加 Bearer 字样。 - 安装连接器并运行
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 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name（例如
AnythingMCP）、说明连接器用途的 Server description，以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key，把 Type 设为 Header，请求头名称填
X-API-Key，然后选择 Create。 - 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试：提出需要用到
Aymakan的工具的请求。 - 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
aymakan_ping | Check the Aymakan API status and the API key: returns status, environment (production) and logged_in Yes or No |
aymakan_get_tracking | Track one or more Aymakan shipments by tracking number: full shipment data with delivery and collection details, COD amount, weight and… |
aymakan_get_shipments_by_reference | Get Aymakan shipments by your own order reference (the reference given when the shipment was created): full shipment data, tracking_info… |
aymakan_list_shipments | List every shipment of the account, 100 per page (fixed by Aymakan): tracking number, reference, service type, COD flag and amount, pieces… |
aymakan_get_awb_label | Get the link to the PDF AWB label of one shipment by tracking number |
aymakan_get_bulk_awb_labels | Get one PDF link with the AWB labels of several shipments |
aymakan_list_pickup_requests | List the pickup requests of the account with id, pickup code, type, contact, city and address, number of shipments and picked shipments… |
aymakan_list_pickup_cities | List the cities where Aymakan accepts pickup requests, in English and Arabic |
aymakan_get_time_slots | Get the pickup time slots available to the account on a date (e.g. morning, afternoon, evening with their hours) |
aymakan_list_cities | List the cities Aymakan delivers to, in English (city_en) and Arabic (city_ar) |
aymakan_list_pudo_locations | List PUDO (pickup and drop-off) points such as lockers and partner shops with id, name in English and Arabic, address, city, coordinates… |
aymakan_list_dropoff_locations | List Aymakan's warehouses where shipments can be dropped off: name, city, address, manager, phone, e-mail and coordinates |
aymakan_list_addresses | List the collection addresses saved on the Aymakan account: id, title, name, e-mail, city, address, postcode, neighbourhood, phone, country… |
aymakan_create_shipment | Create a new Aymakan shipment |
aymakan_cancel_shipment | Cancel an Aymakan shipment by tracking number |
aymakan_create_pickup_request | Book a courier pickup: date (today or later), time slot from aymakan_get_time_slots, city from aymakan_list_pickup_cities, contact name and… |
aymakan_cancel_pickup_request | Cancel a pickup request by its id (from aymakan_list_pickup_requests) |
示例提示
- “运单 AY2866494373 和 AY2866494374 现在到哪里了？”
- “找到我们订单参考号 10045 对应的货件，给我看完整的状态历史。”
- “这周我的哪些货件派送了不止一次？分别在哪些城市？”
- “把今天创建、还没被揽收的所有货件的面单合成一个 PDF 给我。”
- “明天还有哪些取件时间段可以预约？我还有哪些取件请求在等待处理？”
FAQ
这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?