Aldonu la Jenks MCP-servilon al via kliento

Elektu foran aŭ lokan

• Fora — https://jenksguo.pages.dev/mcp (Streamable HTTP, JSON-RPC 2.0). Nenio instalenda. 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 viva retejo. Uzu ĝin kiam via kliento subtenas nur lokajn (stdio) servilojn.

Ambaŭ elmontras la samajn publikajn ilojn: get_brief, list_experience, get_entry, list_lenses, search_jenks, get_document kaj ask_jenks. Vidu la MCP tools reference.

Por unue instali la CLI:

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

Claude Code

Fora:

claude mcp add --transport http jenks https://jenksguo.pages.dev/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, aldonu https://jenksguo.pages.dev/mcp kiel propran konektilon en la agordoj de la aplikaĵo anstataŭe.

Cursor

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

{
  "mcpServers": {
    "jenks": { "url": "https://jenksguo.pages.dev/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.pages.dev/mcp. Neniu aŭtentigo necesas por la publikaj iloj. Se konektiloj ne disponeblas, uzu la butonon Malfermi en ChatGPT ĉe https://jenksguo.pages.dev/agents — ĝi startigas babilejon kiu anstataŭe legas la publikajn dosierojn.

Iu ajn alia kliento

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

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

Admin-varianto (nur por Jenks)

La admin-servilo aldonas la ilojn admin_* (legi, validigi, skribi, AI-redakti, stato de deplojado, promocii). Ĝi bezonas agentan ĵetonon (jgx_agt_…) kiun Jenks kreas en la konzolo — vidu Give an AI agent access. Ĉiu voko estas kontrolata laŭ la atingosferoj de la ĵetono kaj skribata en la kontrolprotokolon.

Fora, kun HTTP-kaplinio:

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

Loke, kun la ĵetono en la medio:

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # el via Keychain aŭ pasvort-manaĝero
jenks mcp --admin

En JSON-agordo, transdonu la ĵetonon per env prefere ol skribi ĝin en la dosieron kiam eble. Neniam dividu agordan dosieron kiu enhavas la ĵetonon.

Problemosolvado

• 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, eksvalidiĝinta aŭ revokita (la eraro diras kio).
• 403 missing_scope: la ĵetono mankas atingosferon por tiu ilo; la mesaĝo nomas ĝin.