Serveur MCP

Le serveur MCP (Model Context Protocol) publie des opérations du moteur de Aseptic comme tools pour les clients d’IA (Claude Code, Claude Desktop, Cursor…). C’est la même surface qu’utilise le copilote de l’app. Les tools sont générés du registre d’opérations, donc MCP et CLI ne divergent pas.

Aujourd’hui il publie 92 tools, 2 resources et 6 prompts de flux.

Surface curée

Ce n’est pas un vidage du registre (115 opérations) : l’IA opère le laboratoire —lancer, tester, mocker, déboguer— et édite le catalogue (micros, scénarios, mocks, bibliothèques et connexions de BDD). Ce qui reste dehors, ce sont les paramètres de la machine —workspace, identifiants, démarrage personnel—, qui sont de la personne, et le déplacement de fichiers de catalogue entre machines. Rien n’est perdu : le caché est toujours dans aseptic ops, le CLI et le control server.

Connexion en stdio (l’habituelle)

Le client lance aseptic mcp comme processus enfant. Il nécessite le moteur compilé (npm run build:electron) et il est conseillé d’utiliser des chemins absolus et un -p explicite (le dossier du projet avec .aseptic/).

Claude Code :

claude mcp add aseptic -- node C:\outils\aseptic\bin\aseptic.js mcp -p C:\projets\mon-projet

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

{
  "mcpServers": {
    "aseptic": {
      "command": "node",
      "args": ["C:\\outils\\aseptic\\bin\\aseptic.js", "mcp", "-p", "C:\\projets\\mon-projet"]
    }
  }
}

Avec l’exécutable global (npm link), "command": "aseptic", "args": ["mcp", "-p", "..."] suffit.

Connexion en HTTP (moteur actif)

Avec un moteur actif (l’app ouverte ou le daemon), le même serveur est disponible en Streamable HTTP à la route /mcp du control server, pour les clients qui ne lancent pas de processus. L’URL et le token viennent de control.json ; chaque requête porte Authorization: Bearer <token>.

Ce qu’il publie

• Tools — 90, groupés par domaine (cycle de vie du scénario, débogage, Docker, catalogue, git, bibliothèques, mocks…). Chacun porte des annotations readOnlyHint ou destructiveHint lorsqu’elles s’appliquent, pour que le client décide quoi exécuter sans confirmation.
• Resources — aseptic://guide (guide d’opération pour IAs, en markdown) et aseptic://status (snapshot JSON : version, chemins, moteur actif, scénario actif et état de ses micros).
• Prompts — six recettes de flux, une par phase : preparar-entorno, levantar-y-probar, arreglar-y-reintentar, adoptar-escenario, mockear-dependencia et depurar-micro.

Modèle d’exécution

Comme le CLI : s’il y a un moteur actif, le tool s’exécute contre lui (même état que l’UI) ; sinon, les tools sans état tournent in-proc. scenario_up_and_wait lance le daemon s’il manque ; les micros survivent à la session MCP (fermer le client d’IA ne les arrête pas ; pour les arrêter, scenario_stop).

Accès

Dans les projets avec connexion, le MCP exige la capacité mcp (indépendante de cli). Sans elle, stdio se termine avec exit 5 et HTTP répond 403. Voir Capacités.

Voir aussi

• Copilote — la même surface dans l’app.
• Control server · Commandes du CLI