Servidor MCP

joppa mcp es un servidor MCP (Model Context Protocol) en stdio. Un asistente de código ve en él tus proyectos y sus dominios, inicia los servicios, lee sus registros, crea bases de datos o proyectos y lee el .env.

Conectar un asistente

Lo más sencillo: Ajustes › Línea de comandos › Conectar los asistentes. O desde la terminal:

joppa mcp install                           # Claude Code, Claude Desktop y Cursor, los que estén instalados
joppa mcp install --client cursor --dry-run # muestra lo que se escribiría
joppa mcp uninstall

Cliente	Dónde se registra Joppa
Claude Code	claude mcp add --scope user o, si no, su archivo de configuración
Claude Desktop	claude_desktop_config.json
Cursor	~/.cursor/mcp.json

Solo se escribe la entrada mcpServers.joppa; el resto del archivo no cambia. Después, reinicia el asistente.

--client acepta claude-code, claude-desktop, cursor o all.

Las herramientas

Herramienta	Función
get_status	Estado del proxy, de la CA, de los proyectos y de los servicios
list_projects	Los proyectos, sus dominios y su salud
list_services	Los servicios y su estado
start_service, stop_service	Inicia o detiene un servicio
service_logs	El registro de un servicio (lines: 100 por defecto, 2000 como máximo)
list_databases	Las bases de datos de un servidor y sus URL
create_database	Crea una base de datos (service, name, extensions)
get_env	El .env de un proyecto, con los secretos ocultos salvo con reveal
start_proxy, stop_proxy	Inicia o detiene el proxy
set_route_enabled	Activa o desactiva un dominio
add_project	Añade una carpeta, con sus dominios detectados o indicados
add_service	Añade un servicio (engine, version, port, start)
list_templates	Las plantillas de proyecto y sus opciones
create_project	Crea un proyecto desde una plantilla (dry_run para ver los comandos)
create_project_status	Sigue o cancela una creación en curso
open_app	Muestra la ventana de Joppa

Ejemplos de peticiones

• «Inicia PostgreSQL y crea una base de datos blog con pgvector.»
• «¿Por qué api.kinosante.test está sin conexión? Mira los logs.»
• «Crea un proyecto Astro docs en ~/Code y añádelo a Joppa.»