Jev MCP Server (TypeSafe Jev)
Usa el modelo de decisión Jev de TypeSafe desde Claude, ChatGPT, Cursor o Gemini: comprobaciones de sí/no, clasificación y puntuación con probabilidades en unos 300 ms. Servidor remoto con OAuth, una clave cifrada compartida para un equipo, autoalojable (AnythingMCP).
Servidor MCP alojado
npx add-mcp 'https://cloud.anythingmcp.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Servidor MCP de Jev
Conecta Jev a Claude, ChatGPT y Copilot: comprobaciones sí/no, clasificaciones y puntuaciones, con la probabilidad detrás de cada respuesta como herramientas MCP. Impulsado por AnythingMCP.
El Servidor MCP de Jev ofrece a Claude, ChatGPT, Copilot y Cursor 6 herramientas para Jev: comprobaciones sí/no, clasificaciones y puntuaciones, con la probabilidad detrás de cada respuesta. Cada herramienta solo lee. Se ejecuta en AnythingMCP: un clic en AnythingMCP Cloud, o autoalojado con Docker. Las credenciales se almacenan cifradas y cada llamada se audita.
Última verificación: 2026-09-27 contra la API TypeSafe en vivo (jev-1.13.0) (cada herramienta llamada a través de un AnythingMCP local sobre MCP, 27 casos directos de API incl. rutas de error, y Claude Code clasificando tickets en inglés y alemán a través del conector).
Adaptador sincronizado: 2026-09-27
Mantenido por @keysersoft, un mantenedor de AnythingMCP. Construido sobre AnythingMCP por helpcode.ai.
Inicio rápido (AnythingMCP Cloud)
- Inicia sesión en cloud.anythingmcp.com y abre el enlace de instalación.
- Introduce
TYPESAFE_API_KEY(consulta Autenticación). - Copia la URL de tu servidor MCP en Servidores MCP y añádela a tu cliente de IA (abajo).
AnythingMCP Cloud es el mismo código de código abierto, operado por helpcode.ai en Fráncfort, Alemania.
Autoalojado (Docker)
Requiere Docker 24+, openssl y Node 18+.
git clone https://github.com/keysersoft/jev-mcp-server.git
cd jev-mcp-server
./scripts/install.sh
install.sh escribe .env con secretos nuevos, inicia AnythingMCP, crea el primer administrador, instala el conector si TYPESAFE_API_KEY están configurados en .env y crea una clave API de MCP. Sin credenciales, imprime el enlace de instalación en su lugar: http://localhost:3000/connectors/store?install=jev. Luego verifica toda la cadena:
npm install && node scripts/smoke.mjs
Conecta Claude, ChatGPT, Copilot o Cursor
-
Claude (claude.ai, Escritorio, móvil): Personalizar → Conectores → Añadir conector personalizado, pega la URL de tu servidor MCP e inicia sesión. Claude se conecta desde la nube de Anthropic, por lo que la URL debe ser HTTPS pública: tu URL de AnythingMCP Cloud, o tu propia instancia detrás de TLS.
-
Claude Code:
claude mcp add --transport http jev-mcp-server http://localhost:4000/mcp --header "X-API-Key: <MCP_API_KEY>" -
Cursor (
.cursor/mcp.json) y VS Code / GitHub Copilot (.vscode/mcp.json, claveserversen lugar demcpServers, además de"type": "http"):{ "mcpServers": { "jev-mcp-server": { "url": "http://localhost:4000/mcp", "headers": { "X-API-Key": "<MCP_API_KEY>" } } } } -
ChatGPT: añade la URL HTTPS pública como conector (app) en la configuración de ChatGPT. Una URL
localhostno funciona allí.
Herramientas
6 herramientas, generadas desde adapter/jev.json. Las herramientas read no pueden cambiar nada en el sistema de origen.
| Herramienta | Qué hace | Acceso |
|---|---|---|
jev_playbook | EMPIEZA AQUÍ: devuelve, SIN llamada a la API, cómo usar Jev correctamente: qué tipo de pregunta elegir, cómo estructurar el estado, cómo redactar la pregunta, cómo leer… | read |
jev_yes_no | Haz a Jev UNA pregunta sí/no sobre alguna evidencia. | read |
jev_classify | Pide a Jev que elija UNA opción de un conjunto que tú defines (enrutamiento, etiquetado, intención, triaje). | read |
jev_rate | Pide a Jev que coloque la evidencia en una escala ordenada que tú defines (gravedad, ajuste de cliente potencial, calidad, sentimiento). | read |
jev_ask | API completa de Jev: haz VARIAS preguntas tipadas sobre el mismo estado en una sola llamada (respondidas en paralelo, estado facturado una vez). | read |
jev_list_models | Lista los nombres de modelos de Jev que tu clave API puede usar en el campo model (alias como jev-latest y jev-preview, con fechas de lanzamiento). | read |
Ejemplos de indicaciones
- Usa Jev para decidir cuáles de estos tickets de soporte son urgentes y muestra la probabilidad de cada uno.
- Clasifica cada ticket de abajo en facturación, técnico, ventas o ninguno con Jev, y lista aquellos donde la confianza esté por debajo de 0.6.
- Califica estos cinco clientes potenciales de 0 (sin ajuste) a 3 (cliente ideal) con Jev según el perfil de abajo.
- Pregunta a Jev si esta respuesta contesta cada pregunta del correo del cliente antes de enviarla.
- Pregunta a Jev si estos dos registros de proveedor describen la misma empresa.
- ¿Cuáles de estos 20 correos piden un reembolso? Usa Jev y dame solo los que estén por encima de 0.8.
Más en examples/prompts.md.
Autenticación
El conector necesita un valor:
| Variable | Dónde encontrarla |
|---|---|
TYPESAFE_API_KEY | console.typesafe.ai → crea una clave API |
La clave se envía como Authorization: Bearer <key> a https://api.typesafe.ai. En la instalación, AnythingMCP la verifica con una llamada gratuita a GET /v1/models y luego la almacena cifrada.
Seguridad
- Leer o escribir es tu elección. Las 6 herramientas solo leen. Asigna el conector a un servidor MCP cuyo rol permita solo las herramientas que quieras, y el resto serán invisibles para ese cliente.
- Credenciales están cifradas con AES-256-GCM y nunca se muestran al modelo.
- Mapeo de respuestas elimina o reforma campos por herramienta antes de que lleguen al modelo, p. ej. datos bancarios o datos personales.
- Registro de auditoría: cada llamada se registra con entrada, salida, duración y estado, en tu propia base de datos cuando está autoalojado.
- SSO, RBAC y SCIM están incluidos en la compilación autoalojada.
Preguntas frecuentes
¿Qué es Jev?
Jev es el primer modelo System One de TypeSafe. No genera texto: pasas evidencia (el state) y preguntas tipadas, y responde a cada una con una probabilidad sí/no, una opción de un conjunto que defines, o una puntuación en niveles ordenados, con las probabilidades detrás de la respuesta. En nuestras pruebas, una llamada tardó de 220 a 430 ms.
¿Cómo uso Jev en Claude o ChatGPT?
Instala el conector de Jev en AnythingMCP con tu clave API de TypeSafe, luego añade la URL del servidor de AnythingMCP a Claude como conector personalizado o a ChatGPT como app en modo desarrollador. Ambos inician sesión con OAuth, así que nada tiene que ejecutarse en tu computadora. Claude Code, Cursor y otros clientes usan la misma URL con un encabezado de clave API.
¿Qué herramientas tiene el conector?
jev_yes_no, jev_classify y jev_rate hacen una pregunta cada una con parámetros simples; jev_ask envía varias preguntas de cualquier tipo sobre la misma evidencia en una sola llamada; jev_list_models lista los modelos que tu clave puede usar; jev_playbook explica al modelo cómo redactar preguntas y leer las respuestas, sin llamar a la API.
¿Cuánto cuesta?
TypeSafe factura a Jev por token de entrada, alrededor de $0.042 por millón, y la salida es gratuita. Una llamada con tres preguntas sobre un ticket de soporte corto usó alrededor de 500 tokens. AnythingMCP en sí es gratuito cuando está autoalojado.
¿Puede un equipo compartir una clave de TypeSafe?
Sí. La clave se almacena una vez, cifrada, en el servidor de AnythingMCP. Las personas se conectan al servidor con su propio inicio de sesión, nunca ven la clave, y cada llamada se escribe en el registro de auditoría.
¿Jev entiende idiomas distintos del inglés?
Los maneja. Los tickets en alemán e italiano volvieron correctos y con confianza en nuestras pruebas; el inglés es donde TypeSafe reporta la mejor precisión, así que vigila los valores de confianza para otros idiomas.
Solución de problemas
| Problema | Solución |
|---|---|
401 / 403 del proveedor | Las credenciales son incorrectas o carecen de permisos. Vuelve a introducirlas en la página del conector; la importación ejecuta una llamada de prueba y muestra el resultado. |
| Herramientas faltantes en el cliente de IA | El conector no está asignado al servidor MCP que usa el cliente. Revisa Servidores MCP y luego ejecuta node scripts/smoke.mjs. |
| El host está en tu red interna | Autoaloja AnythingMCP en esa red y añade el nombre de host a SSRF_ALLOWED_HOSTS, o el guardia de salida bloqueará la llamada. |
| Funciona localmente, falla en AnythingMCP Cloud | El sistema debe ser accesible desde internet con un certificado TLS válido. |
| Síntoma | Causa y solución |
401 en cada llamada | La clave API es incorrecta o fue revocada. Crea una nueva en console.typesafe.ai y actualiza TYPESAFE_API_KEY en el conector. |
400 Invalid request. | Una pregunta tiene un tipo distinto de noul, choice o score (no existe bool), o la solicitud lleva un campo que Jev no conoce. El resultado de la herramienta incluye una pista que lista las formas válidas. |
422 nombrando score.criteria | Los niveles de puntuación deben ser un arreglo, del más bajo al más alto, no un objeto. |
400 Too many score levels / Too many choices | Una puntuación admite como máximo 10 niveles y una elección como máximo 255 opciones. |
429 o 529 | El límite de tasa de TypeSafe o una sobrecarga temporal. El conector reintenta con retroceso; distribuye lotes grandes en el tiempo. |
| Una respuesta sí/no cerca de 0.5 | Jev no está seguro, no dice "medio". Haz una pregunta más específica sobre la evidencia concreta, o pasa más contexto en state. |
Relacionados
- openapi-to-mcp: OpenAPI a MCP: convierte cualquier API OpenAPI/Swagger o REST en un servidor MCP para Claude y ChatGPT. Cada endpoint una herramienta, sin código.
- erp-mcp-server: Servidor MCP de ERP: conecta 16 ERPs (SAP, Odoo, JTL-Wawi, Xentral, weclapp, ERPNext…) a Claude y ChatGPT. Autoalojado o en la nube.
- AnythingMCP: el servidor MCP y puerta de enlace de código abierto sobre el que se construye este repositorio.
Licencia
AGPL-3.0-only. La definición del adaptador en adapter/ proviene de AnythingMCP (AGPL-3.0).