TokenLab MCP 서버

에이전트에 필요한 항목 선택Copy Anchor Link

• MCP는 호환되는 클라이언트에 TokenLab API 도구를 추가합니다. 아래의 키가 필요 없는 catalog 설정부터 시작하세요.
• TokenLab Skill은 npx skills add를 통해 통합 가이드를 설치하며, MCP 서버를 실행하지는 않습니다.

두 방식 모두 기존 에이전트를 확장합니다. 메인 모델 제공자를 변경하려면 해당 클라이언트 자체의 설정 가이드를 따르세요.

에이전트가 설정하도록 하기Copy Anchor Link

컴퓨터에서 이미 실행 중인 에이전트에 다음 작업을 복사하세요:

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를 추가하세요.

요구 사항Copy Anchor Link

Node.js 18.17 이상을 설치하고 npx를 사용할 수 있는지 확인하세요:

node --version
npx --version

해당 npm 패키지는 stdio를 통해 로컬에서 실행됩니다. 전역 설치나 소스 코드 체크아웃은 필요하지 않습니다.

클라이언트가 사용할 수 있는 항목 선택Copy Anchor Link

모델 선택 기능만 개선하려는 경우 catalog로 시작하세요. 클라이언트가 콘텐츠를 생성하거나 모델을 호출해야 하는 경우 core를 사용하세요. full은 더 큰 도구 세트가 반드시 필요한 클라이언트를 위한 프로필입니다.

서버 추가Copy Anchor Link

현재 활성화된 설정을 백업하세요. TokenLab 항목만 추가하고 기존 제공자, 계정, 기본 모델 선택 및 권한은 그대로 유지하세요. 해당 이름을 이미 사용 중이라면 다른 이름을 선택하고 명령어를 업데이트하세요. 설정을 취소하려면 추가한 항목만 제거하거나 이전 백업으로 복원하세요.

claude mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=catalog \
  --scope user \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.24

유료 도구 활성화Copy Anchor Link

콘솔 → API 키에서 API 키를 생성한 후, MCP 서버 환경에 두 변수를 모두 설정하세요:

{
  "env": {
    "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
    "TOKENLAB_MCP_TOOL_PROFILE": "core"
  }
}

클라이언트에 시크릿 입력 기능이 있다면 이를 사용하세요. 실제 키가 공유 파일, 스크린샷, 로그 또는 셸 히스토리에 노출된 경우 해당 키를 즉시 폐기하고 새 키를 생성하세요.

연결 확인Copy Anchor Link

MCP 클라이언트를 재시작하거나 다시 로드하고, 메시지가 표시되면 로컬 서버를 승인한 뒤 tokenlab이 연결되었는지 확인하세요.

# Claude Code
claude mcp list

# Codex
codex mcp list

클라이언트에게 list_models를 호출하도록 요청하세요. 비어 있지 않은 목록이 반환되면 패키지가 시작되어 TokenLab에 성공적으로 연결된 것입니다. catalog 프로필은 API 키가 필요하지 않습니다.

유용한 도구Copy Anchor Link

도구 사용 가능 여부는 선택한 프로필에 따라 다릅니다. 일반적인 작업은 다음과 같습니다:

• 모델 목록 조회 및 특정 모델의 기능 확인
• 최신 TokenLab 요금 확인 또는 여러 모델 비교
• Chat Completions, Responses, Anthropic Messages 또는 Gemini 요청 전송
• evaluate_decisions를 사용한 형식화된 의사결정 평가
• 이미지 생성 또는 편집
• 비디오, 음악, 3D, 음성 생성, 텍스트 변환 또는 번역
• 파일 업로드 및 조회
• 임베딩 생성 또는 문서 재순위화
• 지원되는 비동기 작업 확인 및 취소

요금이나 모델 선택이 사전에 확인되지 않은 경우, 클라이언트는 유료 호출 전에 승인을 요청해야 합니다.

의사결정 모델Copy Anchor Link

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를 변경하는 경우 클라이언트 타임아웃을 그보다 더 길게 유지하세요. 타임아웃이 발생하면 결과를 확신할 수 없으므로 유료 호출을 다시 제출하기 전에 요청을 점검하세요. 의사결정 모델을 실제 작업 실행에 사용하기 전에 직접 라벨링한 사례를 바탕으로 유효성을 검증하세요.

비동기 미디어Copy Anchor Link

비디오, 음악 및 3D 도구는 완성된 파일 대신 작업을 반환합니다. 이미지 도구는 모델에 따라 완료된 결과 또는 작업을 반환할 수 있습니다.

결과에 비동기 delivery가 포함된 경우 상태가 완료(complete) 또는 실패(failed)가 될 때까지 해당 작업 ID로 get_task_status를 호출하세요. 상태 확인이 한 번 타임아웃되었다고 해서 두 번째 작업을 생성하지 마세요.

선택적 설정Copy Anchor Link

클라이언트나 배포 환경에 특수한 요구 사항이 없는 한 기본값을 사용하세요.

문제 해결Copy Anchor Link

호스팅된 모델 탐색기Copy Anchor Link

Streamable HTTP를 지원하는 클라이언트는 다음 주소의 공개 모델 탐색기를 사용할 수 있습니다:

https://tokenlab-model-explorer.vercel.app/mcp

유료 API 호출, 로컬 파일 업로드 또는 core 및 full 프로필을 사용하려면 로컬 npm 서버를 사용하세요.

링크Copy Anchor Link

• TokenLab MCP 페이지
• GitHub 리포지토리
• TokenLab API skill
• 모델 카탈로그
• API 빠른 시작 가이드

mt-… 관리 토큰(Management Token)으로 인증되는 웹훅 관리 API를 사용하여 작업 알림을 구성하세요. MCP full은 TOKENLAB_MANAGEMENT_TOKEN을 사용합니다. 종료 상태의 작업 및 401/403/404 또는 재시도할 수 없는 오류가 발생하면 폴링을 중단하세요.