TokenLab

程式工具

TokenLab MCP Server

讓 Claude Code、Cursor、VS Code、Codex 及其他 MCP 客戶端能夠存取 TokenLab 模型與 API

選擇您的 Agent 所需的功能

  • MCP 將 TokenLab API 工具新增至相容的客戶端。請從下方免金鑰的 catalog 設定開始。
  • TokenLab Agent Skills 可教導 Agent 執行結果的方法,例如如何選擇模型以及如何檢查輸出。它們不會啟動 MCP 伺服器,但當兩者皆安裝時,它們可以使用這些 MCP 工具。

安裝模型選擇器 Skill:npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker

GitHub 上的 tokenlab-skills。

兩者皆可擴充現有的 Agent。若要變更其主要模型提供者,請使用該客戶端專屬的設定指南。

讓我的 Agent 進行設定

將此任務複製到您電腦上正在執行的 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 設定檔可在無需 API 金鑰的情況下瀏覽模型與價格。當客戶端需要進行付費模型或媒體請求時,請加入 TOKENLAB_API_KEY。

請將您的 TokenLab API 金鑰保留在 MCP 伺服器環境中。切勿將其貼上至提示詞 (prompt) 或工具參數中。

需求

安裝 Node.js 18.17 或更新版本,並確保 npx 可用:

node --version
npx --version

此 npm 套件透過 stdio 在本地執行。您不需要全域安裝或下載原始碼。

選擇客戶端可使用的功能

設定檔API 金鑰包含內容
catalog不需要模型列表、模型詳細資訊、價格、比較及 API 概覽
core付費呼叫需要常見的聊天、決策、媒體、音訊、檔案、任務、嵌入 (embedding)、重排序 (rerank) 及翻譯工具
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,並透過您慣用的密鑰管理方式儲存金鑰。針對單一專案請使用 --scope local。切勿在共用的 .mcp.json 中提交真實金鑰。

啟用付費工具

在 Console → API keys 建立 API 金鑰,然後在 MCP 伺服器環境中設定這兩個變數:

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

若您的客戶端有提供密鑰輸入功能,請使用該功能。如果真實金鑰出現在共用檔案、螢幕截圖、日誌或 Shell 歷史記錄中,請立即撤銷並建立新金鑰。

檢查連線

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

# Claude Code
claude mcp list

# Codex
codex mcp list

請客戶端呼叫 list_models。若回傳非空列表,即確認套件已啟動並成功連線至 TokenLab。catalog 設定檔不需要 API 金鑰。

實用工具

工具的可用性取決於所選的設定檔。常見任務包括:

  • 列出模型並讀取單一模型的功能
  • 讀取目前的 TokenLab 價格或比較多個模型
  • 發送聊天完成 (Chat Completions)、回應、Anthropic 訊息或 Gemini 請求
  • 使用 evaluate_decisions 評估類型化決策
  • 建立或編輯影像
  • 建立影片、音樂、3D、語音、轉錄或翻譯
  • 上傳與擷取檔案
  • 建立嵌入或重排序文件
  • 檢查並取消支援的非同步任務

當價格或模型選擇尚未確認時,客戶端應在進行付費呼叫前請求核准。

MCP 檔案工具使用與 OpenAI 相容的 /v1/files API。Gemini Files、可恢復上傳及 cachedContents 目前需要 HTTP 呼叫,未包含在 MCP 設定檔中。請參閱 Gemini Files and cache。

決策模型

使用 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 答案是一個機率數值,而非布林值。若可用,請保留來自 _meta 的請求 ID。該工具會回傳同步結果;它不使用非同步任務輪詢流程。

預設伺服器請求逾時為 120,000 毫秒,請至少預留 150,000 毫秒給客戶端工具呼叫。如果您變更了 TOKENLAB_REQUEST_TIMEOUT_MS,請確保客戶端逾時設定更長。逾時會導致結果不確定;在重新提交付費呼叫前,請先檢查該請求。在使用決策驅動行動前,請先針對您自己的標記案例驗證決策。

非同步媒體

影片、音樂與 3D 工具會回傳任務而非完成的檔案。影像工具可能會根據模型回傳完成的結果或任務。

當結果包含非同步 delivery 時,請使用其任務 ID 呼叫 get_task_status,直到狀態顯示完成或失敗。請勿因為狀態檢查逾時而建立第二個任務。

選項設定

變數預設值用途
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_DIR作業系統暫存目錄儲存大型下載檔案的位置

除非您的客戶端或部署有特定需求,否則請使用預設值。

疑難排解

託管模型瀏覽器

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

https://mcp.tokenlab.sh/mcp

請使用本地 npm 伺服器進行付費 API 呼叫、本地檔案上傳或使用 core 與 full 設定檔。

連結

使用 Webhook 管理 API 設定任務通知,並使用 mt-… 管理權杖進行驗證。MCP full 使用 TOKENLAB_MANAGEMENT_TOKEN。若遇到 401/403/404 或不可重試的錯誤,請停止輪詢終端任務。

本頁內容