Nennt Claude alle drei Werkzeuge korrekt und mit den richtigen Namen, ist die Verbindung technisch einwandfrei. Reagiert Claude gar nicht auf den Connector oder kennt die Werkzeuge nicht, liegt ein Konfigurationsfehler vor — weiter im nächsten Abschnitt.
Was tun, wenn der Connector nicht funktioniert?
Die allermeisten Probleme bei der Ersteinrichtung liegen an vier Stellen: einem falschen oder fehlenden Zugangsschlüssel, einem Tippfehler in der Endpoint-URL, einem falsch gewählten Transport-Typ oder einem noch nicht aktivierten Connector. Die folgende Übersicht deckt die realistischen Fehlerbilder ab.
Meldung deutet auf Authentifizierungsfehler hin (z. B. 401/Unauthorized)
Das deutet fast immer auf ein Problem mit dem Bearer-Token hin: Der Zugangsschlüssel fehlt, ist falsch kopiert (etwa mit einem Leerzeichen am Ende), wurde in den Einstellungen widerrufen, oder das Wort Bearer vor dem Schlüssel fehlt. Erstellen Sie in diesem Fall einen neuen Zugangsschlüssel unter Einstellungen → "Claude / MCP Zugang" und tragen Sie ihn erneut vollständig ein, inklusive Bearer und einem Leerzeichen davor.
Der Connector zeigt "nicht verbunden" oder erscheint gar nicht
Prüfen Sie zuerst die Endpoint-URL auf Tippfehler — sie muss exakt https://mcp.immostage.ai/api/mcp lauten, inklusive des Pfads /api/mcp am Ende. Prüfen Sie danach, ob der Connector in den Einstellungen tatsächlich gespeichert und aktiviert wurde. Ein neuer Chat nach dem Speichern hilft häufig, 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 aus Schritt 4 muss deshalb --transport http stehen. Wurde der Server versehentlich mit einem anderen Transport-Typ registriert, entfernen Sie den Eintrag und führen Sie den Befehl aus Schritt 4 unverändert erneut aus.
Zugangsschlüssel wurde noch nicht erstellt
Ohne einen unter Einstellungen → "Claude / MCP Zugang" erstellten Schlüssel funktioniert weder der Befehl in Claude Code noch der Custom Connector — es gibt schlicht keinen Bearer-Token zum Eintragen. Legen Sie den Schlüssel zuerst an, bevor Sie Schritt 4 oder 5 wiederholen.
Grundregel bei jedem Verbindungsproblem: Endpoint-URL exakt https://mcp.immostage.ai/api/mcp, Header exakt Authorization: Bearer DEIN_SCHLUESSEL mit Leerzeichen nach "Bearer", und ein frisch erstellter, nicht widerrufener Zugangsschlüssel. Diese drei Punkte lösen die überwiegende Mehrheit aller Einrichtungsprobleme.
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. Die ersten 3 Bilder pro Konto bleiben kostenlos, danach zahlen Sie je nach Bedarf: Einzel für 29 € einmalig pro Objekt ohne Abo, Starter für 49 € im Monat mit 10 Objekten, oder Pro für 199 € im Monat unbegrenzt — alle monatlichen Pakete sind monatlich kündbar.
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.