跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Mirakl Connect，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
面向卖家的 Mirakl Connect：在一个地方查看所有已连接市场和销售渠道的订单、退货、订单文件、客户会话，以及含价格和库存的 Connect 商品目录。它不是单个市场的 Mirakl Seller API。发货、取消和接单在安装时关闭。
试试这样问
Mirakl Connect 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Mirakl Connect、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Mirakl Connect + Microsoft Copilot
面向卖家的 Mirakl Connect：在一个地方查看所有已连接市场和销售渠道的订单、退货、订单文件、客户会话，以及含价格和库存的 Connect 商品目录。它不是单个市场的 Mirakl Seller API。发货、取消和接单在安装时关闭。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
MIRAKL_CONNECT_CLIENT_ID, MIRAKL_CONNECT_CLIENT_SECRET
步骤 1 — 获取凭证
不是 Mirakl Seller API：另一个连接器 Mirakl Seller API（mirakl）每次只对接一个基于 Mirakl 的市场，通过该市场自己的 https://<marketplace>.mirakl.net/api 和店铺 API 密钥访问。Mirakl Connect 是位于其上的卖家端渠道平台：为你公司经营的所有市场和销售渠道提供一个登录和一个 API（https://miraklconnect.com/api），有自己的订单 ID、OAuth2 凭据和接口。如果你的公司在使用 Mirakl Connect，请安装这个连接器。
设置大约需要 5 分钟。
- 按照 Mirakl 指南 Integrating with Connect APIs（面向卖家的 Mirakl Connect 帮助）在 Mirakl Connect 中为公司创建 OAuth2 API 凭据。你会得到 client ID 和 client secret；secret 只显示一次。
- 把它们粘贴到
MIRAKL_CONNECT_CLIENT_ID和MIRAKL_CONNECT_CLIENT_SECRET。AnythingMCP 会在 Mirakl Authentication System（https://auth.mirakl.net/oauth/token，客户端凭据授权）把它们换成有效期约一小时的 Bearer 令牌，并自动续期。 - 安装连接器并运行
mirakl_connect_list_orders：它会列出你最近的订单并确认凭据可用。
订单 ID 和渠道：每个订单都有一个 Connect 订单 ID（id），供 mirakl_connect_get_order 和写入工具使用；渠道自己的订单号在 channel_order_id 中。销售渠道和店铺在 origin（channel_name、channel_store_name）中。Mirakl Connect API 没有列出已连接渠道的接口；AI 从订单的 origin 中读取渠道。
可读取的内容：所有已连接渠道的订单，按最近更新排在前面，包括状态、来源、订单行（商品、数量、价格、税、订单行状态）、配送和账单信息以及履约类型（FULFILLED_BY_SELLER 或 FULFILLED_BY_PARTNER）；不指定 updated_from 或 ID 时，Mirakl 返回最近 30 天。Connect 商品目录，包括标题、品牌、分类、GTIN、图片、标准价和折扣价、库存数量和属性。所有渠道的退货，包括状态（REQUEST_INITIATED、REQUEST_DECLINED、OPENED、RECEIVED、CLOSED）、退货行、方式、RMA ID、面单 URL、物流跟踪和拒绝原因。订单文件，例如客户发票、送货单和退货面单。与订单相关的客户会话，以及单个会话的消息，包括作者、正文和附件。异步订单操作的结果。
筛选：订单可按 statuses、updated_from、fulfillment_type 和订单 ID 筛选。退货需要 updated_from。文件需要订单 ID 或 updated_from，会话需要 updated_from 或会话 ID。
安装时关闭：mirakl_connect_ship_order（把订单行标记为已发货，并把承运商和运单号传给渠道，渠道通常会通知客户）、mirakl_connect_cancel_order_lines（客户会在渠道上收到退款和通知；无法撤销）和 mirakl_connect_accept_order_lines（接受或拒绝处于 AWAITING_ACCEPTANCE 的订单行；拒绝会取消该行且无法撤销）。它们作用于正在运行的销售渠道，因此由管理员有意开启。即使开启后，AI 也会先向你展示订单、订单行和数值并等你同意，订单行 ID 取自订单的 order_lines[].id。这些调用是异步的：它们返回一个 action_id，由于渠道仍可能拒绝该操作，AI 会用 mirakl_connect_get_action_status 检查结果。
分页和限制：只要还有更多条目，每个列表都会返回 next_page_token，AI 把它作为 page_token 传入。订单和退货默认每页 10 条（最多 100 条），文件和会话默认每页 50 条（最多 100 条）；商品每页最多 1000 条，除非需要整个目录，AI 会使用较小的分页大小。Mirakl 要求同步时订单、退货和商品列表每分钟最多调用一次。日期为带时区的 ISO 8601。
常见错误：401 表示 client ID 或 secret 错误，或令牌已过期。403 表示 API 客户端缺少该调用所需的权限范围，例如 connect:order:read 或 connect:shipment:create。402 表示该功能（例如会话）不在账户的 Mirakl Connect 套餐内。404 表示订单或会话 ID 不存在。429 表示调用过多：请等待 Retry-After。
连接器不会修改价格或库存，不会回复会话，不会创建退货，也不会连接新渠道。如果只对接一个 Mirakl 市场而不使用 Mirakl Connect，请使用 Mirakl Seller API 连接器。
步骤 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 窗格中试一试：提出需要用到
Mirakl Connect的工具的请求。 - 选择 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 |
|---|---|
mirakl_connect_list_orders | List orders from every sales channel connected to Mirakl Connect, most recently updated first: Connect order id, channel order id, status… |
mirakl_connect_get_order | Get one order by its Mirakl Connect order id (the id field of mirakl_connect_list_orders, not the channel's order number): status, channel… |
mirakl_connect_list_products | List the products of your Mirakl Connect catalog, sorted by product id: id, titles, brand, category, GTINs, images, standard and discount… |
mirakl_connect_list_returns | List returns updated since a time, across channels: return id, channel return id, order id, channel (origin), status (REQUEST_INITIATED… |
mirakl_connect_list_order_documents | List the documents of orders (customer invoices, delivery slips, return labels, channel-specific documents) with order id, name, type, size… |
mirakl_connect_list_conversations | List customer conversations about orders, most recently updated first: id, linked order (entity), channel (origin), topic, participants… |
mirakl_connect_get_conversation | Read the messages of one conversation, newest first, with their author, text, attachments and dates |
mirakl_connect_get_action_status | Check the result of an asynchronous order action (shipment, cancellation, acceptance): status and any errors from the sales channel |
mirakl_connect_ship_order | Ship items of one order in one package with the same tracking: Mirakl Connect marks the lines shipped and passes carrier and tracking to… |
mirakl_connect_cancel_order_lines | Cancel all or part of order lines: Connect cancels them on the sales channel and the customer is refunded and notified there |
mirakl_connect_accept_order_lines | Accept or refuse order lines in AWAITING_ACCEPTANCE; Connect passes the decision to the sales channel |
示例提示
- “昨天以来我们所有渠道进来了哪些订单？按渠道分组。”
- “找出渠道订单号为 405-1234567-1234567 的订单，显示它的订单行及其状态。”
- “列出本周新开的退货，包括渠道、原因和物流跟踪。”
- “显示今天更新过的客户会话，并总结每位客户的诉求。”
- “用 DHL 运单号 00340434161234567890 发出这个订单的第 1 行。先给我看订单和订单行。”
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" 即可使用新版本。
下一步
这份指南对你有帮助吗?