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

选择远程或本地

• 远程 — https://jenksguo.pages.dev/mcp（可流式 HTTP，JSON-RPC 2.0）。无需安装。 当你的客户端支持远程 MCP 服务器时使用。
• 本地 — 使用 jenks mcp 时，jenks CLI 会在 stdio 上运行一个 MCP 服务器。它会将调用转发到 在线站点。当你的客户端仅支持本地（stdio）服务器时使用。

两者都提供相同的公共工具：get_brief、list_experience、get_entry、list_lenses、 search_jenks、get_document 和 ask_jenks。参见 MCP 工具参考。

要先安装 CLI：

curl -fsSL https://jenksguo.pages.dev/downloads/install.sh | sh
jenks --version

Claude Code

远程：

claude mcp add --transport http jenks https://jenksguo.pages.dev/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.pages.dev/mcp 添加为自定义连接器。

Cursor

添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）。远程：

{
  "mcpServers": {
    "jenks": { "url": "https://jenksguo.pages.dev/mcp" }
  }
}

本地：

{
  "mcpServers": {
    "jenks": { "command": "jenks", "args": ["mcp"] }
  }
}

ChatGPT

当你的 ChatGPT 方案与客户端支持自定义连接器（开发者模式）时，创建一个连接器， 服务器 URL 使用 https://jenksguo.pages.dev/mcp。公共工具无需认证。 如果连接器不可用，请在 https://jenksguo.pages.dev/agents 上使用 Open in ChatGPT 按钮——它会启动一个读取公共文件的对话来替代。

任何其他客户端

将其指向远程 URL，或以 stdio 命令运行 jenks mcp。对 https://jenksguo.pages.dev/mcp 发起 GET 请求 会返回一个发现文档，其中包含协议版本、工具名称和示例 JSON-RPC 调用：

curl -s https://jenksguo.pages.dev/mcp

管理员变体（仅限 Jenks）

管理员服务器会新增 admin_* 工具（读取、验证、写入、AI 编辑、部署状态、晋级）。 它需要一个由 Jenks 在控制台创建的代理令牌（jgx_agt_…）——参见 向 AI 代理授予访问权限。每次调用都会根据令牌的权限范围进行检查，并记录到审计日志。

远程（使用请求头）：

claude mcp add --transport http jenks-admin https://jenksguo.pages.dev/mcp/admin \
  --header "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

本地（将令牌置于环境变量中）：

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # 来自你的钥匙串或密码管理器
jenks mcp --admin

在 JSON 配置中，尽可能通过 env 传递令牌，而不是把它写入文件。切勿分享包含令牌的配置文件。

故障排除

• 工具未显示：重启客户端；检查 jenks --version 是否在你的 PATH 中。
• 来自 ask_jenks 的 429：助手已触发限流；请稍等一分钟。
• 在 /mcp/admin 出现 401：令牌缺失、错误、过期或已撤销（错误信息会指明哪种情况）。
• 403 missing_scope：令牌缺少该工具所需的权限范围；消息会指出缺少的范围。