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, ChatGPT/Codex, Cursor, VS Code und andere funktionieren alle mit derselben Verbindung. Ein kleines Hilfsprogramm auf deinem Rechner verbindet deinen Assistenten mit deinem geöffneten imagery.vision-Tab.

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

• Chrome oder Edge für imagery.vision — die Verbindung nutzt eine Schnittstelle, die Safari und Firefox nicht anbieten
• Node.js 20 oder neuer (nodejs.org) — außer du nutzt nur den Chat in Claude Desktop: Die Erweiterung bringt alles mit.

Einrichtung

1. Dein Programm verbinden

Wähle, womit du arbeitest. Für jeden Fall gibt es einen empfohlenen Weg; andere Wege stehen jeweils aufgeklappt darunter.

Hintergrunddienst kommt automatisch mit

Egal, welchen Weg du nimmst: Beim ersten Start richtet das Hilfsprogramm einen kleinen Hintergrunddienst ein und hält ihn bei jedem Update aktuell. Dadurch bleibt imagery.vision verbunden, auch wenn Claude oder ChatGPT geschlossen ist — du steuerst mal über die KI-App, mal direkt in imagery, ohne etwas umzuschalten. macOS meldet beim ersten Mal „Hintergrundobjekt hinzugefügt“.

Nicht gewünscht? In Claude Desktop unter Einstellungen → Erweiterungen → imagery.vision die Option Hintergrunddienst ausschalten, bei den anderen Programmen IMAGERY_MCP_SERVICE=off neben den Kopplungs-Code in die Konfiguration setzen. Ein bereits eingerichteter Dienst lässt sich mit uninstall entfernen (siehe Reiter Ohne KI-App) und kommt danach nicht wieder.

Kopplungs-Code

Die Verbindung braucht einen Kopplungs-Code. Du findest ihn in imagery.vision im Node MCP-Verbindung. Dort steht für jede Wahl unten der fertige Befehl mit deinem Code zum Kopieren. In den Beispielen auf dieser Seite steht dafür DEIN-KOPPLUNGS-CODE. Der Code gilt pro Browserprofil; ohne ihn verbindet sich nichts.

Ist der Code irgendwo gelandet, wo er nicht hingehört (ein geteilter Chat, eine Datei im Projektordner), klicke im Node auf Neuen Code erzeugen und bestätige mit einem zweiten Klick. Der alte Code gilt dann nicht mehr. Bestehende Verbindungen werden sofort getrennt, und jedes Programm muss mit dem neuen Code neu eingerichtet werden.

Claude

Claude Desktop (Chat): Installiere imagery.vision als Erweiterung — ohne Terminal und ohne Konfigurationsdatei.

1. Lade die Erweiterung herunter:

   imagery-mcp.mcpb herunterladen

2. Öffne die Datei per Doppelklick. Claude Desktop startet und zeigt einen Installationsdialog für „imagery.vision“. Klicke auf Installieren und trage deinen Kopplungs-Code ein.

   Falls sich die Datei nicht mit Claude Desktop öffnet: In Claude Desktop Einstellungen → Erweiterungen öffnen und die Datei in das Fenster ziehen.

3. Prüfe unter Einstellungen → Erweiterungen, dass „imagery.vision“ aufgeführt und aktiviert ist und im Feld Kopplungs-Code dein Code steht. Nach einer Neuinstallation ist die Erweiterung manchmal ausgeschaltet oder das Feld leer — dann findet der Chat keine imagery-Werkzeuge.

4. Starte einen neuen Chat. Im Werkzeug-Menü des Eingabefelds taucht jetzt „imagery.vision“ auf.

Aktualisieren: Lade die Datei bei einer neuen Version erneut herunter und öffne sie — Claude Desktop ersetzt die alte Version.

Claude Code und Code-Tab in Claude Desktop: Die Erweiterung gilt nur für den Chat. Für Code installierst du zusätzlich das Plugin, einmalig im Terminal:

claude plugin marketplace add sbauer-hash/imagery-claude-plugins
claude plugin install imagery@imagery-claude-plugins --config pairing_token=DEIN-KOPPLUNGS-CODE

Danach eine neue Session starten. Aktualisieren: claude plugin marketplace update imagery-claude-plugins und claude plugin update imagery@imagery-claude-plugins. Erweiterung und Plugin dürfen gleichzeitig laufen, sie teilen sich die Verbindung zum Browser-Tab.

Windows, oder ohne Plugin: Eintrag per Befehl

Unter Windows ist das Plugin noch nicht geprüft; nimm dort diesen Eintrag. Er ersetzt das Plugin, nicht zusätzlich nutzen — sonst erscheint jedes Werkzeug doppelt. --scope user = für alle Projekte, nicht nur den aktuellen Ordner.

macOS, Linux:

claude mcp add imagery --scope user -e IMAGERY_MCP_TOKEN=DEIN-KOPPLUNGS-CODE -- npx -y https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz

Windows (PowerShell), npx über cmd /c:

claude mcp add imagery --scope user -e IMAGERY_MCP_TOKEN=DEIN-KOPPLUNGS-CODE -- cmd /c npx -y https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz

Danach eine neue Session starten. claude mcp list zeigt imagery, sobald die Verbindung steht. Erscheinen im Code-Tab zwei Sätze (imagery und imagery_vision), funktioniert beides; aufräumen mit claude mcp remove imagery --scope user.

Claude Desktop ohne Erweiterung: Eintrag in der Konfigurationsdatei

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

{
  "mcpServers": {
    "imagery": {
      "command": "npx",
      "args": ["-y", "https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz"],
      "env": { "IMAGERY_MCP_TOKEN": "DEIN-KOPPLUNGS-CODE" }
    }
  }
}

Danach Claude Desktop komplett beenden und neu starten. Nutze nur einen der beiden Wege — Erweiterung und Konfigurationseintrag gleichzeitig ergeben jedes Werkzeug doppelt.

• Kein claude-Befehl im Terminal? Nutzt du nur den Code-Tab der Desktop-App, liegt claude nicht im Suchpfad. Installiere Claude Code einmal für das Terminal.
• Kopplungs-Code nicht in den Chat tippen. Führe die Befehle in einem eigenen Terminal aus, dann landet der Code nicht im Verlauf einer Session.

ChatGPT

Gilt für die ChatGPT-Desktop-App, die Codex-CLI und die Codex-Erweiterung in VS Code oder Cursor — alle lesen dieselbe Konfiguration. Einmalig im Terminal:

codex mcp add imagery --env IMAGERY_MCP_TOKEN=DEIN-KOPPLUNGS-CODE -- npx -y https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz

Danach ChatGPT bzw. Codex neu starten. codex mcp list zeigt imagery.

ChatGPT: noch nicht geprüft

Ob der Eintrag in der ChatGPT-Desktop-App ankommt, haben wir noch nicht verifiziert — melde dich, wenn imagery dort nicht erscheint. ChatGPT im Browser geht nicht: Es kann kein Programm auf deinem Rechner starten.

Ohne codex-Befehl: Eintrag in der Konfigurationsdatei

In ~/.codex/config.toml ergänzen:

[mcp_servers.imagery]
command = "npx"
args = ["-y", "https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz"]
env = { IMAGERY_MCP_TOKEN = "DEIN-KOPPLUNGS-CODE" }

Andere App

Für Cursor, VS Code, Windsurf und jede andere App mit KI-Agent, der Befehle auf deinem Rechner ausführen darf: Lass den Agenten die Verbindung selbst einrichten. Kopiere im Node MCP-Verbindung unter Andere App den Text — er enthält schon deinen Code — und füge ihn in den Chat deiner App ein. Ohne Node geht es mit diesem Text:

Richte für mich den imagery.vision-MCP-Server in diesem Programm ein.
Folge genau der Anleitung unter https://docs.imagery.vision/mcp-install.md
Frag mich nach dem Kopplungs-Code, bevor du ihn einträgst.

Die Anleitung für den Agenten kannst du dir auch selbst ansehen: mcp-install.md.

Cursor von Hand

Trage den Block in ~/.cursor/mcp.json ein (Windows: %USERPROFILE%\.cursor\mcp.json). Er gilt dann für alle Projekte. Nicht in den Projektordner: Dort landet der Kopplungs-Code leicht in Git.

{
  "mcpServers": {
    "imagery": {
      "command": "npx",
      "args": ["-y", "https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz"],
      "env": { "IMAGERY_MCP_TOKEN": "DEIN-KOPPLUNGS-CODE" }
    }
  }
}

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

VS Code von Hand

Am schnellsten im Terminal (macOS, Linux):

code --add-mcp '{"name":"imagery","type":"stdio","command":"npx","args":["-y","https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz"],"env":{"IMAGERY_MCP_TOKEN":"DEIN-KOPPLUNGS-CODE"}}'

Oder, auch unter Windows: Befehlspalette → MCP: Open User Configuration öffnen und den Eintrag unter servers ergänzen (VS Code nutzt servers statt mcpServers):

{
  "servers": {
    "imagery": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz"],
      "env": { "IMAGERY_MCP_TOKEN": "DEIN-KOPPLUNGS-CODE" }
    }
  }
}

Lege keine mcp.json im Projektordner an: Dort landet der Kopplungs-Code leicht in Git.

Ohne KI-App

Nur wenn du gar keine KI-App nutzt und imagery.vision mit Rhino oder Revit verbinden willst. Hast du Claude, ChatGPT oder eine andere App eingerichtet, brauchst du das nicht — sie richtet den Dienst selbst mit ein. Das Hilfsprogramm läuft als Hintergrunddienst und startet bei jeder Anmeldung von selbst (macOS und Windows). Einmalig im Terminal:

npx -y https://docs.imagery.vision/downloads/imagery-mcp-0.13.0.tgz install --token DEIN-KOPPLUNGS-CODE

Unter Windows (PowerShell) schreibst du npx.cmd statt npx; der Node zeigt das dort schon so an. Mit reinem npx kann PowerShell die Meldung „npx.ps1 kann nicht geladen werden“ ausgeben, weil die Ausführungsrichtlinie das Skript blockiert.

Prüfen kannst du den Dienst mit status, entfernen mit uninstall — dieselbe Zeile, nur das letzte Wort statt install --token …. Nach uninstall richten auch deine KI-Apps ihn nicht wieder ein, bis du install ausführst. Rhino und Revit findet das Hilfsprogramm von selbst, auch Programme, die du später installierst.

Was die npx-Zeile macht

Außer bei der Claude-Desktop-Erweiterung lädt npx das Hilfsprogramm beim ersten Start automatisch von docs.imagery.vision. Du musst nichts von Hand installieren — nur Node.js muss vorhanden sein. Starte dein Programm nach dem Eintragen einmal neu.

Aktualisieren: Die Adresse enthält die Versionsnummer (imagery-mcp-0.13.0.tgz). Bei einer neuen Version ersetzt du sie durch die Zeile von dieser Seite und startest dein Programm neu. Das Plugin aktualisierst du mit claude plugin update.

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.

Mehrere Programme gleichzeitig

Du kannst mehrere Assistenten parallel verbinden — etwa Claude Desktop und Cursor, oder zwei Claude-Code-Sitzungen. Die Hilfsprogramme teilen sich deinen Tab: Das erste hält die Verbindung, alle weiteren hängen sich daran. Wird das erste beendet, übernimmt ein anderes, und der Tab verbindet sich von selbst neu.

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 alle Bilder aus ~/Projekte/Studie-Nord/Renderings 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 als Input-Nodes einfügen — einzeln oder einen ganzen Ordner (PNG, JPEG, WebP, bis 50 Bilder), ohne dass du etwas hochladen musst
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.

Bilder aus einem Ordner übernehmen

Liegen deine Renderings, Viewport-Screenshots oder Skizzen schon in einem Ordner, nenne deinem Assistenten einfach den Pfad. Er legt für jedes Bild einen Input-Node an, sortiert nach Dateiname und mit dem Dateinamen als Titel, und kann sie direkt mit Edit- oder Video-Nodes verbinden. Du musst dafür nichts im Browser anklicken. So lässt sich auch eine Studie über Nacht durchrechnen: Ein anderes Programm schreibt die Ansichten in einen Ordner, der Assistent holt sie auf den Canvas, generiert und legt die Ergebnisse über einen Output Folder wieder ab. Dafür muss imagery.vision im Browser geöffnet und verbunden bleiben.

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 — beliebig viele an denselben Eingang. Der Node listet alle Quellen mit ihrem Speicherstatus.
3. Klicke im Node auf Ordner wählen und wähle ein Verzeichnis auf deinem Rechner.

Ab dann landet jedes eingehende Bild, Video oder Text-Ergebnis automatisch als Datei in diesem Ordner. Schaltest du Automatisch speichern aus, sammelt der Node nur und du speicherst gezielt per Button. Über Dateiname-Präfix stellst du den Dateinamen voran, z. B. {datum}_Wettbewerb für 2026-09-23_Wettbewerb_…. 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.

Einzelne Bilder an Figma, Miro oder die Projektablage

Ab Version 0.8.0 kann dein Assistent einzelne Ergebnisse auch direkt weitergeben:

• In Figma oder Miro: Ist in deinem Assistenten auch Figma oder Miro verbunden, sagst du zum Beispiel: „Setz die sechs Edits in die Platzhalter auf meinem Figma-Board.“ Der Assistent holt sich bei Figma bzw. Miro die Upload-Adressen und schickt jedes Bild in voller Auflösung von deinem Rechner dorthin. In Figma füllt es direkt die gewählten Rahmen. Das Bild läuft dabei nicht durch den Chat.
• In einen Ordner: „Speicher das Rendering unter G:\Projekte\2026-14\Renderings.“ Der Assistent legt das Bild dort mit dem Node-Titel als Dateinamen ab und überschreibt nichts, was schon da ist.

Ab Version 0.9.0 geht es auch in die andere Richtung: „Nimm die vier Blätter von meiner Figma-Seite und tausch die Entourage aus.“ Der Assistent holt sich bei Figma oder Miro einen kurzlebigen Link zum Bild, das Hilfsprogramm lädt es auf deinen Canvas und merkt sich, von welchem Rahmen es stammt. So landet das Ergebnis später wieder neben dem richtigen Blatt.

Für Programme, die nur eine Internetadresse annehmen, erstellt der Assistent einen Link auf das Bild, der nach 10 Minuten abläuft. Wer den Link in dieser Zeit hat, kann das Bild öffnen. Wo eine Upload-Adresse möglich ist, nimmt der Assistent deshalb diesen Weg.

Ab Version 0.10.0 kann dein Assistent mehrere Blätter in einem Durchgang bearbeiten: Er legt für jedes Blatt einen eigenen Strang an, nennt dir vorher die geschätzten Credits und startet erst nach deinem Okay. Fehlt unterwegs Guthaben, stoppt der Lauf.

Das funktioniert nur, solange dein Assistent läuft (Claude Desktop, Claude Code, Cursor …).

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. In Claude Desktop prüfe unter Einstellungen → Erweiterungen, ob „imagery.vision“ aktiviert ist. Bei den anderen Programmen prüfe, ob Node.js installiert ist: node --version im Terminal muss eine Version ab 20 zeigen.

Eine neue Version ändert nichts. Der Port gehört dem Hilfsprogramm, das zuerst gestartet ist; jedes weitere hängt sich still daran an. Läuft noch eine alte Fassung (die Erweiterung in Claude Desktop oder ein älterer Eintrag in deinem Assistenten), bleibt sie zuständig. Aktualisiere oder entferne diese Einträge und starte die Programme neu.

Jedes Werkzeug erscheint doppelt (Claude Desktop). Du hast die Erweiterung installiert und zusätzlich den Konfigurationseintrag gesetzt. Entferne den Eintrag imagery aus der Konfigurationsdatei und starte Claude Desktop neu.

Ich nutze ChatGPT. Nimm die ChatGPT-Desktop-App und richte den Server wie unter Codex ein (codex mcp add … oder ~/.codex/config.toml). Dieser Weg ist noch nicht verifiziert; melde dich, wenn er bei dir nicht funktioniert. ChatGPT im Browser wird nicht unterstützt, dafür fehlt noch ein Online-Connector.

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.