So erstellst du Architekturdiagramme mit KI-Agenten (MCP)

KI-Assistenten sind gut darin, aus einer Beschreibung ein Diagramm zu machen. Der Ärger beginnt am Tag danach. Ein Diagramm, das als PNG in einem Chat oder als Mermaid-Snippet in einem Pull Request liegt, ist eine Kopie. Niemand aktualisiert die Kopie, und einen Monat später widerspricht sie dem System, das sie beschreibt.

Das Model Context Protocol (MCP) verlagert den Ort, an dem der Agent arbeitet. Statt dir ein Bild zu übergeben, liest und bearbeitet ein per MCP mit Archboard verbundener Agent dasselbe strukturierte Diagramm, das dein Team im Browser öffnet. Seine Änderungen erscheinen live auf dem Canvas, gekennzeichnet mit der Person, für die er arbeitet, und diese Person kann sie in einem Schritt rückgängig machen.

Dieser Guide zeigt, wie du eine KI-App mit Archboard verbindest, geht ein durchgängiges Beispiel vom ersten Entwurf bis zum Review durch und behandelt die Prompts, Berechtigungen und Limits, auf die es in der Praxis ankommt.

Was ein Agent mit Archboard tun kann

Archboard-Diagramme bestehen aus typisierten Nodes, die aus Node-Packs stammen: Ein Kubernetes-Deployment, eine Cloud-Datenbank, ein C4-Container oder eine BPMN-Aufgabe ist ein Node mit Ports und Eigenschaften, keine Box mit Beschriftung. Über MCP kann ein Agent:

• Diagramme auflisten und lesen, auf die er Zugriff hat – als Übersicht (Frames, Anzahlen, wer gerade daran arbeitet) oder als vollständige Node- und Kantendatensätze.
• Ein Diagramm erstellen – aus einer Beschreibung, aus einer Liste von Operationen oder aus einem Mermaid-Flowchart, das auf echte Node-Typen abgebildet wird.
• Ein Diagramm bearbeiten – mit einem Batch von Operationen, der als eine Änderung angewendet wird: Nodes hinzufügen, Ports verbinden, verschieben, umgestalten oder entfernen.
• Seine Arbeit prüfen, indem er einen PNG-Snapshot rendert, und in Apps, die MCP Apps unterstützen, das Diagramm direkt im Chat anzeigen.
• Eine seiner eigenen Änderungen rückgängig machen.

Archboard bringt kein eigenes KI-Modell mit. Den Agenten bringst du selbst mit: Claude, Cursor, VS Code oder eine andere App, die einen Remote-MCP-Server mit OAuth-Anmeldung hinzufügen kann. Einen kurzen Überblick gibt die Seite zu KI-Agenten.

Deine KI-App verbinden

Der MCP-Server von Archboard ist unter https://getarchboard.app/mcp erreichbar. Er nutzt Streamable HTTP und OAuth, du musst also keinen API-Schlüssel kopieren. Wenn sich deine App verbindet, öffnet sie die Anmeldeseite von Archboard; du meldest dich mit Google oder GitHub an und bestätigst den Zugriff, den die App anfragt.

Auf dem Zustimmungsbildschirm legst du fest, welche Organisationen und Arbeitsbereiche die App nutzen kann und was sie dort jeweils tun darf: Lesen, Bearbeiten oder Löschen (Diagramme in den Papierkorb verschieben). Später kannst du die App unter Einstellungen > Verbundene Apps umbenennen, ändern, was sie nutzen und tun darf, oder ihren Zugriff entfernen.

Einrichtung in einigen verbreiteten Apps:

Claude (Web und Desktop). Öffne Customize > Connectors, wähle Add custom connector und gib https://getarchboard.app/mcp ein. In den Plänen Team und Enterprise fügt zuerst ein Owner den Connector unter Organization settings > Connectors hinzu; danach verbindest du dich über Customize > Connectors.

Claude Code.

claude mcp add --transport http archboard https://getarchboard.app/mcp

Führe danach in einer Session /mcp aus, um dich anzumelden.

Cursor. Füge den Server in ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "archboard": { "url": "https://getarchboard.app/mcp" }
  }
}

VS Code. Füge ihn in deine mcp.json ein (VS Code verwendet den Schlüssel servers):

{
  "servers": {
    "archboard": { "type": "http", "url": "https://getarchboard.app/mcp" }
  }
}

Andere Apps. Füge https://getarchboard.app/mcp in den Connector- oder MCP-Einstellungen der App als Remote-MCP-Server hinzu, sofern dein Plan das erlaubt. Die App braucht eine OAuth-Anmeldung ohne Client-Secret; Details für Client-Entwickler stehen in der MCP-Dokumentation.

Ein durchgespieltes Beispiel: ein Onlineshop vom Entwurf bis zum Review

Hier eine Session mit einem Agenten, der mit Archboard verbunden ist. Die Prompts sind so formuliert, wie du sie tippen würdest; die Tool-Namen in Klammern zeigen, was der Agent im Hintergrund aufruft.

1. Einen ersten Entwurf anfordern

Zeichne ein C4-Container-Diagramm für unseren Onlineshop: eine Web-App, eine API, einen Background-Worker, der Bestell-E-Mails über unseren E-Mail-Anbieter verschickt, eine PostgreSQL-Datenbank und Stripe für Zahlungen. Setz alles, was wir selbst betreiben, in eine Systemgrenze.

Der Agent wählt einen Arbeitsbereich (list_workspaces), sucht die C4-Node-Typen, die er braucht (search_node_types), und erstellt das Diagramm (create_diagram). Dann rendert er einen Snapshot (render_snapshot), um zu prüfen, dass sich nichts überlappt und jede Kante beschriftet ist, und zeigt das Ergebnis im Chat (show_diagram).

Der Entwurf ist ein Ausgangspunkt. Der Agent hat die Container aus deinem Satz abgeleitet; dass der Worker auch aus der Datenbank liest, kann er nicht wissen, solange du es ihm nicht sagst.

2. Mit Worten bearbeiten, auf dem Canvas prüfen

Der Worker liest Bestellungen auch aus der Datenbank. Füge zwischen API und PostgreSQL einen Redis-Cache ein und beschrifte jede Verbindung mit ihrem Protokoll.

Der Agent liest das aktuelle Diagramm (get_canvas) und wendet einen einzigen Batch von Operationen an (apply_ops). Wenn du das Diagramm geöffnet hast, siehst du die neuen Nodes neben einem Cursor auftauchen, der mit der App und deinem Namen beschriftet ist. Teammitglieder, die das Diagramm offen haben, sehen dasselbe.

So sieht das Diagramm nach den ersten beiden Prompts aus:

3. Rückgängig machen, was dir nicht gefällt

Mach die letzte Änderung rückgängig.

Jede Änderung eines Agenten ist ein Schritt. Der Agent kann seine eigene Änderung zurücknehmen (revert_change), oder du machst sie in einem Schritt über den Hinweis rückgängig, der direkt nach der Änderung im Editor erscheint. Felder, die inzwischen jemand anderes geändert hat, bleiben erhalten.

4. Fragen zu einem bestehenden Diagramm stellen

Welche Container sprechen mit PostgreSQL, und über welches Protokoll?

Für eine solche Frage liest der Agent nur (get_canvas). Einem neuen Teammitglied ein bestehendes Diagramm zu erklären, gehört zu den nützlichsten Aufgaben eines Agenten, und dafür braucht er überhaupt keinen Schreibzugriff.

Prompts, die gut funktionieren

• Nenne die Art des Diagramms. „C4-Container-Diagramm“, „Kubernetes-Diagramm mit einem Frame pro Namespace“, „BPMN-Prozess mit einer Lane pro Team“. Dann nutzt der Agent das passende Node-Pack statt generischer Boxen.
• Sag, was in welche Grenze gehört. Frames, Namespaces und VPCs tragen Bedeutung, also sag dem Agenten, was wohin gehört.
• Verlange beschriftete Kanten. „Beschrifte jede Verbindung mit Protokoll und Port“ macht aus Pfeilen Dokumentation.
• Halte jede Änderung klein. Eine Anfrage pro Änderung lässt sich leichter prüfen und rückgängig machen als ein kompletter Neuentwurf.
• Lass den Agenten seine Arbeit prüfen. „Rendere einen Snapshot und behebe alle Überlappungen“ fängt Layoutprobleme ab, bevor du hinschaust.
• Bitte um eine Zusammenfassung. „Liste auf, was du geändert hast“ liefert dir eine Review-Notiz für den Pull Request oder den Team-Chat.

Wer kontrolliert was

Eine KI-App mit den Diagrammen zu verbinden, an denen dein Team arbeitet, wirft berechtigte Fragen auf. Diese Regeln setzt Archboard durch:

• Du bestimmst den Umfang. Eine App sieht nur die Organisationen und Arbeitsbereiche, die du erlaubt hast, und tut dort nur, was du erlaubt hast: Lesen, Bearbeiten oder Löschen. Was sie tatsächlich darf, ist das Minimum aus dieser Einstellung, den ihr gewährten Scopes, deiner Rolle und deinem Plan.
• Änderungen sind sichtbar und zugeordnet. Cursor und Änderungen eines Agenten sind mit der App und der Person beschriftet, für die er arbeitet, auf dem Canvas und im Versionsverlauf.
• Rückgängig ist ein Schritt. Du kannst eine Änderung deines Agenten über den Hinweis im Editor rückgängig machen oder den Agenten bitten, sie innerhalb von 7 Tagen zurückzunehmen. Inhaber und Admins der Organisation können sie ebenfalls rückgängig machen.
• Gelöschtes lässt sich wiederherstellen. Ein Agent braucht die Berechtigung „Löschen“, um ein Diagramm in den Papierkorb zu verschieben, und Archboard weist Agenten an, das nur zu tun, wenn du darum bittest. Du kannst das Diagramm aus dem Papierkorb wiederherstellen.
• Text im Diagramm gilt als Daten. Archboard weist Agenten an, Labels, Notizen und Namen in einem Diagramm als Daten zu behandeln, nie als Anweisungen, und Bilder nur hinzuzufügen, wenn du darum bittest.

Wann ein Agent passt und wann du von Hand zeichnest

Agenten sind gut bei ersten Entwürfen, bei wiederkehrenden Änderungen („benenne jeden orders-*-Service in checkout-* um“), dabei, ein Diagramm im Gleichschritt mit einer Änderung zu halten, die du sowieso machst, und beim Erklären eines Diagramms, das jemand anderes gezeichnet hat. Ein Coding-Agent, der gerade einen Service geändert hat, kann das Architekturdiagramm in derselben Session aktualisieren.

Für die Entscheidung, was zählt, ist Zeichnen von Hand nach wie vor besser. Ein Diagramm ist ein Argument über ein System, und was du weglässt, ist eine Ermessensfrage. Überlass dem Agenten das Tippen und behalte das Urteil selbst.

Limits, die du kennen solltest

• Es gelten die Plan-Limits. MCP funktioniert in jedem Plan, mit denselben Plan-Limits wie der Editor. Im Free-Plan sind das 3 Diagramme und pro Diagramm 15 Diagramm-Nodes plus 150 Notizen, Texte, Sticker und Mindmap-Themen.
• Tool-Aufrufe sind pro Minute begrenzt. Erreicht ein Agent das Limit, teilt Archboard ihm mit, wie lange er warten soll, bevor er es erneut versucht.
• Der Agent weiß nur, was du ihm sagst und was im Diagramm steht. Über Archboard sieht er weder deinen laufenden Cluster noch deine Codebasis. Wenn eine Abhängigkeit wichtig ist, sag es, oder lass einen Coding-Agenten den Code lesen.

FAQ

Welche KI-Apps können sich mit Archboard verbinden? Apps, die einen Remote-MCP-Server mit OAuth-Anmeldung hinzufügen können und kein Client-Secret verlangen. Auf der Seite zu KI-Agenten findest du eine Schnelleinrichtung für Claude, Cursor, VS Code, Claude Code und weitere Apps.

Nutzt Archboard ein eigenes KI-Modell? Nein. Archboard ist der Workspace für die Diagramme; das Denken übernimmt die KI-App, die du verbindest.

Kann der Agent alle meine Diagramme sehen? Nur die Organisationen und Arbeitsbereiche, die du beim Verbinden erlaubt hast, jeweils mit der Berechtigung, die du dafür gewählt hast. Standardmäßig sind das alle, auch solche, denen du später beitrittst, mit der Berechtigung „Löschen“; du kannst das auf dem Zustimmungsbildschirm oder später unter Einstellungen > Verbundene Apps einschränken.

Kann ich rückgängig machen, was der Agent getan hat? Ja. Jede Änderung des Agenten ist ein Schritt, den du über den Hinweis im Editor rückgängig machen kannst, und die App kann ihre eigenen Änderungen der letzten 7 Tage zurücknehmen.

Funktioniert das im Free-Plan? Ja. MCP funktioniert in jedem Plan, mit denselben Plan-Limits wie der Editor.

Kostenlos starten — ein Seat, keine Kreditkarte.