Jev-MCP-Server
jev-mcp ist der offene MCP-Server, der Jevs Entscheidungsprimitive — classify, score, check, gate, decide — als Tools bereitstellt, die jeder MCP-Client (Claude Code, Cursor, Codex, OpenCode) aufrufen kann. Es läuft per npx direkt von GitHub und wählt den richtigen endpoint aus deinem Key.
Jedes Beispiel braucht einen jv_live_-Key. Hol dir einen auf der Pricing-Seite, exportiere ihn als JEV_API_KEY, und du bist startklar. Key holen →
Wenn du auf dieser Seite gelandet bist, weil ein Jev-MCP-Setup einen Authentifizierungsfehler zurückgab, liegt die Lösung fast immer am endpoint — siehe den Stolperstein unten. Bei einem frischen Setup sind es zwei Zeilen.
Installieren
Der schnellste Weg in Claude Code:
claude mcp add jev -e TYPESAFE_API_KEY=your_key -- npx -y github:codaaiteam/jev-mcpOder füge es der Konfig eines beliebigen MCP-Clients hinzu (Cursor, Codex, OpenCode, dein eigener):
{
"mcpServers": {
"jev": {
"command": "npx",
"args": ["-y", "github:codaaiteam/jev-mcp"],
"env": { "TYPESAFE_API_KEY": "jv_live_..." }
}
}
}Die fünf Tools
- jev_classify — eine deiner gelabelten Optionen wählen (Routing, Kategorisierung, Intent)
- jev_score — den Input auf einer von dir definierten geordneten Skala bewerten (Risiko, Dringlichkeit, Qualität)
- jev_check — eine kalibrierte Ja/Nein-Wahrscheinlichkeit (Gates, Filter, Guardrails)
- jev_gate — eine Aktion vor der Ausführung risiko-prüfen → allow / confirm / block
- jev_decide — volle Kraft: viele typisierte Fragen in einem Roundtrip
Umgebungsvariablen
Nur der Key ist erforderlich — der endpoint wird automatisch daraus gewählt:
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)Stolperstein: ein gehosteter jv_live_-Key funktioniert nur am Gateway
Ein gehosteter jv_live_…-Key ist NUR am jevtypesafeai.com-Gateway gültig, nicht an api.typesafe.ai. Das aktuelle jev-mcp erkennt einen jv_live_-Key und routet ihn automatisch dorthin, du fasst JEV_BASE_URL also nicht an. Wenn du eine ältere Version nutzt und ein gehosteter Key 401 authentication_error zurückgibt, aktualisiere — oder setze JEV_BASE_URL=https://jevtypesafeai.com/api/v1/decide explizit. Ein offizieller TypeSafe-Key (von console.typesafe.ai) nutzt standardmäßig api.typesafe.ai.
Über dein eigenes Gateway routen
Setze JEV_BASE_URL explizit, um Aufrufe stattdessen über dein eigenes Gateway zu senden — Vercel AI Gateway, OpenRouter oder Cloudflare. Alles andere bleibt gleich.
FAQ
Warum gibt mein Jev-MCP-Key 401 authentication_error zurück?
Fast immer der endpoint. Ein gehosteter jv_live_-Key ist nur am jevtypesafeai.com-Gateway gültig, nicht an api.typesafe.ai. Aktualisiere jev-mcp (es erkennt jv_live_-Keys automatisch) oder setze JEV_BASE_URL=https://jevtypesafeai.com/api/v1/decide explizit.
Welchen Key braucht jev-mcp?
TYPESAFE_API_KEY (Aliasse JEV_API_KEY, JEV_KEY). Nutze einen gehosteten jv_live_-Key von jevtypesafeai.com/pricing oder einen offiziellen Key von console.typesafe.ai.
Muss ich JEV_BASE_URL setzen?
Im Normalbetrieb nein. jev-mcp wählt den endpoint aus deinem Key — jv_live_-Keys gehen zum gehosteten Gateway, offizielle Keys zu api.typesafe.ai. Setze es nur, um dein eigenes Gateway zu erzwingen.
Mit welchen MCP-Clients funktioniert jev-mcp?
Jeder MCP-Client — Claude Code, Cursor, Codex, OpenCode und andere. Nur der Speicherort der Konfigdatei unterscheidet sich; Befehl und Env sind gleich.
Wie fixiere ich eine Modellversion?
Setze JEV_MODEL, z. B. JEV_MODEL=jev-1.13.0, damit die Produktion auf einer festen Version bleibt statt auf jev-latest.
Siehe auch: Cursor-Integration · Claude-Code-Integration · jev-mcp & Open Source · jev-mcp & open source
Probiere Jev, bevor du es einbindest
Führe eine echte, typisierte Entscheidung im Browser aus — kostenlos, ohne Anmeldung — und setze dann deinen Key in das Beispiel oben ein.