TokenLab MCP Server

選擇您的 Agent 所需的功能Copy Anchor Link

• MCP 可為相容的用戶端新增 TokenLab API 工具。您可以從下方無需金鑰的 catalog 設定開始。
• TokenLab Skill 透過 npx skills add 安裝整合指示；它不會啟動 MCP 伺服器。

兩者皆為擴充現有的 agent。若要更改其主要模型提供者，請參閱該用戶端專屬的設定指南。

讓我的 Agent 進行設定Copy Anchor Link

將此任務複製到您電腦上已在運行的 agent：

Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/zh-TW/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 用戶端能夠瀏覽目前的模型與價格、發送模型請求、建立多媒體、處理檔案以及檢查非同步任務。

使用 catalog profile 即可在無需 API key 的情況下瀏覽模型和價格。當用戶端需要進行付費的模型或多媒體請求時，請新增 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

在 Console → API keys 建立 API key，然後在 MCP 伺服器環境變數中設定這兩個變數：

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

若您的用戶端具有機密輸入欄位，請善加利用。若真實金鑰出現在共用檔案、螢幕截圖、日誌或 shell 歷史記錄中，請立即撤銷並建立新金鑰。

檢查連線Copy Anchor Link

重新啟動或重新載入 MCP 用戶端，若出現提示請核准本機伺服器，並確認 tokenlab 已連線。

# Claude Code
claude mcp list

# Codex
codex mcp list

讓用戶端呼叫 list_models。若傳回非空白清單，即表示套件已成功啟動並連線至 TokenLab。catalog profile 不需要 API key。

常用工具Copy Anchor Link

工具的可用性取決於所選取的 profile。常見任務包括：

• 列出模型並讀取特定模型的功能
• 讀取目前的 TokenLab 價格或比較多個模型
• 發送 Chat Completions、Responses、Anthropic Messages 或 Gemini 請求
• 使用 evaluate_decisions 評估具型別的決策
• 建立或編輯圖片
• 建立影片、音樂、3D、語音、逐字稿轉錄或翻譯
• 上傳與檢索檔案
• 建立 embedding 或為文件進行 rerank
• 檢查與取消支援的非同步任務

當價格或模型選擇尚未預先確認時，用戶端在進行付費呼叫前應先尋求核准。

決策模型Copy Anchor Link

使用 core 或 full 來呼叫 System One 決策模型。首先以 {"category":"decision"} 呼叫 list_models，並以選定的模型 ID 呼叫 get_model。請將 agent 的主要聊天模型分開設定。

針對 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,000 ms 的情況下，用戶端工具呼叫請預留至少 150,000 ms。若您修改了 TOKENLAB_REQUEST_TIMEOUT_MS，請確保用戶端的逾時時間更長。逾時會導致結果處於不確定狀態；在重新提交付費呼叫之前請先檢查請求。在將決策用於驅動後續操作之前，請先使用您自己的標籤案例進行驗證。

非同步多媒體Copy Anchor Link

影片、音樂與 3D 工具會傳回任務，而非已完成的檔案。圖片工具則取決於模型，可能傳回已完成的結果或任務。

當結果包含非同步 delivery 時，請使用其任務 ID 呼叫 get_task_status，直到狀態變為 complete 或 failed。切勿因單次狀態檢查逾時而建立第二個任務。

選用設定Copy Anchor Link

除非您的用戶端或部署環境有特殊需求，否則請使用預設值。

疑難排解Copy Anchor Link

託管版模型瀏覽器Copy Anchor Link

支援 Streamable HTTP 的用戶端可以使用公開的模型瀏覽器：

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

若要進行付費 API 呼叫、本機檔案上傳，或使用 core 與 full profiles，請使用本機 npm 伺服器。

相關連結Copy Anchor Link

• TokenLab MCP 頁面
• GitHub 儲存庫
• TokenLab API skill
• 模型目錄
• API 快速入門

使用以 mt-… Management Token 進行驗證的 Webhook 管理 API 來設定任務通知。MCP full 使用 TOKENLAB_MANAGEMENT_TOKEN。對於已達終態（terminal）的任務，以及遇到 401/403/404 或不可重試的錯誤時，請停止輪詢。