KI-Integration (MCP-Server)

Diagrammix enthält einen integrierten MCP-Server (Model Context Protocol), der KI-Assistenten wie Claude und Codex ermöglicht, Ihre Diagramme direkt zu lesen und zu bearbeiten. Beschreiben Sie in natürlicher Sprache, was Sie benötigen, und die KI platziert Symbole, Verbindungslinien und Layouts für Sie auf dem Canvas.

Was kann die KI?

Diagramme aus einer Beschreibung erstellen — fragen Sie nach einem Flussdiagramm, einer Netzwerktopologie oder einem Organigramm und erhalten Sie es sofort auf dem Canvas
Mindmaps erstellen — beschreiben Sie ein Thema und erhalten Sie eine strukturierte Mindmap
Ihr Dokument lesen — die KI sieht Ihre aktuellen Formen, Verbindungslinien, Ebenen und Stile
Vorhandene Elemente ändern — Text, Farben, Positionen oder Verbindungslinien-Routing aktualisieren
Stapeloperationen — ganze Diagramme mit Symbolen und Verbindungslinien in einem einzigen Schritt erstellen
Auto-Layout und Ausrichtung — Elemente mit natürlichsprachlichen Befehlen organisieren
Ein Aussehen aus einem Bild replizieren — geben Sie der KI ein Referenzbild, und sie erstellt eine passende benutzerdefinierte Vorlage und einen passenden Stil
Exportieren — SVG-, PNG-, Visio- (.vsdx) oder Mermaid-Ausgabe auf Abruf erzeugen

Voraussetzungen

Diagrammix PRO (Einmalkauf)
Diagrammix muss mit aktiviertem MCP-Server laufen
Ist kein Dokument geöffnet, kann der Assistent ein neues erstellen
KI-Client und Diagrammix müssen sich auf demselben Rechner befinden (localhost)

Es werden kein Node.js, npx oder mcp-remote benötigt — Diagrammix enthält einen nativen Helfer für Clients, die einen solchen erfordern.

Einrichtung

1. Den MCP-Server aktivieren

Öffnen Sie Diagrammix
Gehen Sie zu Diagrammix > Einstellungen (oder drücken Sie Cmd+,)
Wechseln Sie zum Tab KI-Integration
Schalten Sie im Abschnitt MCP-Server die Option MCP-Server aktivieren ein

Status zeigt Läuft, sobald der Server bereit ist. Der Server lauscht unter http://localhost:8420/mcp.

2. Claude Desktop konfigurieren

Claude Desktop verbindet sich über stdio. Diagrammix liefert einen nativen stdio-Helfer im App-Bundle mit, sodass kein Node.js, npx oder mcp-remote erforderlich ist.

Klicken Sie in den Diagrammix-Einstellungen auf Konfiguration kopieren — dadurch wird der genaue Pfad zum mitgelieferten Helfer für Ihre Installation eingetragen
Öffnen Sie die Konfigurationsdatei von Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
Fügen Sie die Konfiguration ein. Sie sieht so aus — der command-Pfad verweist auf den Helfer innerhalb des Ordners, in dem Diagrammix.app installiert ist:

{
  "mcpServers": {
    "diagrammix": {
      "command": "/Applications/Diagrammix.app/Contents/MacOS/diagrammix-mcp-stdio",
      "args": ["--url", "http://localhost:8420/mcp"]
    }
  }
}

Hinweis: Verwenden Sie Konfiguration kopieren, anstatt den Pfad von Hand einzugeben — er verweist auf den Helfer innerhalb Ihres tatsächlichen App-Bundles, das Diagrammix signiert und aktuell hält.

Starten Sie Claude Desktop neu. Die Diagrammix-Werkzeuge erscheinen im Chat.

3. Claude Code (CLI) konfigurieren

Claude Code unterstützt Streamable HTTP nativ — es ist keine Brücke erforderlich. Fügen Sie einen MCP-Server vom Typ HTTP hinzu, der auf Folgendes verweist:

http://localhost:8420/mcp

Die genauen Befehle oder Konfigurationsdateien finden Sie in der MCP-Dokumentation von Claude Code.

4. Codex konfigurieren

Codex (App, CLI und IDE-Erweiterung teilen sich eine MCP-Konfiguration) verbindet sich über Streamable HTTP. Konfigurieren Sie es auf eine der beiden Arten:

Option A — config.toml. Klicken Sie im Codex-Bereich der Diagrammix-Einstellungen auf Konfiguration kopieren und fügen Sie sie in ~/.codex/config.toml ein:

[mcp_servers.diagrammix]
url = "http://localhost:8420/mcp"
enabled = true
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20
tool_timeout_sec = 60

Option B — CLI. Klicken Sie in den Diagrammix-Einstellungen auf Befehl kopieren, oder führen Sie aus:

codex mcp add diagrammix --url http://localhost:8420/mcp

5. Andere MCP-Clients

Jeder MCP-kompatible Client kann sich verbinden über:

Transport: Streamable HTTP
Endpunkt: http://localhost:8420/mcp
Protokoll: JSON-RPC 2.0 über HTTP POST

Hinweis: ChatGPT Desktop erfordert HTTPS und unterstützt keine direkten localhost-Verbindungen.

Wichtige Werkzeuge

Diagrammix stellt eine große Anzahl von MCP-Werkzeugen bereit. Einige der nützlichsten:

Werkzeug	Was es tut
`batch_create`	Viele Symbole und Verbindungslinien in einem Rückgängig-Schritt erstellen
`apply_diagram_plan` / `preview_diagram_plan`	Einen strukturierten Diagrammplan prüfen und dann als einen rückgängig machbaren Schritt anwenden
`get_elements` / `update_element`	Vorhandene Elemente lesen und ändern
`apply_layout`	Auto-Layout ausführen
`create_mindmap`	Eine Mindmap aus einem verschachtelten Baum oder einer Markdown-Gliederung erstellen
`import_mermaid`	Ein Diagramm aus Mermaid-Text einfügen
`generate_radial_diagram`	Eine radiale Infografik generieren — segmentierter Ring, Kreise oder Blütenblätter — mit Beschriftungen und Farben
`combine_shapes`	Boolesche Operationen (Vereinigung, Subtraktion, Schnittmenge, Ausschluss)
`create_artboard`	Eine Zeichenfläche für den Export hinzufügen
`set_document_palette` / `apply_palette`	Eine Dokumentfarbpalette speichern und das Diagramm damit neu einfärben
`create_style` / `apply_style`	Benutzerdefinierte Stile erstellen und anwenden
`export_svg`, `export_png`, `export_vsdx`, `export_mermaid`	Das Diagramm oder die Auswahl exportieren; `export_vsdx` macht aus jeder Zeichenfläche eine Visio-Seite
`undo` / `redo`	Änderungen rückgängig machen und wiederherstellen

Anwendungsbeispiele

Ein Flussdiagramm erstellen

„Erstelle ein Flussdiagramm mit Start, Entscheidung, Prozess A, Prozess B und Ende. Verbinde Start mit Entscheidung, Entscheidung mit Prozess A (Ja) und Prozess B (Nein), und beide Prozesse mit Ende."

Die KI verwendet batch_create, um alle Symbole und Verbindungslinien in einem einzigen Rückgängig-Schritt zu platzieren.

Vorhandenes Diagramm ändern

„Ändere die Füllfarbe aller Rechtecke zu Blau und mache den Text fett."

Die KI liest Ihre Elemente mit get_elements und aktualisiert dann jedes mit update_element.

Auto-Layout

„Wende ein Layout von oben nach unten mit 60 px Abstand zwischen den Zeilen an."

Die KI ruft apply_layout mit Ihrer bevorzugten Richtung und Abstand auf.

Ein Aussehen aus einem Bild replizieren

„Hier ist ein Screenshot des Diagrammstils unserer Marke. Erstelle diese Formen und Farben als benutzerdefinierte Vorlage und einen Stil, den ich wiederverwenden kann."

Geben Sie dem Assistenten ein Referenzbild, und er kann passende SVG-Formen und Pfeilspitzen generieren, sie zu einer benutzerdefinierten Vorlage zusammenstellen und einen passenden benutzerdefinierten Stil definieren. Dabei werden Werkzeuge wie create_custom_template, add_custom_shape, add_custom_arrowhead und create_style verwendet, sodass das Ergebnis ein wiederverwendbares Paket ist — keine einmalige Zeichnung.

Tipps

Beginnen Sie mit einer Beschreibung — je genauer Sie sind, desto besser das Ergebnis
Iterieren Sie — bitten Sie die KI, Farben, Beschriftungen oder das Layout nach der ersten Erstellung anzupassen
Machen Sie frei rückgängig — alle KI-Änderungen unterstützen Rückgängig mit Cmd+Z
Notationssymbole verwenden — bitten Sie die KI, bestimmte Notationspakete für einheitliche Gestaltung zu verwenden
Stapelverarbeitung ist besser — bei neuen Diagrammen erstellt die KI alles in einem Schritt, sodass Rückgängig das Ganze zurücksetzt