Jev MCP server

jev-mcp는 Jev의 결정 프리미티브 — classify, score, check, gate, decide — 를 모든 MCP 클라이언트(Claude Code, Cursor, Codex, OpenCode)가 호출할 수 있는 도구로 노출하는 오픈 MCP server입니다. npx로 GitHub에서 바로 돌며 당신의 키에서 올바른 endpoint를 고릅니다.

Jev MCP 설정이 인증 오류를 반환해서 이 페이지에 왔다면, 해결은 거의 항상 endpoint입니다 — 아래 함정을 보세요. 새로 설정하는 거라면 두 줄입니다.

설치

Claude Code에서 가장 빠른 경로:

claude mcp add jev -e TYPESAFE_API_KEY=your_key -- npx -y github:codaaiteam/jev-mcp

또는 어떤 MCP 클라이언트의 설정에든 추가(Cursor, Codex, OpenCode, 직접 만든 것):

{
  "mcpServers": {
    "jev": {
      "command": "npx",
      "args": ["-y", "github:codaaiteam/jev-mcp"],
      "env": { "TYPESAFE_API_KEY": "jv_live_..." }
    }
  }
}

다섯 가지 도구

• jev_classify — 라벨이 붙은 옵션 중 하나 고르기(라우팅, 분류, 의도)
• jev_score — 정의한 순서 스케일로 입력 채점(위험, 긴급도, 품질)
• jev_check — 보정된 yes/no 확률(게이트, 필터, 가드레일)
• jev_gate — 실행 전 동작을 위험 심사 → allow / confirm / block
• jev_decide — 풀파워: 한 왕복에 여러 타입 지정 질문

환경 변수

필수는 키뿐입니다 — endpoint는 그로부터 자동으로 선택됩니다:

TYPESAFE_API_KEY   Your Jev key (aliases: JEV_API_KEY, JEV_KEY). Required.
JEV_BASE_URL       auto — chosen from your key:
                     jv_live_… key → https://jevtypesafeai.com/api/v1/decide
                     other key     → https://api.typesafe.ai/v1/systemone
                   Set explicitly to route through your own gateway.
JEV_MODEL          jev-latest  (pin e.g. jev-1.13.0 in production)

함정: 호스팅된 jv_live_ key는 게이트에서만 동작

호스팅된 jv_live_… key는 jevtypesafeai.com 게이트에서만 유효하고 api.typesafe.ai에서는 무효합니다. 현행 jev-mcp는 jv_live_ key를 감지해 자동으로 그곳으로 라우팅하므로 JEV_BASE_URL을 건드릴 필요가 없습니다. 구버전에서 호스팅 키가 401 authentication_error를 반환하면 업그레이드하거나 JEV_BASE_URL=https://jevtypesafeai.com/api/v1/decide를 명시적으로 설정하세요. 공식 TypeSafe 키(console.typesafe.ai)는 기본으로 api.typesafe.ai를 씁니다.

당신의 게이트로 라우팅

JEV_BASE_URL을 명시적으로 설정해 호출을 당신의 게이트로 보내세요 — Vercel AI Gateway, OpenRouter, 또는 Cloudflare. 나머지는 모두 같습니다.

자주 묻는 질문

함께 보기: Cursor 통합 · Claude Code 통합 · jev-mcp & 오픈소스 · jev-mcp & open source