mcpField
S
Swell MCP by usefulapi

Swell MCP by usefulapi

远程服务
usefulapi.io商业与营销0今天更新

关于 Swell MCP by usefulapi

Swell MCP by usefulapi 是面向 Swell 商店运营者的托管 MCP 服务,提供产品、订单、客户、购物车和订阅的读写工具,并使用商店凭据进行身份验证。

主要功能

  1. 01浏览产品和类别
  2. 02查看订单和客户
  3. 03检查购物车和订阅
  4. 04以只读方式查询集合
  5. 05创建或更新产品和订单

适用场景

  1. 01核对订单和客户记录
  2. 02查看商店订阅和发票
  3. 03添加产品或更新订单

MCP 相关

它向 MCP 客户端提供 Swell 商店数据和操作工具。托管服务通过 OAuth 登录,并使用用户的 Swell 商店 ID 和密钥。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://swell.usefulapi.io/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

16
参数类型必填说明
pageinteger否分页页码(默认值为 1)。
sortstring否排序表达式,例如 "date_created desc" 或 "name asc"。
limitinteger否要返回的最大记录数(1–1000,Swell 默认值为 15)。
wherestring否以 JSON 对象字符串表示的 MongoDB 风格筛选条件,例如 {"active":true,"price":{"$gte":10}}。
expandstring否以逗号分隔的要展开的相关字段,例如 "variants,categories"。
fieldsstring否以逗号分隔的要返回字段,例如 "name,price,active"。
searchstring否在模型的可搜索字段中进行全文搜索。

详细介绍

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_productsread列出商品
swell_get_productread获取商品
swell_list_categoriesread列出分类
swell_list_ordersread列出订单
swell_get_orderread获取订单
swell_list_customersread列出客户
swell_get_customerread获取客户
swell_list_cartsread列出购物车
swell_list_subscriptionsread列出订阅
swell_get_subscriptionread获取订阅
swell_list_invoicesread列出发票
swell_list_couponsread列出优惠券
swell_queryread查询任意集合(只读)
swell_create_productwrite创建商品
swell_update_productwrite更新商品
swell_update_orderwrite更新订单
swell_usage_statusmeta使用情况(免费套餐用量计数)
swell_request_featuremeta请求添加缺失功能
swell_upgrademeta升级到 Pro(无限量*)
swell_cancel_subscriptionmeta取消 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。仅包含文档;服务由托管方提供。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。