Agregar el servidor MCP de Jenks a tu cliente

Elige remoto o local

• Remoto — https://jenksguo.xyz/mcp (Streamable HTTP, JSON-RPC 2.0). No requiere instalación. Úsalo cuando tu cliente admita servidores MCP remotos.
• Local — la CLI jenks ejecuta un servidor MCP por stdio con jenks mcp. Reenvía las llamadas al sitio en vivo. Úsalo cuando tu cliente solo admita 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 referencia de herramientas de MCP.

Para instalar primero la CLI:

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

Claude Code

Remoto:

claude mcp add --transport http jenks https://jenksguo.xyz/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 admite servidores remotos, agrega https://jenksguo.xyz/mcp como un conector personalizado en la configuración de la app.

Cursor

Agrega a ~/.cursor/mcp.json (o al .cursor/mcp.json del proyecto). Remoto:

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

Local:

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

ChatGPT

Cuando tu plan y cliente de ChatGPT admitan conectores personalizados (modo desarrollador), crea un conector con la URL del servidor https://jenksguo.xyz/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.xyz/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.xyz/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.xyz/mcp

Variante de administrador (solo Jenks)

El servidor de administrador agrega las herramientas admin_* (lectura, validación, escritura, edición con IA, estado de despliegue, promoción). Necesita el token personal de administrador, almacenado en el Keychain como agent-env:JENKSGUO_ADMIN_TOKEN.

Remoto, con un encabezado:

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

Local, con el token en el entorno:

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

En una configuración JSON, pasa el token mediante 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

• Las herramientas no aparecen: reinicia el cliente; verifica que jenks --version esté en tu PATH.
• 429 de ask_jenks: el asistente tiene límite de velocidad; espera un minuto.
• 401 en /mcp/admin: el token falta, es incorrecto o se ha rotado.