localhost やプライベートLAN上のモデルには到達できません。公開HTTPSエンドポイントが必要です。Tokiosは https://api.tokios.com/v1 でエンドポイントを提供します。モデルの隣でコネクターをペアリングし、デプロイ名を登録し、そのURLと sk-tok-… キーをCursorに渡します。ngrokトンネルを維持する必要も、認証なしのポートも不要です。
前提条件
- ローカルモデルとペアリング済みのTokiosコネクターが動作していること — Connector install
- 登録済みのモデルデプロイ名 — Register a model
- Tokios APIキー(
sk-tok-…) — API Keys - Cursorがインストール済みであること
Cursorがlocalhostをそのまま使えない理由
Cursorのモデルリクエストはラップトップ上のエディタプロセスではなく、Cursorのバックエンドから送信されます。このバックエンドには127.0.0.1 や自宅・オフィスネットワーク上のマシンへのルートがなく、公開インターネット上でHTTPS経由で到達可能なエンドポイントのみを呼び出せます。これが、Cursorを単なる http://localhost:11434 やLAN IPに向けても機能しない理由であり、Tokiosを含むすべての動作する設定がローカルモデルの前に公開HTTPS URLを配置する必要がある理由です。
CursorをTokiosに向ける
1
Cursorのモデル設定を開く
設定を開くには Cmd+, (macOS)または Ctrl+, (Windows/Linux)を使用し、サイドバーの Models を選択します。フィールドラベルはCursorのバージョンによって異なる場合があるため、以下の名前が一致しない場合はお手元のバージョンを確認してください。
2
ベースURLをオーバーライドする
次のように設定します Override OpenAI Base URL :サフィックス
/v1 をそのまま残してください。Cursorはここに入力した値に /chat/completions を追加します。3
デプロイをカスタムモデルとして追加する
カスタムモデルを 公開デプロイ名 で追加します。登録は Models タブで行います。例えば
gemma-tunnel です。これはCursorが model フィールドで送信する値であり、Ollama、llama.cpp、vLLM、LM StudioのローカルモデルIDではありません。4
Tokios APIキーを貼り付ける
貼り付けてください
sk-tok-… キーをカスタムモデル用のCursorのAPIキーフィールドに。CursorはすべてのリクエストでこれをBearerトークンとして送信します。置き換えてください:
gemma-tunnel →登録済みのデプロイ名、 sk-tok-YOUR_KEY →ご自身のキー。どちらも共有の設定ファイルにコミットしないでください。なぜこれがngrokトンネルより優れているのか
Cursorのクラウド専用アーキテクチャのため、一般的な回避策はngrok http 11434 と OLLAMA_HOST=0.0.0.0 (または OLLAMA_ORIGINS=* )を組み合わせてOllamaを到達可能にすることです。この組み合わせは機能しますが、認証なしのモデルがトンネルを再起動するたびに変化するURLの背後で待ち受ける状態になります。そのURLがライブ中に見つかった場合、誰でもモデルを呼び出せます。
Tokiosのコネクターは送信のみなので、モデルはインバウンドポートを決して開かず、すべてのリクエストには何もない代わりにスコープ付きの sk-tok-… キーが付与されます。
- 認証なしの公開がない — コネクターはTokiosにダイヤルアウトし、ポートで待ち受けません。リクエストには有効なキーが必要です。
- 安定したURL —
https://api.tokios.com/v1は再起動間で変化しないため、Cursorで一度設定するだけです。 - スコープ付きキー — キーは特定のデプロイに限定でき、漏洩した場合はローカルモデルやコネクターに触れることなく即座に取り消せます。
トラブルシューティング
401エラー
401エラー
Cursorが送信したAPIキーが欠落、不正な形式、または無効化されています。完全な
sk-tok-… キーを余分な空白なしで貼り付けたかを確認し、Keysタブでステータスを確認してください。404エラー
404エラー
Cursorが送信した
model 値が登録済みのデプロイと一致しません。Cursorのカスタムモデル名がModelsタブの公開名と完全に一致しているかを確認してください。Ollama/llama.cpp/vLLM/LM StudioのローカルモデルIDではありません。503エラー
503エラー
そのデプロイのコネクターがオフラインか、同時実行数の上限に達しています。Connectorsタブを確認してください。コネクターが Online を示しており、実行しているマシンが稼働中で到達可能である必要があります。
次のステップ
互換クライアント
その他のOpenAIおよびAnthropic互換クライアントのベースURLとキー設定を参照してください。
APIキー
チームメイトやエージェント用の
sk-tok-… キーの作成、スコープ設定、ローテーションを行います。