文件 / how to
將 Jenks MCP 伺服器加入你的用戶端
設定 Claude Code、Claude Desktop、Cursor 或 ChatGPT 使用遠端或本機的 Jenks MCP 伺服器(包含管理員版本)。
選擇遠端或本機
- 遠端 —
https://jenksguo.pages.dev/mcp(可串流 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.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 協助下翻譯;官方職稱保留英文。