MASAIC aus deinem Coding-Agent steuern
Verbinde Claude Code, Codex, Cursor, Windsurf oder Claude Desktop über MCP mit deinem MASAIC-Workspace und verwalte Agents, Skills, Tests und Automations, indem du fragst.
MASAIC betreibt einen MCP-Server. MCP (Model Context Protocol) ist ein Standard, über den ein AI-Assistent externe Tools nutzt — sobald dein Coding-Agent verbunden ist, kann er deinen Workspace lesen und ändern, weil du ihn in normaler Sprache darum bittest.
Das hilft, wenn du weißt was du willst, aber nicht wo es in der Console steckt, wenn eine Änderung ein Dutzend Agents betrifft, oder wenn du eine Änderung lieber beschreibst als klickst.
Was du brauchst
| Was | Wofür |
|---|---|
Die masaic CLI | Sie richtet die Verbindung ein und hält deine Anmeldung (installieren) |
| Einen Coding-Agent | Claude Code, Codex CLI, Cursor, Windsurf oder Claude Desktop |
| Zugriff auf ein Projekt | Der Assistent sieht genau das, was du sehen kannst (Teams und Zugriff) |
Verbinden
Einmal anmelden, dann den Assistenten einrichten:
masaic login masaic mcp install claude-code
Starte den Assistenten neu — dann hat er MASAIC zur Verfügung. Zum Prüfen:
masaic mcp status
Das zeigt, welche Assistenten eingerichtet sind und ob MASAIC tatsächlich antwortet. Nutze es, bevor du dem Assistenten die Schuld gibst.
Deinen Assistenten wählen
masaic mcp install nimmt den Namen des Assistenten, und jeder legt seine Einstellungen woanders ab:
| Befehl | Richtet ein | Geschriebene Config |
|---|---|---|
masaic mcp install claude-code | Claude Code, nur dieses Projekt | .mcp.json im aktuellen Ordner |
masaic mcp install claude-code-user | Claude Code, alle deine Projekte | ~/.claude.json |
masaic mcp install codex | Codex CLI | ~/.codex/config.toml |
masaic mcp install cursor | Cursor | ~/.cursor/mcp.json |
masaic mcp install windsurf | Windsurf | ~/.codeium/windsurf/mcp_config.json |
masaic mcp install claude-desktop | Claude Desktop | die Config-Datei von Claude Desktop |
Die projektbezogene claude-code-Variante schreibt eine Datei in dein Repository, sodass dein ganzes Team nach dem Auschecken dieselbe Verbindung hat. Die anderen gelten pro Benutzer.
Erst ansehen, was passieren würde?
masaic mcp install cursor --dry-run
Das gibt die resultierende Config aus und schreibt nichts. MASAIC hinzuzufügen, lässt die anderen MCP-Server in diesen Dateien unberührt.
Zum Trennen:
masaic mcp uninstall cursor
Kein Token in der Config-Datei
Wichtig zu wissen, weil es die übliche Sorge bei MCP-Setups ist: In die Config-Datei kommt kein Credential. Darin steht nur, dass die CLI gestartet werden soll — und die löst deine Anmeldung pro Nachricht aus dem Speicher auf, den masaic login geschrieben hat, inklusive Refresh.
Eine Config-Datei, die du ins Repository committest, enthält also kein Secret, und deine Teamkolleg:innen authentifizieren sich jeweils selbst.
Worum du bitten kannst
Nach dem Verbinden kann der Assistent arbeiten mit:
- Agents — auflisten samt Versionen, erstellen, ändern (was eine neue Version veröffentlicht), Voice-, Runtime- und Guardrail-Einstellungen lesen, löschen.
- Skills — auflisten, erstellen, löschen.
- Prompts und Resources — die Instruktions- und Wissensinhalte, die deine Agents nutzen.
- Test-Cases und Test-Runs — auflisten und erstellen, einen Run starten und danach Status, Scores und Transkripte zurücklesen.
- Mock-Users und Personas — die synthetischen Kund:innen, mit denen deine Tests sprechen, inklusive Tonfall, Sprache und emotionalem Zustand.
- Automation-Tasks — auflisten, erstellen, ändern, pausieren, fortsetzen, sofort ausführen und die Run-Historie lesen.
- Analytics — Conversations, Token-Verbrauch, Tool-Aufrufe und Latenz für den Workspace oder einen Agent.
Was sich gut als Frage formulieren lässt:
- „Liste die Agents in diesem Projekt und sag, welche keine Test-Cases haben.“
- „Erstelle eine Test-Persona, die ungeduldig ist und Deutsch spricht, und lass die Test-Suite des Billing-Agents dagegen laufen.“
- „Welcher Agent hat letzte Woche die meisten Token verbraucht?“
- „Pausiere jeden Automation-Task, der nach Slack postet.“
Weil der Assistent das Lesen übernimmt, musst du nicht wissen, auf welchem Console-Screen die Antwort steht.
Bevor du ihn ändern lässt
Der Assistent handelt als du, mit deinen Rechten — nicht mit weniger. Zwei Gewohnheiten lohnen sich:
- Fang in einem Nicht-Production-Projekt oder -Environment an. „Räum die unbenutzten Agents auf“ ist eine echte Anweisung mit echten Folgen (Environments).
- Halte den Production-Schritt manuell. Lass den Assistenten eine Änderung vorbereiten und testen; befördere sie über deinen normalen Release-Prozess (Sichere Rollouts).
Destruktive Operationen fragen nach einer Bestätigung — der verlässliche Schutz ist aber das Projekt, auf das du ihn gerichtet hast.
Wenn es nicht funktioniert
| Symptom | Wahrscheinliche Ursache |
|---|---|
| Assistent zeigt keine MASAIC-Tools | Er wurde nach masaic mcp install nicht neu gestartet. |
masaic mcp status sagt, MASAIC antwortet nicht | Nicht angemeldet (masaic login), oder der Endpoint ist falsch — masaic config view zeigt, was aufgelöst wurde. |
| Tools antworten für den falschen Workspace | Das falsche Projekt ist ausgewählt — siehe Projekt und Context. |
| Er kann lesen, aber nicht ändern | Deiner Rolle fehlt das Recht (Teams und Zugriff). |
Verwandt
- Die masaic CLI — dieselben Operationen als Befehle, plus YAML, das du in git halten kannst.
- MCP-Server und Tools — die andere Richtung: deinen Agents Tools zum Aufrufen geben.
- Testen und Release — die Test-Suites, die ein Assistent für dich laufen lassen kann.