摘要
Skroutz 市场(智能购物车)API 适用于希腊和塞浦路斯市场的卖家:读取、接受和安排订单,设置为已准备好,跟踪,发票上传,退货,由 Skroutz 库存履行,采购订单和供应商,批量价格和库存更新以及 CPS 订单。来自商家面板的 API 令牌。
引导式设置
2 分钟将 Skroutz 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Skroutz,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Skroutz 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Skroutz,粘贴你的凭据,生成 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Skroutz + Microsoft Copilot
Skroutz 市场(智能购物车)API 适用于希腊和塞浦路斯市场的卖家:读取、接受和安排订单,设置为已准备好,跟踪,发票上传,退货,由 Skroutz 库存履行,采购订单和供应商,批量价格和库存更新以及 CPS 订单。来自商家面板的 API 令牌。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
SKROUTZ_API_TOKEN
第 1 步 — 获取凭据
设置大约需要 3 分钟。
- 登录到 Skroutz 商家面板,打开 Services, Skroutz Marketplace(智能购物车设置页面)。
- 生成 API 令牌,并将其粘贴到
SKROUTZ_API_TOKEN中。每个商店有一个活动令牌:生成新令牌会结束之前的令牌,因此其他集成使用的令牌将停止工作。 - 可选,进行批量价格和库存更新:在 Products, Feed Updates 中生成产品 API 令牌并将其粘贴到
SKROUTZ_PRODUCTS_TOKEN中。 - 可选,针对你自己的网站商店的 CPS 订单:在 Παραγγελίες καταστήματος, Αυτόματη διαχείριση(商店订单,自动处理)中生成 CPS 令牌并将其粘贴到
SKROUTZ_CPS_TOKEN中。
每次调用都会将令牌作为 Authorization: Bearer 发送,媒体类型为 application/vnd.skroutz+json; version=3.0。安装检查读取演示订单 DEMO-OPEN,这证明了市场令牌而不接触真实数据。
从哪里开始:API 没有订单列表。订单通过订单 webhook、商家面板和订单电子邮件到达商店,因此请询问用户订单代码(如 191128-1234567),并使用 skroutz_get_order 读取它。演示代码 DEMO-OPEN、DEMO-ACCEPTED、DEMO-REJECTED、DEMO-INVOICE、DEMO-FBS、DEMO-STORE-PICKUP 和 DEMO-RETURN 可以安全读取、接受和拒绝进行测试:没有数据被存储。
订单:开放订单携带 accept_options 和 reject_options,必须在 expires_at 之前处理。使用 skroutz_accept_order 接受它,发送一个提货地点 ID 和该地点的一个提货窗口的 ID(窗口因地点而异)。然后 Skroutz 预定快递,凭证 PDF 将出现在 courier_voucher 中。快递订单由 Skroutz 自动接受。skroutz_reject_order 安装时关闭:拒绝无法撤销,并且会对商店产生影响。要更改已接受订单的提货,请在提货前使用 action_options 1 读取它,并使用 skroutz_reschedule_order_pickup(来自 reschedule_options 的日期)或 skroutz_relocate_order_pickup(来自 relocate_options 的 ID);列表会随着时间的推移而缩小。skroutz_request_preorder_voucher 提前创建已接受预购的凭证。
设置为已准备好:当订单显示 set_as_ready_required 为真时,Skroutz Last Mile 仅在 skroutz_set_order_ready 之后提货;下载凭证不再标记为已准备好(自 2026 年 3 月 30 日起)。提前标记可以将提货移动到更早的窗口。skroutz_set_order_not_ready 在提货前撤销此操作。对于 set_as_ready_required 为假商店则不需要。
运输和文件:skroutz_update_tracking_details 仅为由商家履行(FBM)订单发送快递和跟踪代码。skroutz_upload_invoice 和 skroutz_upload_credit_invoice 需要一个指向 PDF、PNG 或 JPG 的公共链接(最大 7 MB);连接器下载并上传文件,每个订单一个,替换之前的上传。
退货:skroutz_get_return 通过其代码读取退货(如 R-111111-1111111,来自退货 webhook 或商家面板;订单的 returns 仅提供 uuid 和跟踪 ID)。skroutz_handle_return(在 review.expires_at 之前决定等待审核的退货,包括在商店费用下发送缺失部分)和 skroutz_submit_service_inspection(关于故障项目的技术报告,作为文件链接)安装时关闭,因为它们会导致退款、替换或付费运输。skroutz_file_compensation_request 也关闭:它向 Skroutz 索赔退货商品的费用,并且通过此连接器仅针对不需要照片的原因。
由 Skroutz 履行:skroutz_list_fbs_products(Skroutz 仓库中的库存)、skroutz_list_fbs_purchase_orders、skroutz_list_fbs_purchase_order_items、skroutz_list_fbs_suppliers、skroutz_create_fbs_supplier 和 skroutz_update_fbs_supplier。skroutz_create_fbs_purchase_order 关闭,因为仓库费用由此产生。列表分页,使用 page,并带有 meta.pagination(每页 100 行)。没有 FBS 的商店在这里会收到 401。
产品 API(需要 SKROUTZ_PRODUCTS_TOKEN):skroutz_validate_product_updates 检查批量而不更改任何内容;skroutz_update_products(关闭)更新最多 500 个现有产品及其变体的可用性、价格和数量,异步;skroutz_get_product_update_status 报告每个产品的成功、无变化或失败。这里的价格为 整数欧元分(1050 是 10.50 欧元),而订单金额为小数欧元。它不创建产品:这些来自 XML 供稿。422 表示 XML 正在扫描,意味着稍后再试。
CPS 订单(需要 SKROUTZ_CPS_TOKEN):skroutz_get_cps_order 通过你自己商店的订单号读取你自己网站商店的销售,包含收入和佣金;skroutz_reject_cps_order(关闭)拒绝它,以便不收取佣金。
字段说明:时间为 ISO 8601 格式,带有雅典时区偏移(冬季 +02:00,夏季 +03:00)。提货窗口、拒绝原因和 CPS 状态等标签为希腊语。行项目 ID 是短字符串(l39vKqxqwe);shop_uid 是你自己的产品 ID。错误携带一个 errors 数组,包含 code 和 messages:422 order_status 意味着订单不在可以执行该操作的状态。错误或替换的市场令牌会返回 403。连接器从不移动资金:拒绝、退货决定、赔偿索赔、采购订单和批量产品更新安装时关闭,需由管理员故意开启。
第 2 步 — 安装适配器
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 窗格中试一试:提出需要用到
Skroutz的工具的请求。 - 选择 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 无法使用。
可用工具
| 工具 | 功能 |
|---|---|
skroutz_get_order | 通过其代码读取一个 Skroutz 市场(智能购物车)订单:状态(开放、接受、拒绝、取消、过期、已发货、已交付… |
skroutz_accept_order | 接受一个开放订单:Skroutz 然后预定快递并发放凭证(凭证会作为 courier_voucher 到达订单中)。发送一个… |
skroutz_reject_order | 拒绝一个开放订单,可以通过拒绝选项中的原因 ID 按行项目拒绝(当原因有可用数量时… |
skroutz_reschedule_order_pickup | 将已接受订单的快递提货移动到另一个日期。在提货前使用 action_options 1 读取订单,并发送其… |
skroutz_relocate_order_pickup | 将已接受订单的快递提货移动到商店的另一个提货地点,保持提货日期和时段。快递将… |
skroutz_set_order_ready | 将已接受的订单标记为打包并准备发货(设置为已准备好)。对于订单显示 set_as_ready_required 为真的商店是必需的… |
skroutz_set_order_not_ready | 撤销已接受订单的设置为已准备好,前提是快递尚未提货。Skroutz 尝试将提货时间移回原始日期… |
skroutz_update_tracking_details | 发送每个由商家履行(FBM)订单的快递和跟踪代码,以便客户可以跟踪。仅适用于 FBM… |
skroutz_request_preorder_voucher | 请求已接受预购的快递凭证,当产品在计划发货日期之前到达时(面板的创建… |
skroutz_upload_invoice | 从文件链接(PDF、PNG 或 JPG,最大 7 MB)上传订单的收据或发票。每个订单一个文件:新的上传… |
skroutz_upload_credit_invoice | 上传已取消、退货、部分退货或在收据或发票后退回的订单的信用发票… |
skroutz_file_compensation_request | 请求 Skroutz 为退货的行项目赔偿商店,作为 JSON 发送,无需照片,因此仅针对不需要的原因… |
skroutz_get_return | 通过其代码读取一个退货:状态(pending_merchant_review、returning、pending_physical_review、pending_service_inspection、returned… |
skroutz_handle_return | 在状态为 pending_merchant_review 的退货中决定处理选项之一:批准、拒绝,例如 not_faulty(当… |
skroutz_submit_service_inspection | 提交故障退货商品的技术检查结果(状态为 pending_service_inspection 的退货):商品 ID、其… |
skroutz_list_fbs_products | 列出商店的由 Skroutz 履行(FBS)产品,存储在 Skroutz 仓库中:ID、shop_uid(你的产品 ID)、active(可从… |
skroutz_list_fbs_purchase_orders | 列出商店的由 Skroutz 履行的采购订单(发送到 Skroutz 仓库的库存):代码、created_at、expected_date 和 received_at… |
skroutz_list_fbs_purchase_order_items | 列出一个由 Skroutz 履行的采购订单的行项目:product_id、shop_uid、active、expected_quantity 和 actual_quantity… |
skroutz_create_fbs_purchase_order | 宣布一个新的由 Skroutz 履行的采购订单:你将交付到 Skroutz 仓库的库存,预计日期、供应商… |
skroutz_list_fbs_suppliers | 列出商店的由 Skroutz 履行的供应商:ID(用于采购订单)、代码、名称、地址、城市、区域、邮政编码、电话… |
skroutz_create_fbs_supplier | 添加一个由 Skroutz 履行的供应商(为你向 Skroutz 仓库发货库存)并提供唯一代码、名称、地址、城市、区域、邮政编码… |
skroutz_update_fbs_supplier | 更改由 Skroutz 履行的供应商的字段;仅发送的字段会更改。回答 success: true |
skroutz_validate_product_updates | 检查一批产品更新(可用性、价格(分)、数量、变体)而不更改任何内容:Skroutz 运行每个检查… |
skroutz_update_products | 更新最多 500 个现有产品及其变体的可用性、价格(欧元分)和数量;它不创建… |
skroutz_get_product_update_status | 读取产品批量更新的结果:状态(在任何产品待处理时为 in_progress,然后为 completed)、created_at,以及每个产品… |
skroutz_get_cps_order | 通过你商店提供的订单代码读取一个 CPS 订单(来自 Skroutz 的你自己网站商店的销售,按佣金支付):日期… |
skroutz_reject_cps_order | 拒绝一个 CPS 订单,以便 Skroutz 不收取佣金,使用其拒绝选项之一(user_cancel、user_return、undelivered… |
示例提示
- "显示订单 251114-3920517 及其项目、提货选项和过期时间。"
- "接受订单 251114-3920517,选择我雅典仓库的第一个提货窗口。"
- "订单 251112-1187340 需要设置为已准备好:它准备好标记了吗,提货时间是什么时候?"
- "退货 R-251110-2045318 的状态是什么,我需要在什么时候审核?"
- "我在 Skroutz 仓库中每种产品有多少单位?"
常见问题
令牌来自哪里? 来自 Skroutz 商家面板,它们是三个独立的令牌:市场 API 令牌在 Services, Skroutz Marketplace 下(订单、退货、由 Skroutz 履行),可选的产品 API 令牌在 Products, Feed Updates 下用于批量价格和库存更新,以及针对你自己网站商店订单的可选 CPS 令牌。生成新的市场令牌会结束旧的令牌。
它能列出我的订单吗? 不能。Skroutz API 没有订单列表:订单通过 webhook、商家面板和订单电子邮件到达商店。给 AI 提供订单代码(如 251114-3920517),它会读取订单。演示代码如 DEMO-OPEN 可以安全测试。
哪些工具安装时关闭? skroutz_reject_order 和 skroutz_reject_cps_order,因为拒绝无法撤销,退货工具 skroutz_handle_return、skroutz_submit_service_inspection 和 skroutz_file_compensation_request,skroutz_create_fbs_purchase_order,这会导致仓库费用,以及 skroutz_update_products。
这适用于哪个 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" 即可使用新版本。
下一步
这份指南对你有帮助吗?