Tovanix
Tovanix

MCP 接入

把 Tovanix 账户接入支持 MCP 的 AI 客户端。接入地址 https://tovanix.com/api/mcp/rpc,Streamable HTTP 无会话,只接受 POST。

  • 认证:Authorization: Bearer <凭据>,也可改用 X-MCP-Key 请求头;凭据以 mcp_live_ 开头,只显示一次
  • 授权:能力默认全部关闭、逐条开启,tools/list 只返回开启的能力;工具名为 tovanix_ 加能力名
  • 扣费与不可逆操作需要 totp_code 动态验证码,并受单次 / 单日消费上限约束
  • 来源 IP 白名单、有效期、每分钟 120 次的默认调用频率(最高 600)
  • 三个资源(能力目录、账户概览、平台须知)与三个预设提示(账户体检、消费报告、到期检查)
  • 错误码:401 凭据无效、403 来源或账户状态不允许、405 非 POST、413 请求过大
  • 创建凭据前必须阅读并同意《MCP 接入服务协议》,以你的名义发出的内容与操作由你负责
  • 除扣费与不可逆操作外,改回调地址、公开发帖、开启存储桶公开访问等关键设置同样需要动态验证码;AI 发帖、发客服消息、发邮件与实时读取 Telegram 另有按账户计的频率上限,帖子与客服消息还会拦截重复内容,发给客服的消息会标注「经 AI 助手发送」

POST /api/mcp/rpc

三套凭据,各管各的

MCP(Model Context Protocol)让 Claude 等 AI 客户端以「工具」的形式调用你的 Tovanix 账户能力。你在控制台为每个客户端创建一把 MCP 凭据,逐条开启它能使用的能力;客户端拿着凭据连到接入地址,就能在对话里查数据、办业务。

MCP 有自己专用的接入地址与凭据,和开放 API、控制台登录互相独立:删除 MCP 凭据不会影响你正在运行的开放 API 集成,反之亦然。

  • 开放 API /api/v1/* — API 密钥(X-API-Key / 签名) — 你自己写的程序 — 按密钥设置的能力
  • MCP /api/mcp/rpc — MCP 凭据(Bearer) — AI 客户端 — 一项都不开放,逐条开启
  • 控制台 — 登录会话 — 你本人 — 账户全部功能

快速接入

支持 Streamable HTTP 并能设置请求头的 MCP 客户端都可以接入。在下方选择你用的工具,复制对应的命令或配置即可。

用 curl 直接调用 tools/list 也能验证凭据:本服务是无会话的,不需要先发 initialize。

平台只保存凭据的哈希,丢失后无法找回,只能删除后重新创建。请把它保存在客户端的配置里,不要写进公开仓库、截图或聊天记录。

接入地址与认证

控制台「MCP 接入」页显示的就是你账号可用的接入地址,可以直接复制。

  • 接入地址 — 所有请求都发到这一个地址。
  • 传输方式 — Streamable HTTP,无会话:每个请求单独鉴权,只接受 POST,不返回 Mcp-Session-Id;GET 与 DELETE 返回 405。
  • 认证 — Authorization: Bearer <凭据>。如果客户端只能填写自定义请求头、不能改 Authorization,可以改用 X-MCP-Key: <凭据>。
  • 协议版本 — 2025-06-18(最新)、2025-03-26、2024-11-05。按客户端在 initialize 中报的版本协商,不支持的版本回落到最新版本。
  • 报文 — JSON-RPC 2.0,单个请求体不超过 1 MB。旧版客户端发送的批量请求最多 32 条。
  • 浏览器请求 — 带 Origin 请求头且不是平台自身站点的请求会被拒绝(防 DNS 重绑定)。桌面与命令行客户端不带 Origin,不受影响。

凭据与授权

凭据以 mcp_live_ 开头,共 73 个字符。每把凭据单独设置下面这些项目,控制台里可以随时修改;凭据过期或被停用后立即失效。

创建凭据前必须阅读并同意《MCP 接入服务协议》。协议写明了 AI 操作账户的风险与责任:通过 MCP 发生的操作与损失由你自行承担。平台没有发布协议时无法创建凭据;协议更新后,新建凭据需要重新同意,已有凭据可以继续使用。

账户处于受限状态时,MCP 只放行查询类能力,写入、扣费与不可逆的操作会被拒绝,提示用户到控制台查看原因。账户被冻结时所有请求返回 403。

工具与命名

工具名 = tovanix_ + 能力名(点号换成下划线)。例如能力 account.balance.get 对应的工具是 tovanix_account_balance_get。

tools/list 只返回这把凭据开启了的能力。每个工具的说明里写了什么时候该用它、参数含义与注意事项,AI 客户端据此选择工具。

查询:只读。写入:可撤回的修改,例如改备注。扣费:从余额扣钱。不可逆:做了就拿不回来,例如删除密钥、销卡。扣费与不可逆的工具需要动态验证码(见下一节)。此外,改回调地址、公开发帖、开启存储桶公开访问这类能撤回、但需要你当场确认的关键设置,同样需要动态验证码;控制台勾选能力时,这类会标「需验证码」。

动态验证码

扣费与不可逆的工具,参数里会多一个 totp_code 字段,必须填写你两步验证应用里当前的 6 位动态码。AI 拿不到这个码,需要时会向你索要。标了「需验证码」的工具同样如此。

  • 每个码只能使用一次。控制台刚用过的码,在 MCP 里也不能再用。
  • 账户没有开启两步验证时,这类工具一律拒绝执行,并提示到控制台开启。
  • 验证码校验排在所有步骤之前:填错不会占用当日消费额度。

消费上限

每次扣费类调用依次经过下面四步,任何一步不通过就不会扣钱。

confirmed_total_usd

多数扣费工具要求传入 confirmed_total_usd:AI 向你报出、并得到你确认的总价。执行时的实际价格高于它,本次就不执行,AI 会把新价格重新告诉你。

失败时额度怎么处理

执行失败、并且可以确认没有扣款时,预扣的额度退回;扣款结果无法确认时额度保留,避免一笔可能已经发生的支出从额度里消失。实际扣了多少,以账单为准。

频率限制与代发内容

除了每把凭据自己的调用频率,AI 写入内容和实时请求 Telegram 的能力另有按账户计算的上限:同一账户下的所有凭据共用,每天按 UTC+8 零点重置。超出时调用会被拒绝,并提示 AI 停下;社区内容和客服消息在 10 分钟内重复提交完全相同的内容也会被拒绝;邮件不按内容去重,防重复靠幂等键。控制台勾选能力时,这类会标「限频」。

以你的名义发出的内容

开启相应能力后,AI 可以以你的名义发帖、回帖、给在线客服发消息、用你的 SMTP 账户发邮件。这些内容代表你本人,由你负责:

资源与预设提示

除了工具,服务端还提供三个只读资源(resources)和三个预设提示(prompts),客户端可以直接引用。

  • tovanix://catalog — 能力目录:全部板块与能力,以及这把凭据开启了哪些。AI 遇到「无权限」或被问「你能做什么」时读它。
  • tovanix://account/overview — 账户概览:账户状态、已开通的业务、这把凭据的授权与当日额度使用情况。余额只在开启了「查询账户余额」时显示。
  • tovanix://guide — 平台使用须知:金额与币种口径、订单状态、下单前要确认什么。
  • account_health — — — 账户体检:余额、各业务的订阅与到期、异常订单,给出待处理事项。
  • spend_report — days,默认 30 — 消费报告:按业务汇总近期账单与花费。
  • renewal_check — within_days,默认 14 — 到期检查:列出即将到期的服务与续费金额,不会自动续费。

错误与排障

连接与鉴权问题以 HTTP 状态码返回;业务上的失败以工具结果返回(isError: true),文字是写给 AI 的下一步指引,例如「请向用户索要动态验证码」「余额不足,请让用户先充值」。

在各 AI 工具中接入 Tovanix MCP

把 <YOUR_MCP_CREDENTIAL> 换成你在控制台创建的 MCP 凭据。

  • Claude Code — 在终端执行
    claude mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Codex — 配置文件: ~/.codex/config.toml
    [mcp_servers.tovanix]
    url = "https://tovanix.com/api/mcp/rpc"
    bearer_token_env_var = "TOVANIX_MCP_CREDENTIAL"
  • Cursor — 配置文件: ~/.cursor/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • GitHub Copilot (VS Code) — 配置文件: .vscode/mcp.json
    {
      "servers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer ${input:tovanix-credential}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "tovanix-credential",
          "description": "Tovanix MCP credential",
          "password": true
        }
      ]
    }
  • Gemini CLI — 配置文件: ~/.gemini/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "httpUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • OpenCode — 配置文件: ~/.config/opencode/opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Qwen Code — 在终端执行
    qwen mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Kimi Code CLI — 配置文件: ~/.kimi-code/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • CodeBuddy Code — 在终端执行
    codebuddy mcp add --scope user --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc
  • Qoder CLI — 配置文件: ~/.qoder/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamable-http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kiro — 配置文件: ~/.kiro/settings/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae — 配置文件: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CN — 配置文件: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CLI — 配置文件: trae_cli.yaml
    mcp_servers:
      - name: "tovanix"
        url: "https://tovanix.com/api/mcp/rpc"
        type: "http"
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
  • GitHub Copilot CLI — 配置文件: ~/.copilot/mcp-config.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          },
          "tools": [
            "*"
          ]
        }
      }
    }
  • Cline — 配置文件: cline_mcp_settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamableHttp",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kilo Code — 配置文件: ~/.config/kilo/kilo.jsonc
    {
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Continue — 配置文件: ~/.continue/config.yaml
    mcpServers:
      - name: tovanix
        type: streamable-http
        url: https://tovanix.com/api/mcp/rpc
        requestOptions:
          headers:
            Authorization: Bearer <YOUR_MCP_CREDENTIAL>
  • Zed — 配置文件: ~/.config/zed/settings.json
    {
      "context_servers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Junie — 配置文件: ~/.junie/mcp/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Amp — 配置文件: ~/.config/amp/settings.json
    {
      "amp.mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Goose — 配置文件: ~/.config/goose/config.yaml
    extensions:
      tovanix:
        enabled: true
        type: streamable_http
        name: tovanix
        uri: https://tovanix.com/api/mcp/rpc
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
        timeout: 300
  • Augment (Auggie) — 在终端执行
    auggie mcp add tovanix --transport http --url https://tovanix.com/api/mcp/rpc --header "Authorization:Bearer <YOUR_MCP_CREDENTIAL>"
  • Factory Droid — 在终端执行
    droid mcp add tovanix https://tovanix.com/api/mcp/rpc --type http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" --no-oauth
  • Crush — 配置文件: ~/.config/crush/crushrc
    mcp add tovanix --type http --url https://tovanix.com/api/mcp/rpc --header Authorization "Bearer <YOUR_MCP_CREDENTIAL>"
  • Warp — 在设置界面中粘贴
    {
      "tovanix": {
        "url": "https://tovanix.com/api/mcp/rpc",
        "headers": {
          "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
        }
      }
    }
  • Windsurf — 配置文件: ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "tovanix": {
          "serverUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Claude 网页 / 桌面版 — 在界面中填写地址,并添加 Authorization 请求头(Bearer + 凭据)
    https://tovanix.com/api/mcp/rpc
  • LM Studio — 配置文件: mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Dify — 在界面中填写地址,并添加 Authorization 请求头(Bearer + 凭据)
    https://tovanix.com/api/mcp/rpc
  • 扣子 Coze — 在界面中填写地址,并添加 Authorization 请求头(Bearer + 凭据)
    https://tovanix.com/api/mcp/rpc
  • n8n — 在界面中填写地址,并添加 Authorization 请求头(Bearer + 凭据)
    https://tovanix.com/api/mcp/rpc
  • 其他支持 MCP 的工具 — 在设置界面中粘贴
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }

常见问题

tools/list 返回空列表怎么办?

说明这把凭据还没有开启任何能力。到控制台「MCP 接入」里勾选需要的能力后重新连接即可。

扣费工具一直被拒绝是什么原因?

检查三件事:这把凭据的消费上限是否还是默认的 0、账户是否开启了两步验证、当日额度是否已经用完。

相关页面: 让 AI 助手直接打理你的 Tovanix 账户 · API 对接文档 · 开发者集成

正在加载…