文档 / how to
将 Jenks MCP 服务器添加到你的客户端
配置 Claude Code、Claude Desktop、Cursor 或 ChatGPT 使用远程或本地的 Jenks MCP 服务器(包括管理员变体)。
选择远程或本地
- 远程 —
https://jenksguo.xyz/mcp(Streamable HTTP,JSON-RPC 2.0)。无需安装。 当你的客户端支持远程 MCP 服务器时使用。 - 本地 — 使用
jenksCLI 通过jenks mcp在 stdio 上运行 MCP 服务器。它会将调用转发到 在线站点。当你的客户端只支持本地(stdio)服务器时使用。
二者都提供相同的公共工具:get_brief、list_experience、get_entry、list_lenses、
search_jenks、get_document 和 ask_jenks。参见 MCP tools reference。
首先安装 CLI:
curl -fsSL https://jenksguo.xyz/downloads/install.sh | sh
jenks --version
Claude Code
远程:
claude mcp add --transport http jenks https://jenksguo.xyz/mcp
本地:
claude mcp add jenks -- jenks mcp
在 Claude Code 内使用 /mcp 检查。
Claude Desktop
编辑 claude_desktop_config.json 并重启 Claude Desktop。对于本地服务器:
{
"mcpServers": {
"jenks": { "command": "jenks", "args": ["mcp"] }
}
}
如果你的版本支持远程服务器,请在应用设置中添加 https://jenksguo.xyz/mcp 作为自定义连接器。
Cursor
添加到 ~/.cursor/mcp.json(或项目的 .cursor/mcp.json)。远程:
{
"mcpServers": {
"jenks": { "url": "https://jenksguo.xyz/mcp" }
}
}
本地:
{
"mcpServers": {
"jenks": { "command": "jenks", "args": ["mcp"] }
}
}
ChatGPT
当你的 ChatGPT 方案与客户端支持自定义连接器(开发者模式)时,创建一个连接器,
服务器 URL 使用 https://jenksguo.xyz/mcp。公共工具无需认证。
如果连接器不可用,请在 https://jenksguo.xyz/agents 上使用 Open in ChatGPT 按钮——它会启动一个聊天,改为读取公共文件。
其他任意客户端
将其指向远程 URL,或以 stdio 命令运行 jenks mcp。对
https://jenksguo.xyz/mcp 发起 GET 请求会返回一个发现文档,其中包含协议版本、工具名称
和示例 JSON-RPC 调用:
curl -s https://jenksguo.xyz/mcp
管理员变体(仅限 Jenks)
管理员服务器添加了 admin_* 工具(读取、验证、写入、AI 编辑、部署状态、提升)。
它需要个人管理员令牌,保存在钥匙串中,名称为 agent-env:JENKSGUO_ADMIN_TOKEN。
远程,使用请求头:
claude mcp add --transport http jenks-admin https://jenksguo.xyz/mcp/admin \
--header "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
本地,在环境中提供令牌:
export JENKSGUO_ADMIN_TOKEN="$(security find-generic-password -s agent-env:JENKSGUO_ADMIN_TOKEN -w)"
jenks mcp --admin
在 JSON 配置中,尽可能通过 env 传递令牌,而不是将其写入文件。
切勿分享包含令牌的配置文件。
故障排除
- 工具未出现:重启客户端;检查
jenks --version是否在你的PATH中。 - 来自
ask_jenks的429:助手被限流;请等待一分钟。 /mcp/admin返回401:令牌缺失、错误或已轮换。
.md本页内容在 AI 协助下翻译;官方职位名称保留英文。