コーディングツール
Cursor
サポートされている Cursor チャットモデル用に TokenLab を設定し、接続を確認し、MCP または Skills を個別に追加します
この接続の機能
macOS、Windows、または Linux 上の Cursor デスクトップエディタ で、サポートされているチャットリクエストに TokenLab を使用します。Cursor は、標準的な非推論(non-reasoning)チャットモデルに対する OpenAI BYOK サポートを文書化しています。タブ補完には引き続き Cursor のモデルが使用されます。OpenAI Base URL の上書き設定を行っても、Cursor がすべての TokenLab モデルやプロトコルのクライアントになるわけではありません。Cursor の API キー制限を参照してください。
TokenLab の画像、動画、またはその他の API ツールのみが必要な場合は、現在のチャットプロバイダーを維持したまま、代わりに MCP を追加してください。Skill はエージェントに API の使用方法を教えるものであり、チャットプロバイダーを変更するものではありません。
エージェントにこのタスクを依頼する
Read https://tokenlab.sh/docs/ja/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.正しい設定を開く
- Cursor Downloads からデスクトップエディタをインストールまたは更新します。このガイドでは Cursor CLI や Cloud Agents の設定は行いません。
- コマンドパレットから Cursor Settings を開くか、
Cmd/Ctrl + Shift + Jを押します。Cmd/Ctrl + ,は一般的なエディタ設定を開きます。 - Models を開き、既存の OpenAI キーと Base URL 設定をメモして、後で復元できるようにします。他のプロバイダー設定はそのまま維持してください。
- OpenAI API Key に、お使いの TokenLab キーをローカルで入力して保存します。キーをエージェントとの会話に貼り付けたり、プロジェクトにコミットしたりしないでください。
- Override OpenAI Base URL を有効にし、以下を入力します:
https://api.tokenlab.sh/v1Cursor はプロンプト組み立てのために BYOK リクエストをバックエンド経由で送信します。これはエディタから TokenLab への直接接続ではありません。
サポートされているモデルを選択する
現在の TokenLab カタログ から正確なモデル 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 設定を復元するか、上書き設定を無効にしてから、新しいチャットを開始してください。このルートを修復するために、無関係なプロバイダーのキーを変更することは避けてください。
同じエージェントで画像と動画を生成する
Cursor は TokenLab MCP サーバー を使用して画像や短い動画を作成することもできます。各生成には同じ 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> をご自身のコンピュータ上のキーに置き換え、このファイルをコミットしないでください。Cursor の MCP 設定で tokenlab が有効になっていることを確認してください。その後、以下を試してください:
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 を返します。エージェントは動画の準備ができるまで get_task_status を呼び出します。
API 指示を個別に追加する
TokenLab Skills は API の指示を提供します。プロジェクトローカルへのインストールでは、SKILL.md および参照されるファイルを含め、完全なスキルディレクトリを .cursor/skills/tokenlab-api-integration/ に保持してください。検出については Customize → Skills を確認してください。Skills はキーを提供したり、MCP サーバーをインストールしたりするものではありません。お使いの Cursor バージョンの公式 MCP および Skills ガイドを参照してください。