Skip to main content
JGJenks Guo

文档 / how to

将 Jenks MCP 服务器添加到你的客户端

配置 Claude Code、Claude Desktop、Cursor 或 ChatGPT 使用远程或本地的 Jenks MCP 服务器(包括管理员变体)。

选择远程或本地

  • 远程 — https://jenksguo.xyz/mcp(Streamable HTTP,JSON-RPC 2.0)。无需安装。 当你的客户端支持远程 MCP 服务器时使用。
  • 本地 — 使用 jenks CLI 通过 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 协助下翻译;官方职位名称保留英文。