Skip to Content
StudioStudio MCP-Server (Preview)

Studio MCP-Server (Preview)

Preview — Der Studio MCP-Server ist aktuell in der Vorschau-Phase. API und Funktionsumfang können sich noch ändern.

Das Studio enthält einen integrierten MCP-Server (Model Context Protocol), der es externen Tools wie Claude Code  ermöglicht, das Studio fernzusteuern — insbesondere BPMN-Diagramme zu erstellen und zu bearbeiten.

Was ist MCP?

Das Model Context Protocol ist ein offener Standard für die Kommunikation zwischen KI-Assistenten und externen Werkzeugen. Der MCP-Server im Studio stellt über 20 Tools bereit, mit denen ein KI-Assistent BPMN-Prozesse programmatisch erstellen und manipulieren kann.

Konfiguration

Server starten

Der MCP-Server kann auf drei Arten gestartet werden:

  1. Command Palette: „MCP Server: Start” ausführen
  2. Status Bar: Auf das MCP-Icon in der Statusleiste klicken
  3. Autostart: In den Settings aktivieren

Status Bar

In der Statusleiste rechts unten zeigt ein farbiger Indikator den Status:

FarbeBedeutung
GrünServer läuft
RotServer gestoppt

Settings

SettingTypStandardBeschreibung
mcp-server.autoStartBooleanfalseServer beim Studio-Start automatisch starten

Standard-Port

Der MCP-Server läuft auf Port 51311. Bei Port-Konflikten wird automatisch der nächste freie Port verwendet (51312, 51313, …).

Claude Code einrichten

MCP-Konfiguration kopieren

Im Studio: Command Palette öffnen (Cmd+Shift+P) → „MCP Server: Copy Claude Code Config” ausführen.

Die Konfiguration wird in die Zwischenablage kopiert:

{
  "mcpServers": {
    "ProcessCube Studio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:51311/mcp"]
    }
  }
}

In Claude Code einfügen

Fügen Sie die Konfiguration in Ihre Claude Code settings.json ein.

Verbindung testen

Starten Sie Claude Code und fragen Sie z.B.: „Erstelle einen BPMN-Prozess mit einem User Task und einem Service Task.”

Verfügbare Tools

Der MCP-Server stellt folgende Tool-Kategorien bereit:

Dokument-Management

ToolBeschreibung
list_documentsAlle geöffneten Dokumente auflisten
open_documentDokument öffnen
new_documentNeues BPMN-Diagramm erstellen
close_documentDokument schließen
save_documentDokument speichern

BPMN-Elemente

ToolBeschreibung
list_elementsAlle Elemente im Diagramm auflisten
get_elementElement-Details abrufen
add_elementNeues Element hinzufügen (Task, Gateway, Event, etc.)
remove_elementElement entfernen
move_elementElement verschieben
connect_elementsZwei Elemente verbinden (Sequenzfluss)
change_element_typeElement-Typ ändern (z.B. Task → User Task)

BPMN-Struktur

ToolBeschreibung
add_participantPool/Participant hinzufügen
add_laneLane zu einem Pool hinzufügen

BPMN-Properties

ToolBeschreibung
set_propertyElement-Property setzen (Name, ID, etc.)
undoLetzte Aktion rückgängig machen
redoRückgängig gemachte Aktion wiederholen

Anordnung

ToolBeschreibung
auto_arrangeElemente automatisch anordnen

Export

ToolBeschreibung
export_xmlBPMN-XML exportieren
export_svgSVG-Grafik exportieren
export_pngPNG-Grafik exportieren (Base64)

LowCode

ToolBeschreibung
add_lowcode_implementationExternal Task Implementierung hinzufügen

Technische Details

Protokoll

Der MCP-Server implementiert die MCP 2.0 Spezifikation über HTTP:

  • Endpoint: http://127.0.0.1:51311/mcp
  • Methode: POST (JSON-RPC)
  • Sessions: Jeder Client erhält eine UUID-basierte Session
  • Transport: StreamableHTTPServerTransport

Session-Management

  • Neue Sessions werden bei initialize-Requests erstellt
  • Jede Session erhält eine eindeutige Session-ID (HTTP-Header mcp-session-id)
  • Sessions werden bei Verbindungsabbruch automatisch aufgeräumt

Weitere Informationen

ProcessCube BrowserStudio Extensions