Cursor

利用範囲Copy Anchor Link

対象は macOS、Windows、Linux の Cursor デスクトップエディタです。OpenAI BYOK が公式に対応するのは標準の非推論チャットモデルで、Tab 補完は Cursor のモデルを使います。OpenAI Base URL を変更しても、TokenLab の全モデルや Cursor の全機能が利用できるわけではありません。公式の制限を確認してください。

画像や動画などの API ツールだけが必要なら、現在のチャットプロバイダーを保ったまま MCP を追加できます。Skill は API の使い方を教えるもので、主モデルを変更しません。

既存のエージェントに渡すタスクCopy Anchor Link

https://tokenlab.sh/docs/ja/integrations/cursor を読み、インストール済みの版と OS を確認してください。
TokenLab を主モデル、MCP ツール、API Skill のどれとして使うか確認してください。
既存のアカウント、プロバイダー設定、権限を保持し、変更の戻し方を説明してください。
API キーをチャットで求めないでください。私がローカルで入力し、必要な画面操作を行います。
小さな確認リクエストの費用を説明し、私がそのテストを明示的に選んだ後だけ実行を手伝い、TokenLab の記録と照合してください。

正しい設定画面を開くCopy Anchor Link

1. 公式サイトからデスクトップ版をインストールまたは更新します。本手順は CLI や Cloud Agents 用ではありません。
2. コマンドパレットから Cursor Settings を開くか、Cmd/Ctrl + Shift + J を押します。Cmd/Ctrl + , はエディタの一般設定です。
3. Models で既存の OpenAI キーと Base URL の設定を控え、ほかのプロバイダーは保持します。
4. OpenAI API Key に TokenLab キーをローカルで入力して保存します。チャットに貼り付けたり、git にコミットしたりしないでください。
5. Override OpenAI Base URL を有効にし、次を入力します。

https://api.tokenlab.sh/v1

BYOK リクエストもプロンプト構築のために Cursor のサーバーを通ります。エディタから TokenLab への直接接続ではありません。

モデルを選ぶCopy Anchor Link

現在の TokenLab カタログから正確な ID をコピーし、Cursor の OpenAI BYOK で使えることを確認します。TokenLab の chat 分類だけでは Cursor との互換性は判断できません。

最初のテキスト確認には、現在も提供されていれば非推論モデルの例として gpt-4.1-mini を使えます。Models の既存項目を有効にし、なければ Add model で追加してチャットで選択します。組み込みモデルを別の綴りで重複登録しないでください。Claude や Gemini が OpenAI override を通るとも限りません。Cursor の案内も参照してください。

小さなリクエストで確認するCopy Anchor Link

選んだモデルで新しいチャットを作成し、次を送ります。

TOKENLAB_CONNECTION_OK だけを返してください。ツールを使わず、ファイルを変更しないでください。

このリクエストは課金対象です。応答に加えて、TokenLab のリクエスト記録でモデル、時刻、状態を照合してください。モデルの表示や応答だけでは、この経路の接続確認にはなりません。

失敗した場合Copy Anchor Link

• **モデルが見つからない、または拒否される：**正確な ID と BYOK 対応範囲を確認し、組み込み項目があれば使います。再起動で非対応モデルが使えるようにはなりません。
• **認証エラー：**OpenAI 欄の TokenLab キーと Base URL を確認します。残高・上限のエラーは無効なキーとは別問題です。
• **TokenLab に記録がない：**選択モデルと override、Cursor のエラーを確認します。Tab 補完では接続を検証できません。
• **ほかのプロバイダーが動かない：**以前の OpenAI 設定に戻すか override を無効にして、新しいチャットを開始します。

MCP と Skills を追加するCopy Anchor Link

MCP は呼び出せるツールを追加します。Cursor の MCP 設定または .cursor/mcp.json を使い、まずツール検出を確認してから必要な有料生成を行います。主モデルは置き換えません。

Skills は API の操作手順です。SKILL.md と参照ファイルを含むフォルダー全体を .cursor/skills/tokenlab-api-integration/ に置き、Customize → Skills で検出を確認します。キーや MCP サーバーは付属しません。バージョンごとの入口は公式 MCP・Skills 文書を参照してください。