MCP-Server

Der MCP-Server (Model Context Protocol) veröffentlicht Operationen der Aseptic-Engine als Tools für KI-Clients (Claude Code, Claude Desktop, Cursor…). Es ist dieselbe Oberfläche, die der Copilot der App nutzt. Die Tools werden aus dem Operationsregister generiert, sodass MCP und CLI nicht auseinanderlaufen.

Heute veröffentlicht er 92 Tools, 2 Resources und 6 Ablauf-Prompts.

Kuratierte Oberfläche

Es ist kein Abbild des Registers (115 Operationen): Die KI bedient das Labor —starten, testen, mocken, debuggen— und bearbeitet den Katalog (Micros, Szenarien, Mocks, Bibliotheken und Datenbankverbindungen). Draußen bleiben die Maschineneinstellungen —Workspace, Zugangsdaten, persönlicher Start—, die der Person gehören, und das Verschieben von Katalogdateien zwischen Maschinen. Nichts geht verloren: Das Verborgene ist weiterhin in aseptic ops, im CLI und im Control server.

Verbindung über stdio (die übliche)

Der Client startet aseptic mcp als Kindprozess. Er benötigt die kompilierte Engine (npm run build:electron), und es ist ratsam, absolute Pfade und ein explizites -p zu verwenden (der Projektordner mit .aseptic/).

Claude Code:

claude mcp add aseptic -- node C:\werkzeuge\aseptic\bin\aseptic.js mcp -p C:\projekte\mein-projekt

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

{
  "mcpServers": {
    "aseptic": {
      "command": "node",
      "args": ["C:\\werkzeuge\\aseptic\\bin\\aseptic.js", "mcp", "-p", "C:\\projekte\\mein-projekt"]
    }
  }
}

Mit der globalen ausführbaren Datei (npm link) genügt "command": "aseptic", "args": ["mcp", "-p", "..."].

Verbindung über HTTP (aktive Engine)

Mit einer aktiven Engine (die App offen oder der Daemon) ist derselbe Server über Streamable HTTP an der Route /mcp des Control servers verfügbar, für Clients, die keine Prozesse starten. Die URL und das Token kommen aus control.json; jede Anfrage trägt Authorization: Bearer <token>.

Was er veröffentlicht

• Tools — 90, nach Domäne gruppiert (Szenario-Lebenszyklus, Debugging, Docker, Katalog, Git, Bibliotheken, Mocks…). Jedes trägt readOnlyHint- oder destructiveHint-Annotationen, wo es zutrifft, damit der Client entscheidet, was ohne Bestätigung auszuführen ist.
• Resources — aseptic://guide (Bedienungsleitfaden für KIs, in Markdown) und aseptic://status (JSON-Snapshot: Version, Pfade, aktive Engine, aktives Szenario und Status seiner Micros).
• Prompts — sechs Ablaufrezepte, eines pro Phase: preparar-entorno, levantar-y-probar, arreglar-y-reintentar, adoptar-escenario, mockear-dependencia und depurar-micro.

Ausführungsmodell

Wie das CLI: Wenn es eine aktive Engine gibt, wird das Tool gegen sie ausgeführt (gleicher Zustand wie die UI); wenn nicht, laufen die zustandslosen Tools in-proc. scenario_up_and_wait startet den Daemon, wenn er fehlt; die Micros überleben die MCP-Sitzung (das Schließen des KI-Clients stoppt sie nicht; zum Stoppen scenario_stop).

Zugriff

In Projekten mit Anmeldung erfordert das MCP die Fähigkeit mcp (unabhängig von cli). Ohne sie endet stdio mit exit 5 und HTTP antwortet 403. Siehe Fähigkeiten.

Siehe auch

• Copilot — die gleiche Oberfläche in der App.
• Control server · CLI-Befehle