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 欄位,必須填寫你兩步驟驗證 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.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 對接文件 · 開發者整合

正在載入…