TokenLab

程式工具

Cursor

設定 TokenLab 以支援 Cursor 聊天模型、驗證連線,並分別新增 MCP 或 Skills

此連線的功能

在 macOS、Windows 或 Linux 的 Cursor 桌面編輯器中使用 TokenLab 進行支援的聊天請求。Cursor 針對標準的非推理(non-reasoning)聊天模型提供了 OpenAI BYOK 支援;標籤頁自動補全(Tab completion)仍使用 Cursor 自身的模型。覆寫 OpenAI Base URL 並不會讓 Cursor 變成所有 TokenLab 模型或協定的客戶端。請參閱 Cursor 的 API-key 限制。

如果您只需要 TokenLab 的圖像、影片或其他 API 工具,請保留您目前的聊天提供者,並改為新增 MCP。Skill 會教導 Agent 如何使用這些 API;它不會變更聊天提供者。

將此任務交給您的 Agent

Read https://tokenlab.sh/docs/zh-TW/integrations/cursor and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.

開啟正確的設定

  1. 從 Cursor Downloads 安裝或更新桌面編輯器。本指南不包含 Cursor CLI 或 Cloud Agents 的設定。
  2. 從指令面板開啟 Cursor Settings,或按下 Cmd/Ctrl + Shift + J。Cmd/Ctrl + , 會開啟一般的編輯器設定。
  3. 開啟 Models 並記下您現有的 OpenAI 金鑰與 Base URL 設定,以便日後還原。請保持其他提供者的設定不變。
  4. 在 OpenAI API Key 中,於本地輸入您的 TokenLab 金鑰並儲存。請勿將金鑰貼入 Agent 對話中或提交至專案。
  5. 啟用 Override OpenAI Base URL 並輸入:
https://api.tokenlab.sh/v1

Cursor 會透過其後端發送 BYOK 請求以進行提示詞組裝;這並非從您的編輯器直接連線至 TokenLab。

選擇支援的模型

從目前的 TokenLab catalog 複製確切的模型 ID,並檢查 Cursor 是否透過其 OpenAI BYOK 路徑接受該模型。在 TokenLab 上被列為聊天模型並不代表具備 Cursor 相容性。

若要進行初步文字檢查,請選擇一個非推理模型:其詳細資訊中不會列出 reasoning 能力,且它接受 openai_chat_completions。grok-4.20-non-reasoning 是一個範例;使用前請確認它是否仍被列出。在 Models 中啟用現有項目,若不存在則使用 Add model,然後在聊天選擇器中選取該確切模型。請勿以不同的拼寫重複建立內建模型,也不要假設 Claude 或 Gemini 項目會使用 OpenAI 覆寫設定。Cursor 的自訂模型指南 解釋了這些路由限制。

驗證單一小型請求

使用選定的模型開始新的聊天,並發送:

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

這是一次計費的模型請求。請檢查回覆內容,並在 TokenLab Requests 中確認是否有相符的模型、時間與狀態。僅有儲存的金鑰、可見的模型或回覆,若沒有相符的 TokenLab 請求紀錄,並不能確認此路徑已連線成功。

若連線失敗

  • 模型遺失或被拒絕: 檢查確切的 ID 以及 Cursor 目前的 BYOK 支援情況。若有現成的內建項目,請優先使用;僅靠重新啟動無法使不支援的模型變得相容。
  • 驗證失敗: 在 OpenAI 欄位重新輸入 TokenLab 金鑰並檢查 Base URL。餘額或配額錯誤與無效金鑰不同;請遵循回傳的錯誤訊息以及對應的 TokenLab 請求。
  • 未出現 TokenLab 請求: 確認選定的模型與覆寫設定,然後檢查 Cursor 的錯誤訊息。標籤頁自動補全與其他 Cursor 管理的功能並非連線測試。
  • 其他提供者停止運作: 還原先前的 OpenAI 設定或停用覆寫,然後開始新的聊天。請避免為了修復此路徑而變更不相關的提供者金鑰。

在同一個 Agent 中生成圖像與影片

Cursor 也可以透過 TokenLab MCP server 建立圖像與短影片。每次生成都會從相同的 TokenLab 餘額中扣除。MCP 不會取代主要的聊天模型。請將此儲存為 ~/.cursor/mcp.json,或將 tokenlab 項目合併至您現有的檔案中:

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
      }
    }
  }
}

請在您的電腦上將 <TOKENLAB_API_KEY> 替換為您的金鑰,且不要提交此檔案。檢查 tokenlab 是否已在 Cursor 的 MCP 設定中啟用。然後嘗試:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video 會回傳一個任務 ID。Agent 會呼叫 get_task_status 直到影片準備就緒。

分別新增 API 指令

TokenLab Skills 提供 API 指令。若為專案本地安裝,請將完整的 Skill 目錄保留在 .cursor/skills/tokenlab-api-integration/,包含 SKILL.md 及其參照的檔案。檢查 Customize → Skills 進行探索。Skills 不會提供金鑰或安裝 MCP server。請參閱您所使用 Cursor 版本的官方 MCP 與 Skills 指南。

本頁內容