Servidor MCP

El servidor MCP (Model Context Protocol) publica operaciones del motor de Aseptic como tools para clientes de IA (Claude Code, Claude Desktop, Cursor…). Es la misma superficie que usa el copiloto de la app. Las tools se generan del registro de operaciones, así que MCP y CLI no divergen.

Hoy publica 92 tools, 2 resources y 6 prompts de flujo.

Superficie curada

No es un volcado del registro (115 operaciones): la IA opera el laboratorio —levantar, probar, mockear, depurar— y edita el catálogo (micros, escenarios, mocks, librerías y conexiones de BBDD). Lo que se queda fuera son los ajustes de la máquina —workspace, credenciales, arranque personal—, que son de la persona, y el trasiego de ficheros de catálogo entre máquinas. Nada se pierde: lo oculto sigue en aseptic ops, el CLI y el control server.

Conexión por stdio (la habitual)

El cliente lanza aseptic mcp como proceso hijo. Requiere el motor compilado (npm run build:electron) y conviene rutas absolutas y -p explícito (la carpeta del proyecto con .aseptic/).

Claude Code:

claude mcp add aseptic -- node C:\herramientas\aseptic\bin\aseptic.js mcp -p C:\proyectos\mi-proyecto

Claude Desktop / Cursor (claude_desktop_config.json o .cursor/mcp.json):

{
  "mcpServers": {
    "aseptic": {
      "command": "node",
      "args": ["C:\\herramientas\\aseptic\\bin\\aseptic.js", "mcp", "-p", "C:\\proyectos\\mi-proyecto"]
    }
  }
}

Con el ejecutable global (npm link), basta "command": "aseptic", "args": ["mcp", "-p", "..."].

Conexión por HTTP (motor vivo)

Con un motor vivo (la app abierta o el daemon), el mismo servidor está disponible por Streamable HTTP en la ruta /mcp del control server, para clientes que no lanzan procesos. La URL y el token salen de control.json; toda petición lleva Authorization: Bearer <token>.

Qué publica

• Tools — 90, agrupadas por dominio (ciclo de vida del escenario, depuración, Docker, catálogo, git, librerías, mocks…). Cada una lleva anotaciones readOnlyHint o destructiveHint cuando aplica, para que el cliente decida qué ejecutar sin confirmación.
• Resources — aseptic://guide (guía de operación para IAs, en markdown) y aseptic://status (snapshot JSON: versión, rutas, motor vivo, escenario activo y estado de sus micros).
• Prompts — seis recetas de flujo, una por fase: preparar-entorno, levantar-y-probar, arreglar-y-reintentar, adoptar-escenario, mockear-dependencia y depurar-micro.

Modelo de ejecución

Igual que el CLI: si hay motor vivo, la tool se ejecuta contra él (mismo estado que la UI); si no, las tools sin estado corren in-proc. scenario_up_and_wait lanza el daemon si falta; los micros sobreviven a la sesión MCP (cerrar el cliente de IA no los detiene; para pararlos, scenario_stop).

Acceso

En proyectos con login, el MCP exige la capacidad mcp (independiente de cli). Sin ella, stdio corta con exit 5 y HTTP responde 403. Ver Capacidades.

Ver también

• Copiloto — la misma superficie dentro de la app.
• Control server · Comandos del CLI