Server MCP

Il server MCP (Model Context Protocol) pubblica operazioni del motore di Aseptic come tool per client di IA (Claude Code, Claude Desktop, Cursor…). È la stessa superficie che usa il copilota dell’app. I tool sono generati dal registro di operazioni, quindi MCP e CLI non divergono.

Oggi pubblica 92 tool, 2 resource e 6 prompt di flusso.

Superficie curata

Non è uno scarico del registro (115 operazioni): l’IA opera il laboratorio —avviare, testare, fare mock, fare debug— e modifica il catalogo (micro, scenari, mock, librerie e connessioni di DB). Restano fuori le impostazioni della macchina —workspace, credenziali, avvio personale—, che sono della persona, e lo spostamento di file di catalogo tra macchine. Nulla si perde: il nascosto resta in aseptic ops, nella CLI e nel control server.

Connessione via stdio (quella abituale)

Il client avvia aseptic mcp come processo figlio. Richiede il motore compilato (npm run build:electron) e conviene usare percorsi assoluti e un -p esplicito (la cartella del progetto con .aseptic/).

Claude Code:

claude mcp add aseptic -- node C:\strumenti\aseptic\bin\aseptic.js mcp -p C:\progetti\il-mio-progetto

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

{
  "mcpServers": {
    "aseptic": {
      "command": "node",
      "args": ["C:\\strumenti\\aseptic\\bin\\aseptic.js", "mcp", "-p", "C:\\progetti\\il-mio-progetto"]
    }
  }
}

Con l’eseguibile globale (npm link), basta "command": "aseptic", "args": ["mcp", "-p", "..."].

Connessione via HTTP (motore attivo)

Con un motore attivo (l’app aperta o il daemon), lo stesso server è disponibile via Streamable HTTP alla rotta /mcp del control server, per client che non avviano processi. L’URL e il token vengono da control.json; ogni richiesta porta Authorization: Bearer <token>.

Cosa pubblica

• Tool — 90, raggruppati per dominio (ciclo di vita dello scenario, debug, Docker, catalogo, git, librerie, mock…). Ciascuno porta annotazioni readOnlyHint o destructiveHint dove si applicano, così il client decide cosa eseguire senza conferma.
• Resource — aseptic://guide (guida operativa per IA, in markdown) e aseptic://status (snapshot JSON: versione, percorsi, motore attivo, scenario attivo e stato dei suoi micro).
• Prompt — sei ricette di flusso, una per fase: preparar-entorno, levantar-y-probar, arreglar-y-reintentar, adoptar-escenario, mockear-dependencia e depurar-micro.

Modello di esecuzione

Come la CLI: se c’è un motore attivo, il tool si esegue contro di lui (stesso stato dell’UI); altrimenti, i tool senza stato girano in-proc. scenario_up_and_wait avvia il daemon se manca; i micro sopravvivono alla sessione MCP (chiudere il client di IA non li ferma; per fermarli, scenario_stop).

Accesso

Nei progetti con accesso, il MCP esige la capacità mcp (indipendente da cli). Senza di essa, stdio termina con exit 5 e HTTP risponde 403. Vedi Capacità.

Vedi anche

• Copilota — la stessa superficie dentro l’app.
• Control server · Comandi della CLI