> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subotiz MCP

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

**了解更多**：了解 Subotiz 产品与能力，请访问 [官网首页](https://www.subotiz.com/)。

## 前置条件

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

## Subotiz MCP 地址

* sandbox 环境：[https://api.sandbox.subotiz.com/mcp](https://api.sandbox.subotiz.com/mcp)
* prod 环境：[https://api.subotiz.com/mcp](https://api.subotiz.com/mcp)

## 对外 MCP 配置

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

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

```json theme={null}
{
  "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。获取步骤与认证方式请参阅 [认证文档](/zh/api/authentication-1)。

***

## 工具列表

完整工具列表（工具名、类别、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）      |

***