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 欄位,必須填寫你兩步驟驗證 App 裡當下的 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 對接文件 · 開發者整合
正在載入…