Jev MCP Server：把带类型的判定变成任何 Agent 都能调用的工具

这是一个什么样的服务器

端点是 https://jevstation.com/api/mcp，使用无状态模式的 MCP Streamable HTTP 传输：

• 只接受 POST。 每个请求是一条 JSON-RPC 消息，或最多 20 条的批量消息。回复以 application/json 返回。GET 和 DELETE 返回 405。
• 没有会话，没有流。 服务端从不开 SSE 流，也不下发会话 id。
• 只有 tools。 实现了 initialize、ping、tools/list 和 tools/call，没有 resources、prompts 或 sampling。
• API Key 鉴权。 每个请求都必须带 Authorization: Bearer <key>。不支持 OAuth。
• 协议版本接受 2025-06-18、2025-03-26 和 2024-11-05。

工具背后走的是与 POST /api/v1/systemone 同一段代码，所以答案、点数、退点和限额完全一致。完整的答案格式见 API 文档。

五个工具

state 可以是纯文本，也可以是 JSON 对象或数组，最多 24,000 字符。questions 是 id 到问题的映射，每次最多 12 个：

{
  "state": "I was charged twice and support has not replied in 3 days.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should handle this ticket?",
      "criteria": {
        "billing": "Payments and refunds",
        "tech": "Bugs and outages"
      }
    },
    "churn_risk": {
      "type": "noul",
      "instructions": "Is the customer at risk of churning?"
    }
  }
}

jev_route_model 和 jev_guard_tool_call 使用固定的问题集——就是 LLM 路由器和工具调用守卫页面背后的那两套——所以 Agent 只需要提供内容。

每次成功调用都会把结果返回两份：一份 JSON 文本给模型读，一份 structuredContent 给能解析 JSON 的客户端。两份都包含 questions（实际提问的问题集）、model、answers、usage、credits（charged 和 remaining）以及 latency_ms。

接入客户端

在「设置 › API Keys」创建一个 Key，导出为 JEVSTATION_API_KEY。下面的写法均已于 2026-09-28 对照各客户端的官方文档核对过。

Claude Code——一条命令，保存在你的用户级或本地配置里：

claude mcp add --transport http jevstation https://jevstation.com/api/mcp \
  --header "Authorization: Bearer $JEVSTATION_API_KEY"

也可以提交一个项目级 .mcp.json，从每位开发者自己的环境变量读取 Key：

{
  "mcpServers": {
    "jevstation": {
      "type": "http",
      "url": "https://jevstation.com/api/mcp",
      "headers": { "Authorization": "Bearer ${JEVSTATION_API_KEY}" }
    }
  }
}

详见在 Claude Code 中使用 Jev。

Cursor——~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "jevstation": {
      "url": "https://jevstation.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:JEVSTATION_API_KEY}" }
    }
  }
}

详见在 Cursor 中使用 Jev。

VS Code（GitHub Copilot Agent 模式）——.vscode/mcp.json，Key 只在首次启动时询问一次，由 VS Code 保存，不写进文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "jevstation-key",
      "description": "JevStation API Key",
      "password": true
    }
  ],
  "servers": {
    "jevstation": {
      "type": "http",
      "url": "https://jevstation.com/api/mcp",
      "headers": { "Authorization": "Bearer ${input:jevstation-key}" }
    }
  }
}

其他客户端——只要支持带自定义请求头的远程 Streamable HTTP 服务器，就用同样的 URL 和请求头。也可以手动检查服务器，tools/list 不消耗点数：

curl -s https://jevstation.com/api/mcp \
  -H "Authorization: Bearer $JEVSTATION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

计费

工具调用与 API、试验台共用同一个点数余额。一次评估在 state 不超过 8,000 字符且不超过 5 个问题时消耗 1 点，超过任一限制消耗 3 点。initialize、tools/list 和 jev_list_question_sets 免费。评估失败或没有返回答案时，点数自动退回。新账号注册即送 200 点；点数包见定价页。

排错

• 连接时报 401。 Key 缺失、写错或已删除，或者请求头没有送到服务器——常见原因是客户端启动时环境变量还没设置。服务端会在任何工具运行之前直接返回 HTTP 401。必要时新建一个 Key，然后重启客户端。
• 工具错误以结果形式返回。 通过鉴权之后，调用本身的问题会作为普通结果返回，带 isError: true 和一段 Agent 能读懂的说明，而不是协议错误。常见情况：state 格式不对或为空、state 过大、问题无效、question_set_id 不存在。
• 点数不足（HTTP API 中的 402）。 通过 MCP 时是一个 isError 结果，写明本次费用和你的余额。到定价页充值。
• 触发限流（HTTP API 中的 429）。 同样是 isError 结果。稍等再重试，避免紧密循环；用同一个 Key 请求 GET /api/v1/systemone 可以查看当前额度。
• 评估失败。 结果会说明点数已退回，可以放心重试。
• 未知工具。 以 JSON-RPC 错误返回。在客户端里刷新工具列表。

安全须知

• Key 能消耗点数。 拿到它的人可以用你的余额跑评估，请像对待密码一样保管。
• 把 Key 放在环境变量里（JEVSTATION_API_KEY），或放进客户端的密钥输入。绝不要提交写着明文 Key 的配置文件——共享文件里请用 ${JEVSTATION_API_KEY} 或 ${env:JEVSTATION_API_KEY} 这类变量引用。
• 不要把密钥放进工具参数。 state 和 tool_args 会被发送给模型评估。守卫工具调用时，先把 token、密码和连接串脱敏。
• Key 泄露后到「设置 › API Keys」删除，再新建一个。
• Jev 是过滤器，不是安全边界。 在 jev_guard_tool_call 之下仍要保留白名单和权限控制；用 Jev 构建 Agent Harness讲了这些部件如何组合。

参考资料

客户端写法于 2026-09-28 对照以下文档核对：

• Claude Code MCP：https://code.claude.com/docs/en/mcp
• Cursor MCP：https://cursor.com/docs/mcp
• VS Code MCP 配置参考：https://code.visualstudio.com/docs/agents/reference/mcp-configuration