Subotiz MCP

Subotiz MCP 是基于 Model Context Protocol 的开放工具集服务器。AI 代理可通过标准化 MCP 工具与 Subotiz 支付与订阅能力交互（客户、商品、定价、订阅、交易、退款、发票、Webhook 及开发者文档查询等）。

了解更多：了解 Subotiz 产品与能力，请访问官网首页。

前置条件

支持 Streamable Http MCP 的宿主（如VS Code 1.101+、Claude Desktop、Cursor、Trae 等）
有效的 Subotiz 访问凭证（Token）

Subotiz MCP地址

sandbox环境：https://api.sandbox.subotiz.com/mcp
prod环境：https://api.subotiz.com/mcp

对外 MCP 配置

连接官方托管服务时，只需配置 URL 与 Authorization: Bearer，无需其他请求头。

Cursor 配置示例（写入 Cursor 的 MCP 设置即可）：

{
  "mcpServers": {
    "my-remote-server": {
      "url": "{{MCP_URL}}",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

将 MCP_URL替换为你所需要使用环境的MCP地址，将 YOUR_TOKEN_HERE 替换为你的 Subotiz 访问 Token 即可。在 VS Code、Cursor、Claude Desktop 等宿主中，把上述内容合并到各自的 MCP 配置（如 servers 或 mcpServers）中即可使用。

API Key 获取：配置中的 Token 即 Subotiz API Key。获取步骤与认证方式请参阅认证文档。

工具列表

完整工具列表（工具名、类别、path、说明）在单独文档中维护，便于同步更新:

工具名	类别	path	说明
`create_customer`	客户	POST /api/v1/front/customer/create	创建客户
`list_customer`	客户	GET /api/v1/front/customer	列表查询客户
`list_products`	商品	GET /api/v1/products	列表查询商品
`create_product`	商品	POST /api/v1/products	创建商品
`list_prices`	定价	GET /api/v1/prices	列表查询定价
`create_price`	定价	POST /api/v1/prices	创建定价
`list_subscription`	订阅	GET /api/v1/subscription	列表查询订阅
`list_trades`	交易	GET /api/v1/trades	列表查询交易
`list_refund`	退款	GET /api/v1/trades/:trade_id/refunds	按交易查询退款列表
`list_invoice`	发票	GET /api/v1/invoices	列表查询发票
`list_webhook_event_v2`	Webhook	GET /api/v2/webhook/events	列表查询 Webhook 事件（v2）
`get_llm_full_doc`	开发者文档	-	获取完整 LLM 文档（llm-full.txt）
`get_llm_doc`	开发者文档	-	获取精简 LLM 文档（llm.txt）