Skip to main content
Cursorの補完機能およびエージェント機能はCursorのクラウド側で実行されるため、ユーザーのマシンからは直接利用できません。そのためlocalhost上のモデルやプライベートなLAN内のモデルにはアクセスできず、公開されたHTTPSエンドポイントが必要となります。Tokiosではhttps://api.tokios.com/v1というエンドポイントが提供されており、コネクターをモデルとペアリングし、デプロイ名を登録した上で、そのURLとsk-tok-…キーをCursorに渡せば利用可能です。ngrokのトンネル維持や認証なしのポート開放も不要です。

​
前提条件

  • A running Tokios connector paired with your local model — see Connector Install
  • A registered model deployment name — see Register a Model
  • A Tokios API key (sk-tok-…) — see API Keys
  • Cursorがインストール済みであること

​
なぜCursorは単にlocalhostを利用できないのか

Cursorからのモデルリクエストは、ユーザーのPC上のエディタプロセスではなくCursorのバックエンドから送信されます。このバックエンドからは127.0.0.1や自宅・オフィスのネットワーク内のマシンへはアクセスできず、公開インターネット上でHTTPS経由で到達可能なエンドポイントのみ呼び出せます。このためhttp://localhost:11434やLAN用IPを直接指定しても機能せず、Tokiosを含め正常に動作する設定ではローカルモデルの前段に公開HTTPS URLを配置する必要があるのです。

​
CursorをTokiosに向けて設定する

1

Cursorのモデル設定画面を開く

Open settings with Cmd+, (macOS) or Ctrl+, (Windows/Linux), then choose Models in the sidebar. Field labels shift between Cursor versions, so check yours if the names below don’t match.
2

ベースURLを上書きする

Set Override OpenAI Base URL to:
Keep the /v1 suffix — Cursor appends /chat/completions to whatever you enter here.
3

ご自身のデプロイをカスタムモデルとして登録する

Add a custom model using the public deployment name you registered in the Models tab — for example, gemma-tunnel. This is the value Cursor sends in the model field; it is not Ollama’s, llama.cpp’s, vLLM’s, or LM Studio’s local model id.
4

TokiosのAPIキーを貼り付ける

Paste your sk-tok-… key into Cursor’s API key field for the custom model. Cursor sends it as a Bearer token on every request.
Replace gemma-tunnel with the deployment name you registered, and sk-tok-YOUR_KEY with your own key. Never commit either into a shared config file.
この設定はCursorのチャット画面およびエージェントパネル（Cmd/Ctrl+L）に適用されます。タブ自動補完やインライン編集機能はこの設定の有無にかかわらず常にCursor標準のモデルで動作するため、2機能はローカルモデル側には反映されません。

​
なぜこれがngrokのトンネルより優れているのか

Cursorのクラウド専用アーキテクチャが原因で、Ollamaにアクセス可能にするための一般的な回避策は ngrok http 11434 と OLLAMA_HOST=0.0.0.0（あるいは OLLAMA_ORIGINS=*）を組み合わせることです。この組み合わせで問題なく動作しますが、トンネル再起動のたびにURLが変わるため、認証機能なしでモデルが公開された状態になります。そのURLが判明すれば誰でもモデルを呼び出せてしまうのです。 Tokiosのコネクターは送信専用なので、モデル側で受信用ポートが開かれることはなく、すべてのリクエストには何も付与されない代わりにスコープ付きの sk-tok-… APIキーが付加されます。
  • 認証なしの公開がない — コネクターはTokiosへ接続するだけで受信待機はせず、リクエストには有効なAPIキーが必須となります。
  • URLが安定 — https://api.tokios.com/v1の値は再起動後も変わらないため、Cursor側で一度設定すれば済みます。
  • スコープ付きAPIキー — キーを特定のデプロイに限定したり、漏洩時には即座に無効化したりできます。これによりローカルのモデルやコネクター側の変更は一切不要です。

​
トラブルシューティング

Cursorから送信されたAPIキーが欠落、形式が不正、あるいは無効化されている可能性があります。余分な空白を含まずに完全な sk-tok-… キーを貼り付けたか確認し、Keysタブでその状態を確認してください。
Cursorから送信された modelの値が登録済みのデプロイと一致しません。Cursor側で設定したカスタムモデル名が、Modelsタブに記載されている公開名と完全に同じか確認してください。これはローカル環境のOllama/llama.cpp/vLLM/LM Studio側のモデルIDとは異なります。
該当デプロイ用のコネクターがオフライン状態、あるいは同時接続数の上限に達しています。Connectorsタブを確認し、コネクターの状態が Onlineとなっているか、またコネクターを実行中のマシンが正常に稼働し通信可能かを確認してください。

​
次に行うべき手順

互換性のあるクライアント

その他の OpenAI および Anthropic 互換クライアント向けのベース URL と APIキーの設定方法についてはこちらを参照してください。

APIキー

チームメンバーやエージェント用に sk-tok-… キーを作成し、スコープを設定した上で更新して管理します。