コーディングツール

TokenLab MCP Server

Claude Code、Cursor、VS Code、Codex、およびその他のMCPクライアントからTokenLabのモデルやAPIにアクセスできるようにします

エージェントに必要な機能を選択する

  • MCPは、互換性のあるクライアントにTokenLab APIツールを追加します。まずは以下のキー不要な catalog 設定から始めてください。
  • TokenLab Agent Skills は、どのモデルを選択すべきか、出力をどのように確認するかといった、結果を得るための手法をエージェントに教えます。これらはMCPサーバーを起動するものではありませんが、両方がインストールされている場合はこれらのMCPツールを使用できます。

モデルピッカーSkillをインストールする: npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker

GitHubのtokenlab-skills。

どちらも既存のエージェントを拡張するものです。メインのモデルプロバイダーを変更する場合は、そのクライアントのセットアップガイドを使用してください。

エージェントに設定させる

以下のタスクを、コンピュータ上で実行中のエージェントにコピーしてください:

Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/ja/integrations/tokenlab-mcp-server
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

TokenLab MCP Server を使用すると、MCPクライアントから現在のモデルや価格の閲覧、モデルリクエストの送信、メディア作成、ファイルの操作、非同期タスクの確認が可能になります。

APIキーなしでモデルや価格を閲覧するには catalog プロファイルを使用してください。クライアントが有料のモデルリクエストやメディアリクエストを行う必要がある場合は、TOKENLAB_API_KEY を追加してください。

TokenLab APIキーはMCPサーバーの環境変数内に保持してください。プロンプトやツールの引数には絶対に貼り付けないでください。

要件

Node.js 18.17以降をインストールし、npx が使用可能であることを確認してください:

node --version
npx --version

npmパッケージはローカルでstdioを介して実行されます。グローバルインストールやソースコードのチェックアウトは不要です。

クライアントが使用できる機能を選択する

プロファイルAPIキー含まれる機能
catalog不要モデル一覧、モデル詳細、価格、比較、API概要
core有料呼び出しに必要一般的なチャット、意思決定、メディア、音声、ファイル、タスク、埋め込み、再ランク、翻訳ツール
full有料呼び出しに必要core に加え、追加の開発者向けAPI

モデル選択を改善したいだけの場合は catalog から始めてください。クライアントがコンテンツを作成したりモデルを呼び出したりする必要がある場合は core を使用します。full は、より広範なツールセットを必要とするクライアント向けです。

サーバーを追加する

アクティブな設定をバックアップしてください。TokenLabのエントリのみを追加し、既存のプロバイダー、アカウント、デフォルトモデルの選択、権限設定は保持してください。名前が既に使用されている場合は、別の名前を選択してコマンドを更新してください。セットアップを取り消すには、追加したエントリのみを削除するか、以前のバックアップを復元してください。

ユーザーアカウント用にパブリックカタログを追加します:

claude mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=catalog \
  --scope user \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

有料ツールを使用するには、プロファイルの環境変数を TOKENLAB_API_KEY に置き換え、通常のシークレット管理方法でキーを保存してください。1つのプロジェクトのみで使用する場合は --scope local を使用してください。共有の .mcp.json に本物のキーをコミットしないでください。

有料ツールを有効にする

Console → API keys でAPIキーを作成し、MCPサーバーの環境変数に両方の変数を設定してください:

{
  "env": {
    "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
    "TOKENLAB_MCP_TOOL_PROFILE": "core"
  }
}

クライアントにシークレット入力機能がある場合はそれを使用してください。共有ファイル、スクリーンショット、ログ、またはシェル履歴に本物のキーが表示された場合は、そのキーを無効化し、新しいキーを作成してください。

接続を確認する

MCPクライアントを再起動またはリロードし、プロンプトが表示されたらローカルサーバーを承認し、tokenlab が接続されていることを確認してください。

# Claude Code
claude mcp list

# Codex
codex mcp list

クライアントに list_models を呼び出すよう指示してください。空ではないリストが表示されれば、パッケージが起動しTokenLabに到達していることが確認できます。catalog プロファイルではAPIキーは不要です。

便利なツール

ツールの利用可否は選択したプロファイルに依存します。一般的なタスクには以下が含まれます:

  • モデルの一覧表示と特定のモデルの機能の読み取り
  • 現在のTokenLab価格の読み取り、または複数のモデルの比較
  • チャット補完、応答、Anthropicメッセージ、またはGeminiリクエストの送信
  • evaluate_decisions を使用した型付き意思決定の評価
  • 画像の作成または編集
  • 動画、音楽、3D、音声、文字起こし、または翻訳の作成
  • ファイルのアップロードと取得
  • 埋め込みの作成またはドキュメントの再ランク
  • サポートされている非同期タスクの確認とキャンセル

価格やモデルの選択がまだ確定していない場合、クライアントは有料呼び出しの前に承認を求める必要があります。

MCPのファイルツールはOpenAI互換の /v1/files APIを使用します。Gemini Files、再開可能なアップロード、および cachedContents は現在HTTP呼び出しを必要とするため、MCPプロファイルには含まれていません。Gemini Files and cache を参照してください。

意思決定モデル

System One意思決定モデル を呼び出すには core または full を使用してください。まず {"category":"decision"} を指定して list_models を呼び出し、次に選択したモデルIDで get_model を呼び出します。エージェントのメインチャットモデルは別途設定したままにしてください。

Jev 1.13の場合は、ネイティブの state と questions を指定してツールを呼び出します:

{
  "name": "evaluate_decisions",
  "arguments": {
    "model": "jev-1.13",
    "state": { "ticket": "Please refund the duplicate payment." },
    "questions": {
      "refund_requested": {
        "type": "noul",
        "instructions": "Does the customer explicitly request a refund?"
      }
    }
  }
}

isError を確認し、structuredContent.answers と structuredContent.usage を読み取ってください。Noulの回答はBooleanではなく確率数値です。可能な場合は _meta からリクエストIDを保持してください。このツールは同期的な結果を返します。非同期タスクのポーリングフローは使用しません。

デフォルトの120,000msのサーバーリクエストタイムアウトに対し、クライアントのツール呼び出しには少なくとも150,000msの猶予を持たせてください。TOKENLAB_REQUEST_TIMEOUT_MS を変更する場合は、クライアントのタイムアウト時間をそれより長く設定してください。タイムアウトが発生すると結果が不確実になるため、有料呼び出しを再送信する前にリクエストを確認してください。意思決定をアクションの実行に使用する前に、独自のラベル付きケースで検証してください。

非同期メディア

動画、音楽、および3Dツールは、完成したファイルではなくタスクを返します。画像ツールは、モデルに応じて完了した結果またはタスクのいずれかを返します。

結果に非同期の delivery が含まれている場合は、ステータスが完了または失敗になるまで、タスクIDを指定して get_task_status を呼び出してください。ステータスチェックがタイムアウトしたからといって、2つ目のタスクを作成しないでください。

オプション設定

変数デフォルト用途
TOKENLAB_API_BASEhttps://api.tokenlab.shカスタムTokenLab APIホスト(末尾のスラッシュは省略)
TOKENLAB_MCP_TOOL_PROFILEcorecatalog、core、または full
TOKENLAB_REQUEST_TIMEOUT_MS120000リクエストのタイムアウト時間(ミリ秒)
TOKENLAB_MCP_MAX_FILE_BYTES104857600ファイルごとの最大ローカルアップロードサイズ
TOKENLAB_ARTIFACT_DIROSの一時ディレクトリ大きなダウンロードファイルを保存する場所

クライアントやデプロイメントに特定の要件がない限り、デフォルト値を使用してください。

トラブルシューティング

ホスト型モデルエクスプローラー

Streamable HTTPをサポートするクライアントは、以下のパブリックモデルエクスプローラーを使用できます:

https://mcp.tokenlab.sh/mcp

有料API呼び出し、ローカルファイルアップロード、または core および full プロファイルには、ローカルのnpmサーバーを使用してください。

リンク

mt-… 管理トークンで認証される Webhook管理API を使用して、タスク通知を設定してください。MCPの full プロファイルは TOKENLAB_MANAGEMENT_TOKEN を使用します。ターミナルタスクのポーリングは、401/403/404エラーや再試行不可能なエラーが発生した時点で停止してください。

このページの内容