TokenLab MCP サーバー

エージェントに必要なものを選択するCopy Anchor Link

• MCP は互換性のあるクライアントに TokenLab API ツールを追加します。まずは以下の API キー不要の catalog セットアップから始めてください。
• TokenLab スキルは、npx skills add を使用して統合手順をインストールしますが、MCP サーバーは起動しません。

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

エージェントにセットアップを任せるCopy Anchor Link

お使いのコンピューターですでに実行されているエージェントに、このタスクをコピーしてください：

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 サーバーを使用すると、MCP クライアントは最新のモデルと価格の参照、モデルリクエストの送信、メディアの作成、ファイルの操作、非同期タスクの確認を行えます。

API キーなしでモデルと価格を参照するには、catalog プロファイルを使用します。クライアントが有料のモデルリクエストまたはメディアリクエストを実行する場合は、TOKENLAB_API_KEY を追加してください。

要件Copy Anchor Link

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

node --version
npx --version

npm パッケージは stdio 経由でローカルに実行されます。グローバルインストールやソースのチェックアウトは不要です。

クライアントが使用できる機能の選択Copy Anchor Link

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

サーバーの追加Copy Anchor Link

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

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

有料ツールの有効化Copy Anchor Link

コンソール → API キーで API キーを作成し、MCP サーバー環境に両方の変数を設定します：

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

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

接続の確認Copy Anchor Link

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

# Claude Code
claude mcp list

# Codex
codex mcp list

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

便利なツールCopy Anchor Link

利用可能なツールは、選択したプロファイルによって異なります。主なタスクは以下のとおりです：

• モデルの一覧表示および特定のモデルの機能の確認
• 現在の TokenLab の価格の確認、または複数のモデルの比較
• Chat Completions、Responses、Anthropic Messages、または Gemini リクエストの送信
• evaluate_decisions による型付きの意思決定の評価
• 画像の作成または編集
• 動画、音楽、3D、音声、文字起こし、または翻訳の作成
• ファイルのアップロードおよび取得
• embedding の作成またはドキュメントの rerank
• サポートされている非同期タスクの確認とキャンセル

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

意思決定モデルCopy Anchor Link

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 の回答はブール値ではなく確率の数値です。利用可能な場合は、_meta からリクエスト ID を保持してください。このツールは同期的に結果を返し、非同期タスクのポーリングフローは使用しません。

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

非同期メディアCopy Anchor Link

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

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

オプション設定Copy Anchor Link

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

トラブルシューティングCopy Anchor Link

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

Streamable HTTP をサポートするクライアントは、以下にある公開モデルエクスプローラーを使用できます：

https://tokenlab-model-explorer.vercel.app/mcp

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

リンクCopy Anchor Link

• TokenLab MCP ページ
• GitHub リポジトリ
• TokenLab API スキル
• モデルカタログ
• API クイックスタート

mt-… Management Token で認証される Webhook 管理 API を使用して、タスク通知を設定します。MCP full では TOKENLAB_MANAGEMENT_TOKEN を使用します。完了状態（terminal）のタスクや、401/403/404 または再試行不可能なエラーが発生した場合は、ポーリングを停止してください。