코딩 도구
TokenLab MCP Server
Claude Code, Cursor, VS Code, Codex 및 기타 MCP 클라이언트가 TokenLab 모델과 API에 액세스할 수 있도록 지원합니다.
에이전트가 필요한 기능 선택
- MCP는 호환되는 클라이언트에 TokenLab API 도구를 추가합니다. 아래의 키가 필요 없는
catalog설정으로 시작하세요. - TokenLab Agent Skills는 에이전트에게 모델 선택 방법이나 결과 확인 방법과 같은 작업 수행 방식을 가르칩니다. 이는 MCP 서버를 시작하지 않으며, 두 가지가 모두 설치된 경우 MCP 도구를 사용할 수 있습니다.
모델 선택기(model picker) Skill 설치: npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker
두 가지 모두 기존 에이전트를 확장합니다. 메인 모델 공급자를 변경하려면 해당 클라이언트의 자체 설정 가이드를 사용하세요.
에이전트가 이 설정을 수행하도록 하기
컴퓨터에서 실행 중인 에이전트에 다음 작업을 복사하세요:
Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/ko/integrations/tokenlab-mcp-server
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.TokenLab MCP Server를 사용하면 MCP 클라이언트가 현재 모델과 가격을 탐색하고, 모델 요청을 보내고, 미디어를 생성하고, 파일 작업을 수행하고, 비동기 작업을 확인할 수 있습니다.
API 키 없이 모델과 가격을 탐색하려면 catalog 프로필을 사용하세요. 클라이언트가 유료 모델이나 미디어 요청을 수행해야 할 때는 TOKENLAB_API_KEY를 추가하세요.
TokenLab API 키를 MCP 서버 환경에 보관하세요. 프롬프트나 도구 인수에 절대 붙여넣지 마세요.
요구 사항
Node.js 18.17 이상을 설치하고 npx를 사용할 수 있는지 확인하세요:
node --version
npx --versionnpm 패키지는 stdio를 통해 로컬에서 실행됩니다. 전역 설치나 소스 체크아웃은 필요하지 않습니다.
클라이언트가 사용할 수 있는 기능 선택
| 프로필 | API 키 | 포함 항목 |
|---|---|---|
catalog | 필요 없음 | 모델 목록, 모델 세부 정보, 가격, 비교 및 API 개요 |
core | 유료 호출 시 필요 | 일반 채팅, 결정, 미디어, 오디오, 파일, 작업, 임베딩, 순위 재지정(rerank) 및 번역 도구 |
full | 유료 호출 시 필요 | core 및 추가 개발자 API |
더 나은 모델 선택만 원한다면 catalog로 시작하세요. 클라이언트가 콘텐츠를 생성하거나 모델을 호출해야 할 때는 core를 사용하세요. full은 더 큰 도구 세트가 필요한 클라이언트를 위한 것입니다.
서버 추가
활성 구성을 백업하세요. TokenLab 항목만 추가하고 기존 공급자, 계정, 기본 모델 선택 및 권한은 유지하세요. 이름이 이미 사용 중인 경우 다른 이름을 선택하고 명령을 업데이트하세요. 설정을 취소하려면 추가한 항목만 제거하거나 이전 백업을 복원하세요.
사용자 계정에 공개 카탈로그를 추가하세요:
claude mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=catalog \
--scope user \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48유료 도구를 사용하려면 프로필 환경 변수를 TOKENLAB_API_KEY로 바꾸고 일반적인 보안 관리 방법을 통해 키를 저장하세요. 한 프로젝트에 대해서는 --scope local을 사용하세요. 공유 .mcp.json 파일에 실제 키를 커밋하지 마세요.
유료 도구 활성화
Console → API keys에서 API 키를 생성한 다음, MCP 서버 환경에서 두 변수를 모두 설정하세요:
{
"env": {
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
"TOKENLAB_MCP_TOOL_PROFILE": "core"
}
}클라이언트에 보안 입력 기능이 있는 경우 이를 사용하세요. 공유 파일, 스크린샷, 로그 또는 셸 기록에 실제 키가 나타나면 해당 키를 취소하고 새 키를 생성하세요.
연결 확인
MCP 클라이언트를 다시 시작하거나 새로 고치고, 메시지가 표시되면 로컬 서버를 승인한 다음 tokenlab이 연결되었는지 확인하세요.
# Claude Code
claude mcp list
# Codex
codex mcp list클라이언트에 list_models를 호출하도록 요청하세요. 비어 있지 않은 목록은 패키지가 시작되어 TokenLab에 도달했음을 확인해 줍니다. catalog 프로필은 API 키가 필요하지 않습니다.
유용한 도구
도구 가용성은 선택한 프로필에 따라 다릅니다. 일반적인 작업은 다음과 같습니다:
- 모델 목록 확인 및 특정 모델의 기능 읽기
- 현재 TokenLab 가격 읽기 또는 여러 모델 비교
- 채팅 완성(Chat Completions), 응답, Anthropic 메시지 또는 Gemini 요청 보내기
evaluate_decisions를 사용하여 유형화된 결정 평가- 이미지 생성 또는 편집
- 비디오, 음악, 3D, 음성, 전사 또는 번역 생성
- 파일 업로드 및 검색
- 임베딩 생성 또는 문서 순위 재지정
- 지원되는 비동기 작업 확인 및 취소
가격이나 모델 선택이 아직 확인되지 않은 경우, 클라이언트는 유료 호출 전에 승인을 요청해야 합니다.
MCP 파일 도구는 OpenAI 호환 /v1/files API를 사용합니다. Gemini Files, 재개 가능한 업로드 및 cachedContents는 현재 HTTP 호출이 필요하며 MCP 프로필에 포함되어 있지 않습니다. Gemini Files and cache를 참조하세요.
결정 모델
System One 결정 모델을 호출하려면 core 또는 full을 사용하세요. 먼저 {"category":"decision"}과 함께 list_models를 호출하고, 선택한 모델 ID로 get_model을 호출하세요. 에이전트의 메인 채팅 모델은 별도로 구성하세요.
Jev 1.13의 경우, 네이티브 state 및 questions와 함께 도구를 호출하세요:
{
"name": "evaluate_decisions",
"arguments": {
"model": "jev-1.13",
"state": { "ticket": "Please refund the duplicate payment." },
"questions": {
"refund_requested": {
"type": "noul",
"instructions": "Does the customer explicitly request a refund?"
}
}
}
}isError를 확인한 다음 structuredContent.answers 및 structuredContent.usage를 읽으세요. Noul 답변은 불리언(Boolean)이 아닌 확률 숫자입니다. 사용 가능한 경우 _meta에서 요청 ID를 보존하세요. 이 도구는 동기식 결과를 반환하며 비동기 작업 폴링 흐름을 사용하지 않습니다.
기본 120,000ms 서버 요청 시간 제한을 고려하여 클라이언트 도구 호출에 최소 150,000ms를 허용하세요. TOKENLAB_REQUEST_TIMEOUT_MS를 변경하는 경우 클라이언트 시간 제한을 더 길게 유지하세요. 시간 제한이 발생하면 결과가 불확실해지므로, 유료 호출을 다시 제출하기 전에 요청을 검사하세요. 결정을 사용하여 작업을 수행하기 전에 자체 라벨링된 사례에 대해 결정을 검증하세요.
비동기 미디어
비디오, 음악 및 3D 도구는 완성된 파일 대신 작업을 반환합니다. 이미지 도구는 모델에 따라 완료된 결과나 작업을 반환할 수 있습니다.
결과에 비동기 delivery가 포함된 경우, 상태가 완료되거나 실패할 때까지 작업 ID와 함께 get_task_status를 호출하세요. 상태 확인 시간이 초과되었다고 해서 두 번째 작업을 생성하지 마세요.
선택적 설정
| 변수 | 기본값 | 용도 |
|---|---|---|
TOKENLAB_API_BASE | https://api.tokenlab.sh | 사용자 지정 TokenLab API 호스트; 끝에 슬래시를 생략하세요 |
TOKENLAB_MCP_TOOL_PROFILE | core | catalog, core 또는 full |
TOKENLAB_REQUEST_TIMEOUT_MS | 120000 | 밀리초 단위의 요청 시간 제한 |
TOKENLAB_MCP_MAX_FILE_BYTES | 104857600 | 파일당 최대 로컬 업로드 크기 |
TOKENLAB_ARTIFACT_DIR | OS 임시 디렉터리 | 대용량 다운로드 파일이 저장되는 위치 |
클라이언트나 배포 환경에 특별한 요구 사항이 없는 한 기본값을 사용하세요.
문제 해결
호스팅된 모델 탐색기
Streamable HTTP를 지원하는 클라이언트는 다음의 공개 모델 탐색기를 사용할 수 있습니다:
https://mcp.tokenlab.sh/mcp유료 API 호출, 로컬 파일 업로드 또는 core 및 full 프로필에는 로컬 npm 서버를 사용하세요.
링크
- TokenLab MCP 페이지
- Claude Code 또는 OpenClaw에서 이미지 및 비디오 생성
- GitHub 저장소
- TokenLab Agent Skills
- 모델 카탈로그
- API 빠른 시작
mt-… 관리 토큰으로 인증되는 Webhook 관리 API를 사용하여 작업 알림을 구성하세요. MCP full은 TOKENLAB_MANAGEMENT_TOKEN을 사용합니다. 터미널 작업 폴링을 중지하고 401/403/404 또는 재시도할 수 없는 오류가 발생하면 중단하세요.