关于 Spree Commerce: open-source B2B and marketplace ecommerce
Spree 后台的 MCP 服务，供 MCP 客户端以自然语言管理商品目录、查询报表和配置商店。工具受 Spree API 密钥的租户及权限规则约束，并由 spree_core 提供。
主要功能
- 01管理商品目录
- 02查询业务报表
- 03管理商店设置
- 04按 API 密钥范围控制工具可见性
- 05复用 spree_core 工具与权限
适用场景
- 01通过 Agent 调整商品陈列
- 02以自然语言询问销售报表
- 03在权限范围内设置商店
MCP 相关
通过 POST /api/v3/admin/mcp 向 MCP 客户端提供 Spree 后台工具，使用 Spree secret API key 认证。凭据的权限范围决定可用工具，工具定义及权限控制位于 spree_core。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://{store_domain}/api/v3/admin/mcpclaude mcp add --transport http spree-ecommerce-b2b-marketplace https://{store_domain}/api/v3/admin/mcp{"mcpServers":{"spree-ecommerce-b2b-marketplace":{"type":"http","url":"https://{store_domain}/api/v3/admin/mcp"}}}在 Cursor 中打开{"servers":{"spree-ecommerce-b2b-marketplace":{"type":"http","url":"https://{store_domain}/api/v3/admin/mcp"}}}在 VS Code 中打开{"mcpServers":{"spree-ecommerce-b2b-marketplace":{"type":"http","url":"https://{store_domain}/api/v3/admin/mcp"}}}{"mcpServers":{"spree-ecommerce-b2b-marketplace":{"serverUrl":"https://{store_domain}/api/v3/admin/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Spree MCP 服务
一个面向 Spree 后台的模型上下文协议服务。任何 MCP 客户端——Claude Code、Cursor 或内部 Agent——都可以使用自然语言管理商品目录、回答报表问题并管理商店设置，同时遵循与 Admin API 相同的租户和权限规则。
spree add mcp # or add gem 'spree_mcp' to the Gemfile
该端点为 POST /api/v3/admin/mcp，通过 Spree 密钥 API 密钥进行身份验证，密钥通过 X-Spree-API-Key: sk_… 或 Authorization: Bearer sk_… 发送。密钥的作用域决定向模型提供哪些工具，因此 Agent 永远不会被告知其凭据不具备的功能。
这个 gem 只是一个协议适配器，仅此而已。工具、工具架构以及控制工具访问的权限都位于 spree_core 中，作为 Spree.admin_agent_tools。这意味着扩展无需依赖这个 gem 即可注册工具，而仪表板助手也可以通过另一种传输方式提供相同的工具。
请参阅文档和 docs/plans/6.0-mcp-server.md。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。