摘要
Spartoo 市场的卖家网络服务:包含客户和交付详情的订单,接受和发货带有追踪号码的订单,退货,网站上产品的状态和每个尺码的库存更新。合作伙伴代码作为表单字段,XML 答复以 JSON 格式读取。
引导式设置
2 分钟将 Spartoo Marketplace 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Spartoo Marketplace,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。
试试这样问
Spartoo Marketplace 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Spartoo Marketplace,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Spartoo Marketplace + ChatGPT
Spartoo 市场的卖家网络服务:包含客户和交付详情的订单,接受和发货带有追踪号码的订单,退货,网站上产品的状态和每个尺码的库存更新。合作伙伴代码作为表单字段,XML 答复以 JSON 格式读取。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
SPARTOO_HOST, SPARTOO_PARTNER_KEY
第一步 — 获取凭据
设置大约需要 3 分钟。
- 登录 Spartoo 市场后台,打开 Documentation,然后 Webservices 和任意服务页面,例如 Exporting orders。
- 行 Webservice URL 指定了你的 Spartoo 网站的网络服务地址,例如
https://sws.spartoo.eu或https://sws.spartoo.it。将/mp/之前的部分放入SPARTOO_HOST。 - 在同一页面,行
partner显示你登录时的唯一代码。将其放入SPARTOO_PARTNER_KEY。如果页面未显示代码,请向你的 Spartoo 市场联系人询问你账户的网络服务代码。
从哪里开始:spartoo_list_orders 以开始日期为参数。spartoo_get_order 通过其 ID 读取一个订单。
订单:订单状态为 11(已验证)时到达。spartoo_accept_order 将其状态更改为 2(准备中):之后其名称、地址和承运人将无法更改。spartoo_ship_order 将其从 2 更改为 3(已发货),并附上承运人的追踪号码,Spartoo 会将追踪链接通过电子邮件发送给客户。spartoo_cancel_order(状态 41)默认关闭:客户将获得退款,且无法撤销。状态 45(包裹丢失)和 47(包裹未送达)由 Spartoo 设置。
退货:spartoo_list_returns 和 spartoo_get_return。一个退货包含一个产品。退货状态:2 等待接收,3 拒绝,4 包裹已接收且退货被接受,5 已付款,7 退款,14 等待商家的预付退货标签。此连接器不接受或拒绝退货。
产品和库存:spartoo_check_product_status 指示产品是否在网站上(OK)、缺货(OS)、已创建但尚未上线(EC)或未知(KO),并给出原因。spartoo_update_stock 设置一个尺码的库存。两者使用你自己的引用:reference_partenaire 是一种颜色的产品,size_reference 是其一种尺码。库存为 0 时,该尺码将从网站上移除。
字段说明
- 订单 ID 和退货 ID 是短代码,例如
90D813EA1A2365A8。 - 订单日期过滤器格式为
YYYY-MM-DD:hh:mm:ss,日期和小时之间用冒号分隔。退货日期过滤器为 Unix 时间戳(秒)。Spartoo 不记录时区。 - 价格为订单网站货币的十进制数字;
products_final_price是折扣后的单价乘以数量。 - 取件点的订单有
relay_info代替交付地址。 - 文本值以字符串形式到达,包括数字。列表中的一个订单或产品作为对象到达,多个则作为数组。
错误:每个答复都带有一个代码。1 表示没有错误。-1 和 -2:缺少或未知的合作伙伴代码。-3:缺少日期或 ID。-4:日期格式错误。-6 和 -28:未找到订单或退货。-8:拒绝追踪号码。-9:订单已具有该状态。-19:状态顺序错误(2 仅可从 11 转换,3 仅可从 2 转换)。-14:未找到产品。-16、-18 和 -20:库存未更改(不可能,已是该值,或尺码不再有效)。-30:订单太旧无法发货,请联系 Spartoo。-428:账户已停用。-429:一小时内请求过多。连接器报告负代码作为失败调用。
未涵盖:创建和编辑产品、价格和折扣(它们通过 XML 目录文件进行),装箱单和退货决定。
第二步 — 安装适配器
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
第三步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
Spartoo Marketplace。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
spartoo_list_orders | 列出自某日期以来下的订单,选项仅列出某一状态的订单。每个订单在 root.orders.order 下:orders_id, customers… |
spartoo_get_order | 通过其 ID 读取一个订单:客户和交付详情(或取件点在 relay_info 中)、支付方式、运费名称和价格、订单… |
spartoo_accept_order | 接受一个新订单:将其从状态 11(已验证)更改为 2(准备中)。之后订单的名称、交付地址和承运人可以… |
spartoo_ship_order | 将一个已接受的订单标记为已发货,并附上承运人的追踪号码:将其从状态 2 更改为 3,Spartoo 会将追踪链接通过电子邮件发送给… |
spartoo_cancel_order | 取消一个尚未发货的订单(状态 41)。客户不会收到订单,并由 Spartoo 退款;此操作无法撤销… |
spartoo_list_returns | 列出自某时刻以来登记的退货,选项仅列出某一状态的退货。每个退货在 root.returns.return 下:return_id… |
spartoo_get_return | 读取一个订单的退货,或通过其 ID 读取一个退货:退货 ID 和日期、状态 ID 和名称、原因、订单 ID 和退回的产品… |
spartoo_check_product_status | 检查你的某个产品是否在 Spartoo 网站上。返回在 root.products.product 下你的引用、状态(网站上的 OK… |
spartoo_update_stock | 实时设置某产品某尺码的库存。库存为 0 时将该尺码从网站上移除;所有尺码库存为 0 的产品将下线… |
示例提示
- "自周一以来,哪些 Spartoo 订单尚未被接受?"
- "接受订单 90D813EA1A2365A8,并使用皇家邮政追踪 AB123456789GB 发货。"
- "哪些退货正在等待接收?"
- "我的产品 REF-BOOT-221 在线吗?如果没有,为什么?"
- "将 REF-BOOT-221 的尺码 38 的库存设置为 6。"
常见问题
合作伙伴代码来自哪里? 在 Spartoo 市场后台,Documentation,Webservices,任意服务页面:行 partner 显示你的代码,行 Webservice URL 指定你网站的地址。如果未显示代码,请向你的 Spartoo 市场联系人询问。
它涵盖了什么,未涵盖什么? 包含客户和交付详情的订单,接受和发货带有追踪号码的订单,退货,产品状态和每个尺码的库存。它不接受或拒绝退货。要作为购物者搜索 Spartoo 目录,请使用 Spartoo Shop 连接器。
哪些工具默认关闭? spartoo_cancel_order,因为取消会退款给客户且无法撤销。仅在 AI 应该使用时在连接器页面上打开它。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?