ImmobilienScout24 mit Microsoft Copilot verbinden (MCP)

ImmobilienScout24 mit Copilot verbinden

ImmobilienScout24 ist Deutschlands größtes Immobilienportal. Mit AnythingMCP durchsucht Copilot die Inserate über die offizielle ImmobilienScout24 REST API: Du beschreibst, was du suchst, Copilot ermittelt den Gebietscode, startet die Suche und liest die Exposés für dich.

Der Connector hat drei lesende Tools für die öffentliche Inseratssuche. Deine eigenen Inserate oder Anfragen verwaltet er nicht (mehr dazu in den FAQ unten).

Was du Copilot fragen kannst

• "Finde 2-Zimmer-Mietwohnungen in Berlin Mitte für höchstens 1.200 € im Monat." Nutzt is24_search_locations für den GeoCode von Berlin Mitte, dann is24_search_properties mit Typ apartmentrent, price_max 1200 und numberofrooms_min 2.
• "Wie lautet der GeoCode für Hamburg Altona?" Nutzt is24_search_locations.
• "Häuser zum Kauf in Freiburg mit mindestens 120 m² Wohnfläche, bis 750.000 €." Nutzt is24_search_locations, dann is24_search_properties mit Typ housebuy, livingspace_min und price_max.
• "Zeig mir Exposé 123456789 komplett: Beschreibung, Ausstattung, Energieausweis, Kontakt." Nutzt is24_get_property.
• "Büroflächen zur Miete in München Schwabing, zeig mir die zweite Ergebnisseite." Nutzt is24_search_properties mit Typ office und pagenumber 2.
• "Sortiere diese Ergebnisse und nenn mir die fünf günstigsten pro Quadratmeter." Das rechnet Copilot aus den Suchergebnissen, die es schon hat.

Was du brauchst

• Ein ImmobilienScout24-Geschäftskonto. ImmobilienScout24 gibt API-Zugang nur an Geschäftskonten; private Konten bekommen ihn nicht.
• Einen API-Schlüsselsatz aus dem IS24 Self-Service-Portal. Der Key kommt in IS24_CONSUMER_KEY, das Secret in IS24_CONSUMER_SECRET.
• Die passende Umgebung. Du kannst Schlüssel für die Sandbox erzeugen (kostenlos, zum Testen, mit anonymisierten Testdaten) und für Produktion (echte Inserate). Der Connector ruft standardmäßig die Produktions-API auf.
• Für Produktion: Du akzeptierst die API-Nutzungsbedingungen, die Nutzung wird nach der Preisliste von ImmobilienScout24 abgerechnet, und manche Anwendungsfälle brauchen vorher eine Partnerfreigabe, die nicht sofort erteilt wird.

ImmobilienScout24 nutzt weiterhin OAuth 1.0a, bei dem jede Anfrage signiert werden muss. AnythingMCP signiert jeden Aufruf mit deinem Schlüsselpaar (zweibeinig, nur App-Kontext), du musst also kein Token tauschen oder erneuern.

Schritt 1 — IS24-Zugangsdaten holen

1. Öffne das IS24 Self-Service-Portal.
2. Melde dich mit einem ImmobilienScout24-Geschäftskonto an oder lege eines an.
3. Erzeuge einen API-Schlüsselsatz: Sandbox zum Testen und/oder Produktion für echte Daten.
4. Kopiere API-Key und Secret.

Schritt 2 — Connector installieren

Auf AnythingMCP Cloud öffnest du Connectors, wählst ImmobilienScout24 API und fügst den Key in IS24_CONSUMER_KEY und das Secret in IS24_CONSUMER_SECRET ein.

Wenn du lieber selbst hostest, startest du AnythingMCP mit Docker und installierst den Connector unter http://localhost:3000/connectors/store:

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — In Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die ImmobilienScout24-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Fehlerbehebung

• Jeder Aufruf wird sofort abgelehnt. Sandbox-Schlüssel funktionieren nur in der Sandbox, und der Connector ruft die Produktions-API auf. Nimm Produktionsschlüssel oder stell die Basis-URL des Connectors zum Testen auf https://rest.sandbox-immobilienscout24.de/restapi/api um. Prüf auch, ob Key und Secret vertauscht sind: Die Signatur wird aus beiden gebildet.
• Produktionsschlüssel sind da, trotzdem werden Aufrufe abgelehnt. Manche Anwendungsfälle brauchen eine Partnerfreigabe, bevor ImmobilienScout24 den Produktionszugang öffnet. Prüf den Status deines Schlüsselsatzes im Self-Service-Portal.
• Die Suche findet nichts oder den falschen Ort. is24_search_properties braucht einen GeoCode, keinen Ortsnamen. Lass Copilot den Ort zuerst mit is24_search_locations auflösen und wähle den richtigen Eintrag, wenn mehrere Orte gleich heißen.
• Zu viele Anfragen auf einmal. ImmobilienScout24 begrenzt, wie oft ein Schlüssel die API aufrufen darf (siehe Rate Limiting im Entwicklerportal). Frag nach weniger Ergebnisseiten auf einmal.

FAQ

Kann Copilot meine eigenen Inserate oder Anfragen auf ImmobilienScout24 verwalten? Nein. Der Connector signiert Anfragen nur im App-Kontext (zweibeinig), das deckt die öffentliche Inseratssuche und Exposé-Abfragen ab. Für deine eigenen Objekte oder Anfragen braucht es Zugriff im Nutzerkontext, den dieser Connector nicht anbietet.

Ist das kostenlos? AnythingMCP ist Open Source unter AGPL-3.0: Self-Hosting ist kostenlos, auch für die kommerzielle Nutzung in deinem eigenen Unternehmen. AnythingMCP Cloud kannst du 7 Tage kostenlos testen. Bei ImmobilienScout24 sind Sandbox-Schlüssel kostenlos, die Produktionsnutzung wird nach der Preisliste von ImmobilienScout24 abgerechnet.

Speichert AnythingMCP meine Daten? Dein IS24-Key und das Secret liegen verschlüsselt (AES-256-GCM) in deinem Workspace und werden Copilot nie gezeigt. Wenn Copilot ein Tool nutzt, ruft AnythingMCP ImmobilienScout24 auf und gibt das Ergebnis an Copilot weiter; der Aufruf landet im Audit-Log deines Workspaces. AnythingMCP Cloud wird in Frankfurt gehostet.

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• ImmobilienScout24-MCP-Server für andere KI-Clients
• ImmobilienScout24 mit Claude verbinden
• ImmobilienScout24 mit ChatGPT verbinden
• ImmobilienScout24 mit Cursor verbinden
• ImmobilienScout24 mit Gemini verbinden
• ImmobilienScout24 mit Meta Muse verbinden