Skip to main content
JGJenks Guo

文件 / how to

將 Jenks MCP 伺服器加入你的用戶端

設定 Claude Code、Claude Desktop、Cursor 或 ChatGPT 使用遠端或本機的 Jenks MCP 伺服器,包括管理員變體。

選擇遠端或本機

  • 遠端 — https://jenksguo.xyz/mcp (可串流的 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 協助下翻譯;官方職稱保留英文。