Skip to main content
Jenks Guo

文件 / how to

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

設定 Claude Code、Claude Desktop、Cursor 或 ChatGPT 使用遠端或本機的 Jenks MCP 伺服器(包含管理員版本)。

選擇遠端或本機

  • 遠端 — https://jenksguo.pages.dev/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.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_…)— 參見 Give an AI agent access。每次呼叫都會依據權杖的範圍進行檢查,並寫入稽核記錄。

遠端(使用標頭):

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_…   # from your Keychain or password manager
jenks mcp --admin

在 JSON 設定中,盡可能透過 env 傳遞權杖,而不要將它寫入檔案。切勿分享包含權杖的設定檔。

疑難排解

  • 工具未出現:重新啟動用戶端;確認 jenks --version 已在你的 PATH 中。
  • 來自 ask_jenks 的 429:助理已達速率限制;請稍候一分鐘。
  • /mcp/admin 回傳 401:權杖遺失、錯誤、過期或已撤銷(錯誤訊息會指出是哪一種)。
  • 403 missing_scope:該工具所需的範圍在權杖中不存在;訊息會指出缺少的範圍。

.md本頁內容在 AI 協助下翻譯;官方職稱保留英文。