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 です — 下の落とし穴を参照。新規に設定するなら 2 行です。

インストール

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_..." }
    }
  }
}

5 つのツール

• jev_classify — ラベル付き選択肢の 1 つを選ぶ(ルーティング、分類、意図)
• jev_score — 定義した順序スケールで入力を採点(リスク、緊急度、品質)
• jev_check — 校正済みの yes/no 確率(ゲート、フィルタ、ガードレール)
• jev_gate — 実行前に操作をリスク審査 → allow / confirm / block
• jev_decide — フルパワー:1 往復で多くの型付き質問

環境変数

必須はキーだけ — 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