BigValue Immobilien

BigValue Real Estate Einrichtung

Nach der Plugin-Installation den MCP-Verbindungsstatus prüfen und, falls noch nicht eingeloggt, den client-gerechten Login-Prozess erklären.

Die Authentifizierung erfolgt nicht per API-Key, sondern per Browser-Google-Login (OAuth). Während der Installation müssen keine Werte eingegeben werden; beim ersten Einsatz genügt ein einmaliger Login. Token-Verwaltung und -Erneuerung übernimmt der Client automatisch.

Diese Skill prüft lediglich den Status und gibt Anweisungen. Sie führt keine Login-Befehle aus – die Browser-Rundreise muss der Benutzer im interaktiven Terminal selbst abschließen, damit sie zuverlässig beendet wird. Konfigurations- oder Anmeldeinformationsdateien werden nicht direkt bearbeitet.

Wurde der Skill nur mit npx skills add installiert, folgt die MCP-Verbindung der Onboarding-Anleitung und dieser Skill wird übersprungen.

Statusprüfung

1. Identifiziere den aktuellen Client. Bei Claude Code verwende claude plugin list --json und claude mcp list, bei Codex codex plugin list --json und codex mcp list --json. Falls Shell-Freigabe erforderlich ist, hole diese zuerst ein.
2. Prüfe, ob das Plugin bigvalue-realestate installiert und aktiv ist.
3. Prüfe den Status des MCP-Servers bigvalue-realestate. Vor dem Login verweigert der Server die Verbindung selbst – daher wird er als ! Needs authentication angezeigt; bei ✔ Connected ist der Login erfolgreich. Zur Sicherheit rufe ein repräsentatives Tool einmal auf, um den Status zu bestätigen.
4. Wurde nur der Status abgefragt, melde das Ergebnis auf Koreanisch und ändere nichts.

Claude Code-Pfad

Nach der Plugin-Installation wird der MCP-Server automatisch registriert. Übrig bleibt nur der einmalige Login.

Es ist kein separater Befehl nötig – bei der ersten Datenfrage öffnet der Client den Browser-Login. Unten folgt der manuelle Pfad.

1. Wenn claude mcp list ! Needs authentication anzeigt, ist das normal – der Login steht noch aus.
2. Leite den Benutzer an, /mcp auszuführen und bigvalue-realestate auszuwählen. Der Browser öffnet sich, nach Google-Login und Zustimmung ist die Verbindung hergestellt.
3. Alternative: Der Benutzer kann in einem externen interaktiven Terminal direkt claude mcp login plugin:bigvalue-realestate:bigvalue-realestate ausführen. Dieser Skill führt diesen Befehl nicht selbst aus.
4. Direkt nach dem ersten Login in einer neuen Sitzung prüfen. Der vor dem Login laufende Prozess kann den Authentifizierungsstatus möglicherweise nicht lesen.
5. Wenn das Login-Konto nicht in der Zulassungsliste steht, erscheint „Nicht verbindbares Konto“. In dem Fall den Benutzer anweisen, beim Onboarding-Verantwortlichen die Kontofreigabe zu beantragen.

Zur Nutzung im Chat von Claude Desktop anstelle des Plugins einen benutzerdefinierten Connector einrichten – Settings → Connectors → Add custom connector, dort https://datamarket-mcp.bigvalue.ai/mcp eingeben und Connect drücken. Daraufhin erscheint derselbe Google-Login.

Codex-Pfad

Das Codex-Plugin enthält nur den Skill. MCP wird separat registriert und eingeloggt.

1. Leite den Benutzer an, den Server in ~/.codex/config.toml hinzuzufügen. Das Authentifizierungsverfahren ist standardmäßig OAuth, daher muss es nicht extra angegeben werden.

   [mcp_servers.bigvalue-realestate]
   url = "https://datamarket-mcp.bigvalue.ai/mcp"
   

2. Der Benutzer führt den Login in einem externen interaktiven Terminal aus. Auch dieser Befehl wird nicht vom Skill ausgeführt.

   codex mcp login bigvalue-realestate
   

3. Codex muss in einem neuen Prozess neu gestartet werden. Konfiguration und Login-Status werden nicht im laufenden Prozess übernommen.

4. Überprüfe die Verbindung mit codex mcp list --json und einem Aufruf eines repräsentativen Tools.

Überprüfung

Nach erfolgreicher Verbindung rufe einmalig ein repräsentatives Tool auf (z. B. Komplexsuche), um die Antwort zu bestätigen. Login-URL, Autorisierungscodes oder Tokens werden weder ausgegeben noch protokolliert.

Sicherheitsgrenzen

• Login-URL, Autorisierungscodes oder Tokens weder anfordern, ausgeben, kopieren noch protokollieren. Die Browser-Rundreise obliegt dem Benutzer.
• Die Bearbeitung von ~/.codex/config.toml wird dem Benutzer durch Vorschlagen des obigen Ausschnitts überlassen. Claude-Konfigurationen, Anmeldeinformationsdateien oder Plugin-Caches werden nicht direkt bearbeitet.
• Andere vom Benutzer selbst konfigurierte MCP-Server oder nicht zusammenhängende Plugins werden nicht entfernt oder verändert.