Claude Cowork einrichten für virtuelles Home Staging

Kurz erklärt: Wie richte ich Claude Cowork mit ImmoStage ein?

Sie öffnen in Claude Cowork oder Claude Desktop die Connector-Einstellungen, fügen die Adresse https://mcp.immostage.ai/api/mcp ein und klicken auf "Verbinden". Daraufhin öffnet sich die ImmoStage-Anmeldung, in der Sie sich anmelden oder direkt ein neues Konto anlegen — danach ist der Connector aktiv. Ein Zugangsschlüssel ist nicht mehr nötig, und ein Konto müssen Sie vorher nicht haben. In Claude Code registrieren Sie den Server mit einem einzigen Terminalbefehl und starten die Anmeldung anschließend im Chat mit /mcp. Ein kurzer Test-Prompt bestätigt danach, dass Claude die vier ImmoStage-Werkzeuge sieht.

Was brauche ich vor der Einrichtung?

Zwei Dinge, bevor Sie starten: Zugriff auf Claude (Claude Cowork, Claude Desktop oder Claude Code) und zwei Minuten Zeit. Ein technisches Vorwissen zu MCP oder Terminal-Befehlen ist nicht nötig, und ein ImmoStage-Konto brauchen Sie vorab ausdrücklich nicht — die Registrierung ist Teil des Verbindungsvorgangs und passiert in derselben Maske wie die Anmeldung.

Ein Objektfoto sollten Sie griffbereit haben, um die Einrichtung direkt an einem echten Raum zu prüfen: ein Bild eines leeren oder spärlich möblierten Zimmers, aufgenommen mit dem Smartphone, genügt. Ihr erstes Inserat ist ein kostenloser Test mit 3 Staging-Bildern, ohne Kreditkarte. Das reicht, um den kompletten Ablauf einmal durchzuspielen, bevor Sie sich für ein bezahltes Paket entscheiden.

Wie richte ich den ImmoStage MCP-Server Schritt für Schritt ein?

Die drei Schritte selbst stehen im Kasten oben — dort finden Sie auch die Adresse zum Kopieren. Dieser Abschnitt beschreibt, was Sie dabei jeweils auf dem Bildschirm sehen, damit Sie an keiner Stelle raten müssen.

Schritt 1: Die Connector-Einstellungen finden

In Claude Cowork und Claude Desktop liegt die Connector-Verwaltung in den Einstellungen unter dem Punkt Connectors. Dort sehen Sie die bereits vorhandenen Verbindungen und die Schaltfläche "Connector hinzufügen". Der ImmoStage MCP-Server ist ein solcher Connector — er wird nicht installiert, sondern nur einmal eingetragen und liegt danach in Ihrem Konto, nicht auf dem Gerät.

Schritt 2: Die Adresse einfügen

Eingetragen wird ausschließlich die Endpoint-Adresse. Es gibt kein zweites Feld für einen Schlüssel oder ein Passwort, und Sie müssen an dieser Stelle nichts weiter ausfüllen. Wichtig ist nur, dass die Adresse auf /api/mcp endet und beim Einfügen kein Leerzeichen mit hineinrutscht — ohne diesen Pfad findet Claude den Server nicht.

Schritt 3: Verbinden und anmelden

Nach dem Klick auf Verbinden öffnet Claude die ImmoStage-Anmeldung in einem neuen Fenster oder Tab. Sie melden sich dort mit Ihrer E-Mail-Adresse an; haben Sie noch kein Konto, legen Sie es in derselben Maske direkt an. Anschließend bestätigen Sie, dass Claude auf Ihr ImmoStage-Konto zugreifen darf. Das Fenster schließt sich, und der Connector erscheint in der Liste als verbunden.

Damit ist die Einrichtung abgeschlossen. Es gibt keinen Schlüssel, den Sie sich merken oder sicher verwahren müssten: Die Verbindung hängt an Ihrem Konto, gilt für alle künftigen Chats und muss nicht bei jedem Start wiederholt werden. Möchten Sie den Zugriff später beenden, entfernen Sie den Connector in denselben Einstellungen.

In Claude Code: ein Zwischenschritt mehr

Der Terminalbefehl aus dem Kasten oben registriert den Server nur — die Anmeldung startet er nicht. Starten Sie danach Claude Code, tippen Sie /mcp ein und wählen Sie dort die Authentifizierung aus; erst dann öffnet sich der Browser mit der ImmoStage-Anmeldung. Solange das nicht passiert ist, zeigt claude mcp list den Server als ✘ Failed to connect an. Das ist vor der Anmeldung völlig normal und kein Defekt — nach dem Anmelden wechselt der Eintrag auf verbunden.

Danach: der erste echte Auftrag

Öffnen Sie einen neuen Chat, hängen Sie das Foto eines leeren Raums an und nennen Sie Stil (modern, skandinavisch, klassisch, minimal oder luxus) sowie Raumtyp (Wohnzimmer, Schlafzimmer, Küche, Bad oder Büro). Claude ruft dann stage_room auf und fragt mit check_staging das Ergebnis ab. Auf Wunsch erzeugt generate_marketing anschließend Social-Media-Posts und ein Exposé, und get_download_link liefert am Ende die Download-Website mit allen Dateien — abgerechnet wird das Ganze über Ihr kostenloses Test-Inserat.

Claude Code oder Claude Desktop — welcher Weg passt zu mir?

Technisch ist beides gleichwertig: derselbe Endpoint, dieselbe Anmeldung, dieselben vier Werkzeuge. Der Unterschied liegt allein im Aufwand und in der Umgebung, in der Sie ohnehin arbeiten.

Arbeiten Sie ohnehin im Terminal oder nutzen Sie Claude Code für andere Aufgaben, ist der Einzeiler aus dem Kasten oben der schnellste Weg — dort kommt allerdings der Zwischenschritt über /mcp dazu. In Claude Cowork und Claude Desktop erledigt der Klick auf Verbinden beides auf einmal. Sie können auch beides parallel einrichten — es hängt dieselbe Anmeldung dahinter.

Wie prüfe ich, ob die Einrichtung funktioniert hat?

Bevor Sie ein echtes Objektfoto verwenden, bestätigen Sie die Verbindung mit einem harmlosen Test-Prompt. Das spart Zeit, falls doch noch etwas an der Konfiguration hakt.

Nennt Claude alle vier Werkzeuge korrekt und mit den richtigen Namen, ist die Verbindung technisch einwandfrei. Reagiert Claude gar nicht auf den Connector oder kennt die Werkzeuge nicht, ist die Verbindung nicht zustande gekommen — weiter im nächsten Abschnitt.

Was tun, wenn der Connector nicht funktioniert?

Seit die Verbindung über die Anmeldung läuft, fallen die klassischen Schlüsselfehler weg. Übrig bleiben ein Tippfehler in der Adresse, ein blockiertes Anmeldefenster, eine in Claude Code noch nicht nachgeholte Anmeldung, ein Chat, der die Connector-Liste nicht neu geladen hat — und der häufigste Fall überhaupt: ein Auftrag, der schlicht noch läuft.

Claude meldet nichts mehr und das Bild kommt nicht

Das ist meist gar kein Fehler. Ein Bild zu rendern dauert 30 bis 90 Sekunden, bei mehreren Räumen entsprechend länger. Claude fragt den Status externer Connectors nicht immer von selbst erneut ab, deshalb kann es aussehen, als sei der Auftrag verloren gegangen. Schreiben Sie in dem Fall einfach "Prüf den Status bitte noch einmal" — der Auftrag läuft auf unseren Servern ohnehin weiter, auch wenn Claude in der Zwischenzeit nichts meldet, und das fertige Bild erscheint dann im Chat.

Das Anmeldefenster öffnet sich nicht

Nach dem Klick auf Verbinden muss sich die ImmoStage-Anmeldung öffnen. Bleibt der Bildschirm leer, blockiert in aller Regel ein Popup-Blocker oder eine strenge Browser-Einstellung das Fenster. Erlauben Sie Popups für claude.ai bzw. Claude Desktop und klicken Sie erneut auf Verbinden.

Claude Code zeigt "✘ Failed to connect"

Das ist der häufigste Fehlalarm in Claude Code — und meistens gar kein Fehler. Der Befehl claude mcp add registriert den Server, meldet Sie aber nicht an. Bis das nachgeholt ist, kann der Server keine Verbindung aufbauen und wird entsprechend als nicht verbunden gelistet. Starten Sie Claude Code, tippen Sie /mcp ein und wählen Sie die Authentifizierung für immostage; danach öffnet sich der Browser mit der Anmeldung, und der Eintrag wechselt auf verbunden. Läuft der Befehl auf einem Rechner ohne Browser, richten Sie den Connector stattdessen über die App ein.

Der Connector zeigt "nicht verbunden" oder erscheint gar nicht

Prüfen Sie zuerst die Adresse auf Tippfehler — sie muss exakt https://mcp.immostage.ai/api/mcp lauten, inklusive des Pfads /api/mcp am Ende, und darf kein angehängtes Leerzeichen enthalten. Prüfen Sie danach, ob die Anmeldung wirklich bis zur Bestätigung durchlief: Wurde das Fenster vorher geschlossen, bleibt der Connector unverbunden. Starten Sie zuletzt einen neuen Chat, weil bestehende Chats die Connector-Liste nicht immer automatisch neu laden.

Falscher Transport-Typ in Claude Code

Der ImmoStage MCP-Server läuft ausschließlich über HTTP-Transport. Im Befehl muss deshalb --transport http stehen. Wurde der Server versehentlich mit einem anderen Transport-Typ registriert, entfernen Sie den Eintrag und führen Sie den Einzeiler aus dem Kasten oben unverändert erneut aus.

Alternative: manueller Zugangsschlüssel

Ältere Claude-Code-Versionen beherrschen die automatische Anmeldung noch nicht. Nur für diesen Fall gibt es weiterhin den manuellen Weg: Erstellen Sie unter app.immostage.ai → Einstellungen → "Claude / MCP Zugang" einen persönlichen Zugangsschlüssel und übergeben Sie ihn beim Registrieren des Servers als Authorization-Header im Format Bearer IHR_SCHLUESSEL — mit Leerzeichen nach dem Wort Bearer. Endpoint und Werkzeuge sind identisch.

Meldet Claude dabei einen Authentifizierungsfehler (etwa 401 oder "Unauthorized"), ist der Schlüssel falsch kopiert, widerrufen oder das Wort Bearer fehlt davor. Für alle aktuellen Clients — Claude Cowork, Claude Desktop und aktuelle Claude-Code-Versionen — ist dieser Weg nicht nötig und auch nicht empfohlen: Ein Schlüssel, den niemand erstellt, kann auch nicht verloren gehen.

Was kommt nach der Einrichtung?

Sobald der Test-Prompt erfolgreich war, steht Ihnen der komplette Staging-Workflow im Chat zur Verfügung. Fünf Stile (modern, skandinavisch, klassisch, minimal, luxus) und fünf Raumtypen (Wohnzimmer, Schlafzimmer, Küche, Bad, Büro) decken die meisten Objekte ab. Ihr erstes Inserat ist der kostenlose Test mit 3 Staging-Bildern; danach buchen Sie Inserate einzeln oder im Monatspaket — die aktuellen Konditionen stehen auf der Preisseite.

Wer wissen möchte, was der ImmoStage MCP-Server über das reine Staging hinaus im Detail leistet, findet die vollständige Werkzeug-Referenz in unserem Ratgeber ImmoStage MCP-Server im Detail. Wer die Einrichtung nicht manuell wiederholen möchte, richtet den Connector stattdessen über das fertige Skill-ZIP für Immobilienmakler ein.