Skip to main content
JGJenks Guo

Dokumentaro / how to

Aldonu la Jenks MCP-servilon al via kliento

Agordu Claude Code, Claude Desktop, Cursor aŭ ChatGPT por uzi la foran aŭ lokan Jenks MCP-servilon, inkluzive de la administra varianto.

Elektu foran aŭ lokan

  • Fora — https://jenksguo.xyz/mcp (Streamable HTTP, JSON-RPC 2.0). Nenion instali. Uzu ĝin kiam via kliento subtenas forajn MCP-servilojn.
  • Loka — la jenks CLI rulas MCP-servilon per stdio kun jenks mcp. Ĝi plusendas vokojn al la aktiva retejo. Uzu ĝin kiam via kliento nur subtenas lokajn (stdio) servilojn.

Ambaŭ elmetas la samajn publikajn ilojn: get_brief, list_experience, get_entry, list_lenses, search_jenks, get_document kaj ask_jenks. Vidu la referencon pri MCP-iloj (/agents/docs/reference/mcp-tools).

Por unue instali la CLI:

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

Claude Code

Fora:

claude mcp add --transport http jenks https://jenksguo.xyz/mcp

Loka:

claude mcp add jenks -- jenks mcp

Kontrolu per /mcp ene de Claude Code.

Claude Desktop

Redaktu claude_desktop_config.json kaj restartigu Claude Desktop. Por la loka servilo:

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

Se via versio subtenas forajn servilojn, anstataŭe aldonu https://jenksguo.xyz/mcp kiel propran konektilon en la agordoj de la aplikaĵo.

Cursor

Aldonu al ~/.cursor/mcp.json (aŭ la .cursor/mcp.json de la projekto). Fora:

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

Loka:

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

ChatGPT

Kie via ChatGPT-plano kaj kliento subtenas proprajn konektilojn (programista reĝimo), kreu konektilon kun la servila URL https://jenksguo.xyz/mcp. Neniu aŭtentigo necesas por la publikaj iloj. Se konektiloj ne disponeblas, uzu la butonon Open in ChatGPT ĉe https://jenksguo.xyz/agents — ĝi komencas babiladon kiu anstataŭe legas la publikajn dosierojn.

Ajna alia kliento

Direktu ĝin al la fora URL, aŭ rulu jenks mcp kiel stdio-komandon. GET-peto al https://jenksguo.xyz/mcp liveras malkovran dokumenton kun la protokola versio, la ilonomoj kaj ekzemplaj JSON-RPC-vokoj:

curl -s https://jenksguo.xyz/mcp

Admin-varianto (nur por Jenks)

La administra servilo aldonas la ilojn admin_* (legi, validigi, verki, AI-redakti, deploj-stato, promocio). Ĝi bezonas la personan administran ĵetonon, konservitan en la Keychain kiel agent-env:JENKSGUO_ADMIN_TOKEN.

Fora, kun kaplinio:

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

Loka, kun la ĵetono en la medio:

export JENKSGUO_ADMIN_TOKEN="$(security find-generic-password -s agent-env:JENKSGUO_ADMIN_TOKEN -w)"
jenks mcp --admin

En JSON-agordo, transdonu la ĵetonon per env prefere ol verki ĝin en la dosieron kie eble. Neniam kundividu agordan dosieron kiu enhavas la ĵetonon.

Solvado de problemoj

  • Iloj ne aperas: restartigu la klienton; kontrolu ke jenks --version estas en via PATH.
  • 429 de ask_jenks: la asistanto estas rapidec-limigita; atendu unu minuton.
  • 401 ĉe /mcp/admin: la ĵetono mankas, estas malĝusta aŭ rotaciigita.

.mdĈi tiu paĝo estas tradukita kun helpo de AI; oficialaj titoloj restas en la angla.