localhost나 비공개 LAN의 모델에 도달할 수 없습니다 — 공개 HTTPS 엔드포인트 가 필요합니다. Tokios는 https://api.tokios.com/v1에서 이를 제공합니다: 모델 옆에서 커넥터를 페어링하고, 배포 이름을 등록하고, Cursor에 해당 URL과 sk-tok-… 키를 제공하세요. 유지해야 할 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
Open Cursor's model settings
단축키 Cmd+,(macOS) 또는 Ctrl+,(Windows/Linux)로 설정을 열고, 사이드바에서 Models를 선택하세요. 필드 레이블은 Cursor 버전마다 다를 수 있으므로 아래 이름이 일치하지 않으면 해당 버전에서 확인하세요.
2
Override the base URL
다음으로 Override OpenAI Base URL을 설정합니다:항상
/v1 접미사를 유지하세요 — Cursor는 여기에 입력한 값에 /chat/completions를 추가합니다.3
Add your deployment as a custom model
Cursor의 공개 배포 이름을 사용하여 커스텀 모델을 추가합니다 — Models 탭에서 등록한 이름이며 — 예:
gemma-tunnel. 이것은 Cursor가 model 필드에서 전송하는 값이며, Ollama, llama.cpp, vLLM, LM Studio의 로컬 모델 ID가 아닙니다.4
Paste your Tokios API key
Tokios의
sk-tok-… 키를 커스텀 모델의 API 키 필드에 붙여넣습니다. Cursor는 모든 요청에서 이를 Bearer 토큰으로 전송합니다.등록한 배포 이름으로
gemma-tunnel을, 실제 키로 sk-tok-YOUR_KEY를 교체하세요. 둘 다 공유 구성 파일에 커밋하지 마세요.ngrok 터널보다 나은 이유
Cursor의 클라우드 전용 아키텍처가 바로ngrok http 11434와 OLLAMA_HOST=0.0.0.0(또는 OLLAMA_ORIGINS=*)을 사용하는 일반적인 해결책이 필요한 이유입니다. 이 조합은 작동하지만, 인증 없이 모델이 URL 뒤에서 수신하도록 두고, 터널을 재시작할 때마다 URL이 변경됩니다 — 라이브 상태인 해당 URL을 찾는 사람은 누구나 모델을 호출할 수 있습니다.
Tokios의 커넥터는 아웃바운드 전용이므로 모델이 인바인드 포트를 열지 않으며, 모든 요청에 아무것도 아닌 범위 지정된 sk-tok-… 키가 포함됩니다:
- 인증 없는 노출 없음 — 커넥터는 Tokios로 외부 연결하며, 포트에서 수신하지 않고, 요청에는 유효한 키가 필요합니다.
- 안정적인 URL —
https://api.tokios.com/v1은 재시작 사이에 변경되지 않으므로 Cursor에서 한 번만 설정하면 됩니다. - 범위 지정된 키 — 키는 특정 배포로 제한될 수 있으며, 유출 시 로컬 모델이나 커넥터를 건드리지 않고 즉시 취소할 수 있습니다.
문제 해결
401 error
401 error
Cursor가 전송한 API 키가 없거나, 형식이 잘못되었거나, 취소되었습니다. 여분의 공백 없이 전체
sk-tok-… 키를 붙여넣었는지 확인하고, Keys 탭에서 상태를 확인하세요.404 error
404 error
Cursor가 전송한
model 값이 등록된 배포와 일치하지 않습니다. Cursor의 커스텀 모델 이름이 Models 탭의 공개 이름과 정확히 일치하는지 확인하세요 — Ollama/llama.cpp/vLLM/LM Studio 로컬 모델 ID가 아닙니다.503 error
503 error
해당 배포의 커넥터가 오프라인이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인하세요 — 커넥터가 Online으로 표시되어야 하며, 실행 중인 머신이 여전히 켜져 있고 도달 가능해야 합니다.
다음 단계
Compatible clients
다른 OpenAI 및 Anthropic 호환 클라이언트의 Base URL 및 키 설정을 확인하세요.
API keys
팀원과 에이전트를 위한
sk-tok-… 키를 생성, 범위 지정, 로테이션하세요.