关于 Swell MCP by usefulapi
Swell MCP by usefulapi 是面向 Swell 商店运营者的托管 MCP 服务,提供产品、订单、客户、购物车和订阅的读写工具,并使用商店凭据进行身份验证。
主要功能
- 01浏览产品和类别
- 02查看订单和客户
- 03检查购物车和订阅
- 04以只读方式查询集合
- 05创建或更新产品和订单
适用场景
- 01核对订单和客户记录
- 02查看商店订阅和发票
- 03添加产品或更新订单
MCP 相关
它向 MCP 客户端提供 Swell 商店数据和操作工具。托管服务通过 OAuth 登录,并使用用户的 Swell 商店 ID 和密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://swell.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-swell https://swell.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-swell":{"type":"http","url":"https://swell.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-swell":{"type":"http","url":"https://swell.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-swell":{"type":"http","url":"https://swell.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-swell":{"serverUrl":"https://swell.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
16| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 分页页码(默认值为 1)。 |
| sort | string | 否 | 排序表达式,例如 "date_created desc" 或 "name asc"。 |
| limit | integer | 否 | 要返回的最大记录数(1–1000,Swell 默认值为 15)。 |
| where | string | 否 | 以 JSON 对象字符串表示的 MongoDB 风格筛选条件,例如 {"active":true,"price":{"$gte":10}}。 |
| expand | string | 否 | 以逗号分隔的要展开的相关字段,例如 "variants,categories"。 |
| fields | string | 否 | 以逗号分隔的要返回字段,例如 "name,price,active"。 |
| search | string | 否 | 在模型的可搜索字段中进行全文搜索。 |
详细介绍
usefulapi 的 Swell MCP
通过 Claude、Cursor 或任何 MCP 客户端管理你的 Swell 无头商务商店——包括商品、订单、客户和订阅。托管服务,无需本地安装——使用 Swell 商店 ID 和密钥连接。
在线端点: https://swell.usefulapi.io/mcp · 主页: https://usefulapi.io/swell
连接
- Claude(claude.ai、Desktop):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://swell.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http swell https://swell.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"swell": {
"url": "https://swell.usefulapi.io/mcp"
}
}
}
只添加 URL。请勿在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Swell 凭据。
分步设置说明、凭据获取位置和常见问题解答:https://usefulapi.io/swell/
首次连接时,你需要粘贴 Swell 商店 ID 和密钥。系统会验证凭据、按用户存储,并将其限定为仅供你使用。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
swell_list_products | read | 列出商品 |
swell_get_product | read | 获取商品 |
swell_list_categories | read | 列出分类 |
swell_list_orders | read | 列出订单 |
swell_get_order | read | 获取订单 |
swell_list_customers | read | 列出客户 |
swell_get_customer | read | 获取客户 |
swell_list_carts | read | 列出购物车 |
swell_list_subscriptions | read | 列出订阅 |
swell_get_subscription | read | 获取订阅 |
swell_list_invoices | read | 列出发票 |
swell_list_coupons | read | 列出优惠券 |
swell_query | read | 查询任意集合(只读) |
swell_create_product | write | 创建商品 |
swell_update_product | write | 更新商品 |
swell_update_order | write | 更新订单 |
swell_usage_status | meta | 使用情况(免费套餐用量计数) |
swell_request_feature | meta | 请求添加缺失功能 |
swell_upgrade | meta | 升级到 Pro(无限量*) |
swell_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前征求确认);meta 工具用于报告用量、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限制 |
|---|---|---|
| Free | $0 | 每月 50 次工具调用 |
| Pro | $9/mo 或 $90/yr(免费送 2 个月) | 无限量* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 swell_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 swell_cancel_subscription 取消:Pro 会持续到已付费周期结束,当前周期不予退款;在此之前运行 swell_upgrade 可撤销取消操作。你也可以发送邮件至 [email protected]。
许可证
MIT — 参见 LICENSE。仅包含文档;服务由托管方提供。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。