Documentación / how to
Añade el servidor MCP de Jenks a tu cliente
Configura Claude Code, Claude Desktop, Cursor o ChatGPT para usar el servidor MCP de Jenks remoto o local, incluida la variante de administración.
Elige remoto o local
- Remoto —
https://jenksguo.pages.dev/mcp(HTTP con streaming, JSON-RPC 2.0). No hay nada que instalar. Úsalo cuando tu cliente sea compatible con servidores MCP remotos. - Local — el CLI
jenksejecuta un servidor MCP en stdio conjenks mcp. Reenvía las llamadas al sitio en vivo. Úsalo cuando tu cliente solo sea compatible con servidores locales (stdio).
Ambos exponen las mismas herramientas públicas: get_brief, list_experience, get_entry, list_lenses,
search_jenks, get_document y ask_jenks. Consulta la MCP tools reference.
Para instalar primero el CLI:
curl -fsSL https://jenksguo.pages.dev/downloads/install.sh | sh
jenks --version
Claude Code
Remoto:
claude mcp add --transport http jenks https://jenksguo.pages.dev/mcp
Local:
claude mcp add jenks -- jenks mcp
Compruébalo con /mcp dentro de Claude Code.
Claude Desktop
Edita claude_desktop_config.json y reinicia Claude Desktop. Para el servidor local:
{
"mcpServers": {
"jenks": { "command": "jenks", "args": ["mcp"] }
}
}
Si tu versión es compatible con servidores remotos, añade https://jenksguo.pages.dev/mcp como un conector personalizado en
la configuración de la app.
Cursor
Añade en ~/.cursor/mcp.json (o en .cursor/mcp.json del proyecto). Remoto:
{
"mcpServers": {
"jenks": { "url": "https://jenksguo.pages.dev/mcp" }
}
}
Local:
{
"mcpServers": {
"jenks": { "command": "jenks", "args": ["mcp"] }
}
}
ChatGPT
Donde tu plan y cliente de ChatGPT admitan conectores personalizados (modo desarrollador), crea un conector
con la URL del servidor https://jenksguo.pages.dev/mcp. No se necesita autenticación para las herramientas públicas.
Si los conectores no están disponibles, usa el botón Open in ChatGPT en
https://jenksguo.pages.dev/agents — inicia un chat que en su lugar lee los archivos públicos.
Cualquier otro cliente
Apúntalo a la URL remota o ejecuta jenks mcp como un comando stdio. Una solicitud GET a
https://jenksguo.pages.dev/mcp devuelve un documento de descubrimiento con la versión del protocolo, los nombres de las herramientas
y ejemplos de llamadas JSON-RPC:
curl -s https://jenksguo.pages.dev/mcp
Variante de administración (solo Jenks)
El servidor de administración añade las herramientas admin_* (lectura, validación, escritura, edición con IA, estado de despliegue, promoción).
Necesita un token de agente (jgx_agt_…) que Jenks crea en la consola — consulta
Give an AI agent access. Cada llamada se verifica frente a los alcances del token y se escribe en el registro de auditoría.
Remoto, con un encabezado:
claude mcp add --transport http jenks-admin https://jenksguo.pages.dev/mcp/admin \
--header "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
Local, con el token en el entorno:
export JENKSGUO_ADMIN_TOKEN=jgx_agt_… # de tu Llavero o gestor de contraseñas
jenks mcp --admin
En una configuración JSON, pasa el token a través de env en lugar de escribirlo en el archivo siempre que sea posible.
Nunca compartas un archivo de configuración que contenga el token.
Solución de problemas
- No aparecen las herramientas: reinicia el cliente; comprueba que
jenks --versionesté en tuPATH. 429deask_jenks: el asistente tiene limitación de velocidad; espera un minuto.401en/mcp/admin: el token falta, es incorrecto, ha caducado o fue revocado (el error indica cuál).403 missing_scope: al token le falta un alcance para esa herramienta; el mensaje lo indica.
.mdEsta página está traducida con ayuda de IA; los títulos oficiales permanecen en inglés.