Servidor Jev MCP
jev-mcp es el servidor MCP abierto que expone los primitivos de decisión de Jev — classify, score, check, gate, decide — como herramientas que cualquier cliente MCP (Claude Code, Cursor, Codex, OpenCode) puede llamar. Corre directo desde GitHub con npx y elige el endpoint correcto a partir de tu key.
Cada ejemplo necesita una jv_live_ key. Consigue una en la página de precios, expórtala como JEV_API_KEY y ya estás listo. Obtener una key →
Si llegaste a esta página porque un setup de Jev MCP devolvió un error de autenticación, el arreglo casi siempre es el endpoint — mira el truco más abajo. Si lo configuras desde cero, son dos líneas.
Instalar
El camino más rápido en Claude Code:
claude mcp add jev -e TYPESAFE_API_KEY=your_key -- npx -y github:codaaiteam/jev-mcpO añádelo a la config de cualquier cliente MCP (Cursor, Codex, OpenCode, el tuyo):
{
"mcpServers": {
"jev": {
"command": "npx",
"args": ["-y", "github:codaaiteam/jev-mcp"],
"env": { "TYPESAFE_API_KEY": "jv_live_..." }
}
}
}Las cinco herramientas
- jev_classify — elige una de tus opciones etiquetadas (enrutado, categorización, intención)
- jev_score — califica el input en una escala ordenada que tú defines (riesgo, urgencia, calidad)
- jev_check — una probabilidad de sí/no calibrada (gates, filtros, guardarraíles)
- jev_gate — evalúa el riesgo de una acción antes de que se ejecute → allow / confirm / block
- jev_decide — a tope: muchas preguntas tipadas en un viaje de ida y vuelta
Variables de entorno
Solo la key es obligatoria — el endpoint se elige a partir de ella automáticamente:
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)Truco: una jv_live_ key alojada solo funciona en el gateway
Una jv_live_… key alojada es válida SOLO en el gateway jevtypesafeai.com, no en api.typesafe.ai. El jev-mcp actual detecta una jv_live_ key y la enruta allí automáticamente, así que no tocas JEV_BASE_URL. Si estás en una versión antigua y una key alojada devuelve 401 authentication_error, actualiza — o pon JEV_BASE_URL=https://jevtypesafeai.com/api/v1/decide explícitamente. Una key oficial de TypeSafe (de console.typesafe.ai) usa api.typesafe.ai por defecto.
Enruta por tu propio gateway
Pon JEV_BASE_URL explícitamente para enviar las llamadas por tu propio gateway — Vercel AI Gateway, OpenRouter o Cloudflare. Todo lo demás queda igual.
Preguntas frecuentes
¿Por qué mi key de Jev MCP devuelve 401 authentication_error?
Casi siempre el endpoint. Una jv_live_ key alojada es válida solo en el gateway jevtypesafeai.com, no en api.typesafe.ai. Actualiza jev-mcp (detecta las jv_live_ keys automáticamente) o pon JEV_BASE_URL=https://jevtypesafeai.com/api/v1/decide explícitamente.
¿Qué key necesita jev-mcp?
TYPESAFE_API_KEY (alias JEV_API_KEY, JEV_KEY). Usa una jv_live_ key alojada de jevtypesafeai.com/pricing, o una key oficial de console.typesafe.ai.
¿Necesito poner JEV_BASE_URL?
No, en uso normal. jev-mcp elige el endpoint a partir de tu key — las jv_live_ keys van al gateway alojado, las oficiales a api.typesafe.ai. Ponlo solo para forzar tu propio gateway.
¿Con qué clientes MCP funciona jev-mcp?
Cualquier cliente MCP — Claude Code, Cursor, Codex, OpenCode y otros. Solo cambia la ubicación del archivo de config; el comando y el env son iguales.
¿Cómo fijo una versión del modelo?
Pon JEV_MODEL, p. ej. JEV_MODEL=jev-1.13.0, para que producción se quede en una versión fija en vez de jev-latest.
Ver también: Integración de Cursor · Integración de Claude Code · jev-mcp y open source · jev-mcp & open source
Prueba Jev antes de integrarlo
Ejecuta una decisión real y tipada en el navegador — gratis, sin registro — y luego pon tu key en el ejemplo de arriba.