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 が必要で、1 回・1 日の上限が適用されます
  • 接続元 IP の許可リスト、有効期限、既定で毎分 120 回(最大 600 回)の呼び出し制限
  • 3 つのリソース(機能一覧、アカウント概要、使い方)と 3 つのプロンプト(アカウント診断、支出レポート、期限チェック)
  • エラー:401 認証情報が無効、403 接続元またはアカウント状態が不可、405 POST 以外、413 リクエストが大きすぎる
  • 認証情報を作成する前に「MCP 接続サービス利用規約」への同意が必要です。お客様の名義で送られた内容と操作の責任はお客様にあります
  • 課金と取り消せない操作に加え、コールバック URL の変更、公開投稿、バケットの公開アクセスなどの重要な設定にもワンタイムコードが必要です。AI による投稿、サポートへのメッセージ、メール送信、Telegram のリアルタイム取得にはアカウント単位の回数上限があり、投稿とサポートへのメッセージは重複した内容が拒否され、サポートへのメッセージには「AI アシスタント経由」と表示されます

POST /api/mcp/rpc

3 種類の認証情報は、それぞれ独立

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 連携」ページに、あなたのアカウントで使える接続先が表示されます。そのままコピーできます。

  • 接続先 — すべてのリクエストをこの 1 つの URL に送ります。
  • トランスポート — 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 クライアントはそれをもとにツールを選びます。

参照:読み取りのみ。書き込み:元に戻せる変更(メモの編集など)。課金:残高から差し引く。取り消し不可:実行すると元に戻せない(キーの削除、カードの解約など)。課金と取り消し不可のツールにはワンタイムコードが必要です(次の節)。さらに、元に戻せてもその場での確認が必要な重要設定(コールバック URL の変更、公開投稿、バケットの公開アクセスなど)にもワンタイムコードが必要です。コンソールで機能を選ぶとき、これらには「コード必須」と表示されます。

ワンタイムコード

課金と取り消し不可のツールには totp_code パラメーターが追加され、認証アプリに表示されている現在の 6 桁コードを入れる必要があります。AI はこのコードを取得できないため、必要なときにあなたに尋ねます。「コード必須」と表示されたツールも同様です。

  • 各コードは一度しか使えません。コンソールで使ったばかりのコードは MCP でも使えません。
  • アカウントで 2 段階認証が有効になっていない場合、これらのツールは常に拒否され、コンソールで有効にするよう案内します。
  • コードの確認は他のどの手順よりも先に行うため、間違ったコードで 1 日の支払い枠が減ることはありません。

支払い上限

課金を伴う呼び出しは、次の 4 つの手順を順に通ります。どれか一つでも通らなければ、お金は引かれません。

confirmed_total_usd

課金を伴うツールの多くは confirmed_total_usd を必要とします。AI があなたに提示し、あなたが同意した合計金額です。実行時の実際の価格がこれを上回る場合は実行せず、AI が新しい価格を改めて伝えます。

失敗したときの枠の扱い

実行に失敗し、請求されていないことが確実な場合は、確保した枠を戻します。請求の結果を確認できない場合は枠を戻さず、実際に発生したかもしれない支払いが集計から消えないようにします。実際の請求額は明細でご確認ください。

回数制限と代理送信される内容

認証情報ごとの呼び出し回数に加えて、AI が内容を書き込む機能と Telegram にリアルタイムで問い合わせる機能には、アカウント単位の上限があります。同じアカウントのすべての認証情報で共有し、毎日 UTC+8 0 時にリセットされます。上限を超えた呼び出しは拒否され、AI に停止を促します。コミュニティの投稿とサポートへのメッセージは、10 分以内にまったく同じ内容を再送すると拒否されます。メールは内容ではなく idempotency_key で重複を防ぎます。コンソールで機能を選ぶとき、これらには「回数制限」と表示されます。

お客様の名義で送られる内容

対応する機能を有効にすると、AI はお客様の名義でコミュニティへの投稿・返信、サポートへのメッセージ送信、SMTP アカウントからのメール送信ができます。これらの内容はお客様ご本人のものとして扱われ、責任はお客様にあります。

リソースとプロンプト

ツールのほかに、サーバーは 3 つの読み取り専用リソースと 3 つのプロンプトを提供しており、クライアントから直接使えます。

  • 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(Web / デスクトップ) — 画面でアドレスを入力し、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 のままか、2 段階認証が有効か、1 日の枠を使い切っていないかの 3 点を確認してください。

関連ページ: AI アシスタントに Tovanix アカウントを任せる · API 連携ドキュメント · 開発者向け連携

読み込み中…