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.yamlmcp_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.yamlmcpServers: - 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.yamlextensions: 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/crushrcmcp 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 对接文档 · 开发者集成
正在加载…