在 Claude Code 中使用 Jev:MCP 工具、Skills 和代码集成说明
Claude Code 可以用三种方式使用 Jev:作为会话中随时调用的 MCP 工具;作为 Agent Skills,教它写出好的问题集;以及当你想把 Jev 接进自己的代码时,一次粘贴就够的接入说明。本页把三者都配好。
开始之前
你需要 Claude Code 和一个 JevStation 账号。新账号注册即送 200 点,无需信用卡。在「设置 › API Keys」创建一个 Key,写进 shell 配置文件:
export JEVSTATION_API_KEY="sk_..."
想先看看 Jev 会返回什么?试验台不用账号就能运行预设。
第 1 步:添加 MCP Server
Claude Code 用 claude mcp add 注册远程服务器。JevStation 的服务器使用 HTTP 传输和 Bearer 请求头:
claude mcp add --transport http jevstation https://jevstation.com/api/mcp \
--header "Authorization: Bearer $JEVSTATION_API_KEY"
请求头写在双引号里,所以运行命令时由 shell 把 Key 替换进去,Claude Code 把替换后的请求头存进配置。这就是为什么必须先设置环境变量。
选择 scope。 Claude Code 有三种:
| Scope | 参数 | 存放位置 | 适用场景 |
|---|---|---|---|
| Local(默认) | --scope local | ~/.claude.json,按项目区分 | 在一个仓库里试用 Jev |
| User | --scope user | ~/.claude.json | 在所有项目里使用 Jev |
| Project | --scope project | 仓库里的 .mcp.json | 与团队共享配置 |
让 Jev 在所有项目中可用:
claude mcp add --transport http --scope user jevstation https://jevstation.com/api/mcp \
--header "Authorization: Bearer $JEVSTATION_API_KEY"
团队共享时,不要用这条命令加 project scope——它会把你的明文 Key 写进 .mcp.json。改为手写这个文件,让 Claude Code 在连接时从每位开发者自己的环境变量展开:
{
"mcpServers": {
"jevstation": {
"type": "http",
"url": "https://jevstation.com/api/mcp",
"headers": { "Authorization": "Bearer ${JEVSTATION_API_KEY}" }
}
}
}
项目级服务器第一次被使用时,Claude Code 会请每个人确认。
第 2 步:安装 Skills
三个 Agent Skills 教 Claude 用好 Jev:
- jev-api——请求和答案格式、错误码、费用、MCP 工具。
- jev-question-design——怎样写出概率可靠的 Choice、Score 和 Noul 问题。
- jev-guardrails——筛查不可信输入,并在工具调用执行前做检查。
安装到 ~/.claude/skills:
curl -fsSL https://jevstation.com/skills/install.sh | sh
脚本只下载三个 SKILL.md 文件。如果只想装进某个仓库,设置 SKILLS_DIR:
curl -fsSL https://jevstation.com/skills/install.sh | SKILLS_DIR=.claude/skills sh
Claude Code 在运行中的会话里就能发现新 Skill,并在任务与 Skill 描述匹配时自动加载。也可以直接调用,例如 /jev-question-design。
第 3 步:让 Claude 完成代码集成
MCP 工具用于 Claude 在会话中做判断。如果你想把 Jev 放进自己的应用——工单路由、答案评分、Agent 循环里的守卫——打开 API 文档,点击 Copy for AI。它会复制一份精简的接入说明:端点、通过 JEVSTATION_API_KEY 鉴权、问题和答案格式、错误码、费用以及验证清单。把它和你的需求一起粘贴给 Claude Code:
这是 JevStation 的接入说明。在我们的工单服务里加一个函数:每张新工单发给 Jev,带一个分配团队的 Choice 和一个紧急程度的 Score,按概率路由。Key 从环境变量读取,并处理 402、429 和 502。
说明里也告诉 Claude:请求中的 model 字段会被忽略,应当把每次决策的 data.model 记进日志。
可以试试的提示词
服务器连上之后,下面这些可以直接用:
- “列出我的 Jev 工具,再列出我保存的问题集。”——免费,顺便确认连接。
- “用
jev_decide判断这条评价是正面、中性还是负面,并告诉我各自的概率:……” - “运行这个迁移之前,先用
jev_guard_tool_call检查一下。我的原始要求是:清理 staging 里的旧测试数据。” - “对这五条提示词分别调用
jev_route_model,告诉我哪些需要 frontier 模型。” - “按照 jev-question-design Skill,起草一套给客服回复打分的 Jev 问题集,然后用
jev_decide在这两条回复上测试。” - “用我保存的问题集
qs_…跑一下samples/ticket.txt里的文本。”
根据你的权限设置,Claude Code 可能会在调用工具前先征求同意。每次评估都会返回 credits.charged,方便你留意花费。
验证配置
claude mcp list能看到jevstation,claude mcp get jevstation显示正确的 URL。- 在 Claude Code 里运行
/mcp,服务器显示为已连接,带五个工具。如果失败,通常是 401——见下文。 - 让 Claude 运行
jev_list_question_sets,应当成功且不消耗点数。 - 跑一次
jev_decide,确认结果里有model、answers和credits.remaining。
出问题时
- 连接失败 / 401。 缺少请求头或 Key 不对。先检查
echo $JEVSTATION_API_KEY,然后claude mcp remove jevstation再重新添加。 - 工具返回错误。 工具错误会作为可读的结果返回,比如点数不足、触发限流、问题集无效,或评估失败并已退点。Claude 通常能修正输入后重试。完整列表见 MCP Server 页面。
- Key 泄露。 到「设置 › API Keys」删除它,新建一个,再重新运行
claude mcp add。
永远不要把 Key 粘贴进提示词或工具参数;让它留在环境变量里。
参考资料
写法于 2026-09-28 对照以下文档核对:
- Claude Code MCP:https://code.claude.com/docs/en/mcp
- Claude Code Skills:https://code.claude.com/docs/en/skills
常见问题
- MCP Server 和 Skills 都要装吗?
- 不必。MCP Server 让 Claude 在会话中调用 Jev;Skills 是一组说明,帮助 Claude 写问题集和集成代码。很多人两个都装,但单独用任何一个都可以。
- claude mcp add 该用哪个 scope?
- 想在所有项目里用 Jev,用 --scope user;只在一个项目里用,保持默认的 local。团队共享时,提交一个项目级 .mcp.json,从 ${JEVSTATION_API_KEY} 读取 Key,这样 Key 永远不会进 git。
- 在 Claude Code 里调用 Jev 要消耗点数吗?
- 要,和 API 一样:标准范围内每次评估 1 点,超出 3 点。列出工具和已保存的问题集免费,评估失败自动退点。
- 为什么 /mcp 显示服务器连接失败?
- 通常是缺少 Authorization 请求头或 Key 不对,服务器返回了 401。确认运行 claude mcp add 时 JEVSTATION_API_KEY 已经设置,然后删除服务器重新添加。
相关页面
把它接进你的流程
注册即送 200 点,保存自己的问题集,并通过 API 调用同样的评估。