KI-Assistenten verbinden (MCP)

Du kannst imagery.vision mit deinem KI-Assistenten verbinden und den Canvas dann in natürlicher Sprache steuern. Du beschreibst, was du brauchst — der Assistent baut den Workflow, und du siehst im Browser live zu, wie die Nodes entstehen.

Technisch läuft das über MCP (Model Context Protocol), einen offenen Standard, über den Programme mit KI-Assistenten sprechen. Weil der Standard offen ist, bist du nicht an ein bestimmtes Programm gebunden: Claude Desktop, Cursor, VS Code, Codex und Claude Code funktionieren alle mit derselben Verbindung. Du startest dafür ein kleines Hilfsprogramm auf deinem Rechner, das deinen Assistenten mit deinem geöffneten imagery.vision-Tab verbindet.

Beta — Ausrollen läuft

Die Verbindung ist neu. Das Hilfsprogramm wird gerade über npm veröffentlicht — bis es dort liegt, schlägt der Start mit „package not found” fehl. Die Funktion selbst ist in der App bereits verfügbar; diese Anleitung beschreibt den Stand, sobald die Veröffentlichung durch ist.

Wichtig zu wissen

Der Canvas läuft weiterhin in deinem Browser. Dein Assistent steuert deinen geöffneten, eingeloggten Tab — es gibt keinen Zugriff auf dein Konto, wenn kein Tab offen ist. Generierungen laufen über deinen Workspace und verbrauchen wie gewohnt Credits.

Voraussetzungen

• Ein MCP-fähiges Programm (siehe Reiter unten)
• Chrome oder Edge für imagery.vision — die Verbindung nutzt eine Schnittstelle, die Safari und Firefox nicht anbieten
• Node.js 20 oder neuer auf deinem Rechner (nodejs.org)

Du musst nichts vorab installieren — dein Assistent lädt das Hilfsprogramm beim ersten Start automatisch.

Einrichtung

1. Dein Programm konfigurieren

Claude Desktop

Öffne Einstellungen → Entwickler → Konfiguration bearbeiten und trage ein:

{
  "mcpServers": {
    "imagery": {
      "command": "npx",
      "args": ["-y", "imagery-mcp"]
    }
  }
}

Danach Claude Desktop komplett neu starten. In der Werkzeugliste sollte anschließend ein Eintrag imagery auftauchen.

Cursor

Trage den Block in ~/.cursor/mcp.json ein (gilt für alle Projekte) — oder in .cursor/mcp.json im Projektordner, wenn du ihn nur dort brauchst:

{
  "mcpServers": {
    "imagery": {
      "command": "npx",
      "args": ["-y", "imagery-mcp"]
    }
  }
}

Danach findest du imagery in den Cursor-Einstellungen unter MCP. Windsurf nutzt dasselbe Format in seiner eigenen Konfigurationsdatei.

VS Code

VS Code nutzt servers statt mcpServers. Lege im Projekt .vscode/mcp.json an:

{
  "servers": {
    "imagery": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "imagery-mcp"]
    }
  }
}

Über die Befehlspalette (MCP: Add Server) kannst du denselben Eintrag auch global für alle Projekte anlegen.

Codex

Am schnellsten im Terminal:

codex mcp add imagery -- npx -y imagery-mcp

Oder von Hand in ~/.codex/config.toml:

[mcp_servers.imagery]
command = "npx"
args = ["-y", "imagery-mcp"]

Claude Code

Einmalig im Terminal:

claude mcp add imagery -- npx -y imagery-mcp

ChatGPT

ChatGPT selbst — Web wie Desktop-App — bindet ausschließlich Server aus dem Netz an und kann kein Programm auf deinem Rechner starten. Für den Weg über OpenAI nimmst du daher Codex (Reiter oben).

2. Im Browser verbinden

Öffne imagery.vision in Chrome oder Edge und melde dich an. Klicke oben rechts im Kopfbereich auf den Chip MCP.

Alles an einem Ort

Alternativ kannst du den Node MCP-Verbindung auf dem Canvas platzieren (Doppelklick auf eine freie Stelle → nach „MCP” suchen). Er zeigt den Verbindungsstatus, hat einen Verbinden-Knopf und stellt die Konfiguration für jedes Programm zum Kopieren bereit — praktisch, wenn du die Einrichtung direkt vor dir haben willst. Der Node hat weder Ein- noch Ausgang und kostet keine Credits.

Beim ersten Mal fragt der Browser einmalig um Erlaubnis, mit einem Programm auf deinem Rechner zu sprechen — bestätige das. Der Punkt im Chip wechselt auf grün, sobald die Verbindung steht.

Farbe	Bedeutung
Grau	Verbindung aus — klicken zum Aktivieren
Orange (pulsierend)	Sucht das Hilfsprogramm — läuft es?
Grün	Verbunden, dein Assistent kann den Canvas steuern

Die Einstellung wird gespeichert: Beim nächsten Mal verbindet sich der Tab von selbst, sobald das Hilfsprogramm läuft.

Ein Programm zur Zeit

Das Hilfsprogramm belegt einen festen Anschluss auf deinem Rechner. Läuft schon eines — etwa aus Claude Desktop —, beendet sich ein zweites aus Cursor sofort wieder. Welches Programm du nutzt, ist frei; gleichzeitig geht derzeit nur eines. Schließe das andere Programm, wenn du wechseln willst.

Arbeiten mit dem Assistenten

Sprich einfach normal. Ein paar Beispiele:

• „Schau dir meinen Canvas an und erklär mir, was da gerade aufgebaut ist.”
• „Bau mir einen Workflow: Textprompt für ein Wohnhaus mit Holzfassade, daraus drei Varianten über Nano Banana Pro.”
• „Nimm die Screenshots aus meinem Projektordner und leg sie als Input-Nodes an.”
• „Der zweite Entwurf gefällt mir — mach daraus eine Abendstimmung.”

Was der Assistent dabei kann:

Bereich	Möglichkeiten
Ansehen	Canvas lesen, Node-Ergebnisse als Bild betrachten und beurteilen
Bauen	Nodes anlegen, verbinden, Prompts und Modelle setzen, aufräumen
Ausführen	Workflow oder einzelne Nodes starten und den Fortschritt verfolgen
Zuliefern	Lokale Bilddateien von deinem Rechner als Input-Node einfügen
Daten liefern	Grundstücksdaten inklusive Katastergeometrie und Kennwerten auslesen

Credits

Der Assistent ist angewiesen, vor jeder Generierung zu fragen. Bestätige bewusst — jede Ausführung verbraucht Credits aus deinem Workspace. Aufbauen und Umbauen des Canvas kostet nichts.

Videogenerierungen dauern mehrere Minuten. Der Assistent startet sie und fragt in Abständen den Status ab, statt blockiert zu warten — du kannst in der Zwischenzeit weiterarbeiten.

Ergebnisse an andere Programme übergeben

Wenn du mit den Bildern in einem anderen Programm weiterarbeiten willst — CAD, Bildbearbeitung, 3D — hilft der Node Output Folder:

1. Lege einen Output Folder-Node an (dein Assistent kann das für dich tun).
2. Verbinde die Generatoren, deren Ergebnisse du behalten willst, mit diesem Node.
3. Klicke im Node auf Ordner wählen und wähle ein Verzeichnis auf deinem Rechner.

Ab dann landet jedes eingehende Bild automatisch als Datei in diesem Ordner. Weil dein Assistent auf lokale Dateien zugreifen kann, ist das die einfachste Brücke zu allem, was danach kommt. Die Ordnerwahl musst du selbst klicken — der Browser lässt aus gutem Grund kein Programm ungefragt an deine Dateien.

Wenn etwas nicht klappt

Der Chip bleibt orange. Das Hilfsprogramm läuft nicht. Dein Assistent startet es automatisch — meist hilft ein vollständiger Neustart des Programms. Wenn es dabei bleibt, prüfe, ob Node.js installiert ist: node --version im Terminal muss eine Version ab 20 zeigen. Prüfe außerdem, ob ein zweites Programm dieselbe Verbindung belegt (siehe oben).

Der Assistent sagt, es sei kein Tab verbunden. Der imagery.vision-Tab muss offen und eingeloggt sein und der Chip grün. Nach einem Neuladen der Seite verbindet sich der Tab innerhalb weniger Sekunden neu.

Der Chip fehlt im Kopfbereich. Du bist nicht eingeloggt, oder du nutzt Safari bzw. Firefox — dort steht die Funktion nicht zur Verfügung.

Es reagiert der falsche Tab. Es kann sich immer nur ein Tab verbinden. Öffnest du imagery.vision ein zweites Mal, übernimmt der neue Tab und der alte wird getrennt.