关于 Synchronity
Synchronity 通过托管的商业网关连接 AI 助手与网店。购物者可查找和比较商品、管理购物车并在敏感步骤获得批准后购买;商家可接入 WooCommerce 网店。
主要功能
- 01搜索商品并查看详情
- 02跨网店比较商品
- 03管理购物车并追踪订单
- 04经买家批准后结账
- 05接入 WooCommerce 网店
适用场景
- 01在已连接的网店中找商品
- 02购买前比较不同店铺的商品
- 03查看并更新购物车
- 04接入 WooCommerce 商品目录
MCP 相关
其 MCP 服务向 MCP 客户端提供购物工具,并连接托管的 Synchronity 网关。结账和支付需要买家批准。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.synchronity.app/mcpclaude mcp add --transport http themewireco-synchronity https://api.synchronity.app/mcp{"mcpServers":{"themewireco-synchronity":{"type":"http","url":"https://api.synchronity.app/mcp"}}}在 Cursor 中打开{"servers":{"themewireco-synchronity":{"type":"http","url":"https://api.synchronity.app/mcp"}}}在 VS Code 中打开{"mcpServers":{"themewireco-synchronity":{"type":"http","url":"https://api.synchronity.app/mcp"}}}{"mcpServers":{"themewireco-synchronity":{"serverUrl":"https://api.synchronity.app/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
26此工具无需参数。
详细介绍
Synchronity
借助 AI 在线购买任何商品——通过任意 AI 助手,在已连接的商店中搜索、比较并购买。
Synchronity 是面向 AI 助手的电商基础设施。它连接到托管的 Synchronity 网关 https://api.synchronity.app,无需自托管。
此仓库包含采用 MIT 许可证的公开组件:
| 部分 | 说明 |
|---|---|
packages/mcp | MCP 服务——向 Claude、Cursor 和任意 MCP 客户端提供购物工具 |
packages/sdk | MCP 服务使用的类型化网关客户端 |
desktop-extension | Claude Desktop 扩展(.mcpb)源代码——无需依赖即可连接网关 |
plugins/synchronity | 跨助手插件(Claude Code + Codex)——通过下方的市场安装 |
woocommerce | Synchronity WooCommerce 插件——让商店能够接入 Agent |
发布版本附带预构建的安装包:
synchronity.mcpb桌面扩展和 WooCommerce 插件 zip。请参阅发布版本。
面向购物者——连接你的 AI 助手
Claude Desktop(最简单)
- 从最新发布版本(或从 api.synchronity.app/setup/download)下载
synchronity.mcpb。 - 使用 Claude Desktop 打开它,然后点击 安装。
- 让 Claude 帮你购物,例如 “在 Synchronity 中搜索无线键盘。”
Claude Code(插件市场)
/plugin marketplace add themewireco/synchronity
/plugin install synchronity@synchronity
然后就可以开始购物了——“帮我从我的商店找一个生日蛋糕”。该插件打包了
synchronity-commerce 技能,并通过 npx 在本地运行 MCP 服务,因此
无需克隆或构建。
Codex
从此仓库(plugins/synchronity)添加 Synchronity 插件。Codex
会读取 .codex-plugin/plugin.json,并连接到托管的 MCP 服务
https://api.synchronity.app/mcp,使用相同的 synchronity-commerce 技能。
任意 MCP 客户端(手动配置)
npm install && npm run build
{
"mcpServers": {
"synchronity": {
"command": "node",
"args": ["/absolute/path/to/synchronity/packages/mcp/dist/index.js"],
"env": { "GATEWAY_URL": "https://api.synchronity.app" }
}
}
}
GATEWAY_URL 默认为 https://api.synchronity.app。敏感操作(结账、付款)需要买家批准——助手会引导你完成一次性批准步骤。
助手可以做什么
搜索商品并查看详情(含内嵌图片)、跨商店比较、查看评论、管理购物车、配送、结账、银行卡/移动支付、追踪订单,以及在敏感操作中请求真人参与并批准。
面向商家——让你的 WooCommerce 商店能够接入 Agent
- 从最新发布版本下载 WooCommerce 插件 zip。
- 在 WordPress 中:插件 → 安装新插件 → 上传插件,选择 zip,然后点击安装并启用。
- 打开 WooCommerce → Synchronity,复制你的连接器密钥,并向 Synchronity 注册你的商店。
你的商店保留自己的商品目录、货币、配送和订单——Synchronity 通过网关将 Agent 请求路由到商店。
自行构建安装包
npm run build # build the MCP server + client
npm run build:mcpb # -> synchronity.mcpb (Claude Desktop extension)
npm run build:plugin # -> synchronity-woocommerce-v<version>.zip
配置
| 环境变量 | 默认值 | 用途 |
|---|---|---|
GATEWAY_URL | https://api.synchronity.app | Synchronity 网关基础 URL |
DEFAULT_SITE_ID | — | 可选的默认商店,用于限定工具的作用范围 |
DEBUG | false | 将详细日志输出到 stderr |
审核与测试
初次使用或正在审核连接器?请按照端到端操作指南:docs/reviewer-testing.md。
隐私与支持
许可证
MIT © Themewire——请参阅 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。