코딩 도구
Cursor
지원되는 Cursor 채팅 모델을 위해 TokenLab을 구성하고, 연결을 확인하며, MCP 또는 Skills를 별도로 추가하세요
이 연결의 기능
macOS, Windows 또는 Linux의 Cursor 데스크톱 에디터에서 지원되는 채팅 요청에 TokenLab을 사용하세요. Cursor는 표준 비추론(non-reasoning) 채팅 모델에 대한 OpenAI BYOK 지원을 문서화하고 있습니다. 탭 자동 완성은 여전히 Cursor의 모델을 사용합니다. OpenAI Base URL 재정의(override)가 Cursor를 모든 TokenLab 모델이나 프로토콜을 위한 클라이언트로 바꾸지는 않습니다. Cursor의 API-key 제한을 참조하세요.
TokenLab 이미지, 비디오 또는 기타 API 도구만 필요한 경우, 현재 채팅 제공업체를 유지하고 대신 MCP를 추가하세요. Skill은 에이전트에게 API 사용 방법을 가르치지만, 채팅 제공업체를 변경하지는 않습니다.
에이전트에게 이 작업 맡기기
Read https://tokenlab.sh/docs/ko/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 다운로드에서 데스크톱 에디터를 설치하거나 업데이트하세요. 이 가이드는 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 가이드를 참조하세요.