--- title: "MCP-Registry" description: "Alle MCP-Server des Maklerportals im Überblick – welche Werkzeuge sie bereitstellen und wie das AI Gateway sie absichert." url: "https://maklerportal.apim.eu/mcp-registry" image: "https://maklerportal.apim.eu/_og/d/c_Ocean.takumi,title_MCP-Registry,description_~QWxsZSBNQ1AtU2VydmVyIGRlcyBNYWtsZXJwb3J0YWxzIGltIMOcYmVyYmxpY2sg4oCTIHdlbGNoZSBXZXJremV1Z2Ugc2llIGJlcmVpdHN0ZWxsZW4gdW5kIHdpZSBkYXMgQUkgR2F0ZXdheSBzaWUgYWJzaWNoZXJ0Lg,props_eyJ0aGVtZSI6eyJtb2RlIjoiZGFyayIsImNvbG9ycyI6eyJwcmltYXJ5IjoiI0Q0QTI0QyJ9fX0,p_Ii9tY3AtcmVnaXN0cnki,s_SjKIna7VOXeaFaqP.png" --- ## MCP-Registry Acht MCP-Server stellen die Fachverfahren des Maklerportals als Werkzeuge bereit – für Agenten, Assistenten und alles andere, was das Model Context Protocol spricht. ## [Wozu eine Registry](#wozu-eine-registry) Ein Sprachmodell braucht keine Schnittstellenbeschreibung, sondern Werkzeuge: klar benannte Aufrufe mit klar benannten Parametern. Das Model Context Protocol (MCP) ist das Format dafür. Die Server dieser Registry entstehen nicht neben den APIs, sondern aus ihnen. Wer die [APIs](https://maklerportal.apim.eu/apis) kennt, findet hier dieselben Vorgänge wieder – nur als Werkzeug statt als Endpunkt. Was am API-Katalog gilt, gilt deshalb auch hier: dasselbe Fehlerformat, dieselbe Authentifizierung, dieselben Berechtigungen. Vorgeschaltet ist in jedem Fall das **Kong AI Gateway**. Es entscheidet, wer welchen Server und welches Werkzeug aufrufen darf, protokolliert jeden Aufruf und hält die Werkzeugliste aktuell. ## [MCP-Server für Entwickler](#mcp-server-für-entwickler) Diese Liste kommt unmittelbar aus der Konnect-MCP-Registry `maklerportal`. Sie zeigt stets den veröffentlichten Stand – kommt ein Server hinzu, erscheint er hier, ohne dass diese Seite angefasst werden muss. [ ## Besichtigungstermine 1.0.0 Besichtigungen planen, verschieben, freie Zeitfenster und Rückmeldungen bearbeiten. ](https://maklerportal.apim.eu/mcp-registries/maklerportal/mcp-servers/maklerportal%2Fbesichtigungstermine)[ ## Bodenrichtwerte 1.0.0 Amtliche Bodenrichtwerte zu einer Lage abfragen. ](https://maklerportal.apim.eu/mcp-registries/maklerportal/mcp-servers/maklerportal%2Fbodenrichtwerte)[ ## Geoportal Hamburg 1.0.0 Bebauungspläne, Lärmkarten und Milieuschutzgebiete abfragen. ](https://maklerportal.apim.eu/mcp-registries/maklerportal/mcp-servers/maklerportal%2Fgeoportal-hamburg)[ ## Grundbuchauszug 1.0.0 Abteilungen, Lasten und Beschränkungen zu einem Flurstück abrufen. ](https://maklerportal.apim.eu/mcp-registries/maklerportal/mcp-servers/maklerportal%2Fgrundbuchauszug)[ ## Interessenten und Leads 1.0.0 Interessenten und Anfragen verwalten, passende Suchprofile zu einem Objekt finden. ](https://maklerportal.apim.eu/mcp-registries/maklerportal/mcp-servers/maklerportal%2Finteressenten)[ ## Marktwertermittlung 1.0.0 Marktwerte, Vergleichswerte und Mietspiegelwerte zu einem Objekt ermitteln. ](https://maklerportal.apim.eu/mcp-registries/maklerportal/mcp-servers/maklerportal%2Fmarktwertermittlung)[ ## Objektverwaltung 1.0.0 Objekte des Maklerbestands auflisten, abrufen, anlegen und ändern. ](https://maklerportal.apim.eu/mcp-registries/maklerportal/mcp-servers/maklerportal%2Fobjektverwaltung)[ ## Provisionsabrechnung 1.0.0 Provisionsabrechnungen abrufen und die Courtage vorab berechnen. ](https://maklerportal.apim.eu/mcp-registries/maklerportal/mcp-servers/maklerportal%2Fprovisionsabrechnung) ## [Fachverfahren des Maklerportals](#fachverfahren-des-maklerportals) Diese Server bilden die eigenen APIs als Werkzeuge ab. Jeder Eintrag ist über seinen Pfad am Gateway erreichbar. | Server | Pfad | Werkzeuge | | :---------------------- | :------------------------ | :------------------------------------------------------------------------------- | | Objektverwaltung | /mcp/objektverwaltung | objekte-auflistenobjekt-abrufenobjekt-anlegenobjekt-aendernmedien-auflisten | | Interessenten und Leads | /mcp/interessenten | interessenten-auflisteninteressent-abrufenanfrage-erfassenanfrage-bewertenpassende-interessenten | | Besichtigungstermine | /mcp/besichtigungstermine | termine-auflistentermin-anlegentermin-verschiebenfreie-zeitfensterrueckmeldung-erfassen | | Marktwertermittlung | /mcp/marktwertermittlung | bewertung-anfordernbewertung-abrufenvergleichswerte-abfragenmietspiegel-abfragen | | Provisionsabrechnung | (Werkzeugbibliothek) | abrechnungen-auflistenabrechnung-abrufencourtage-berechnen | Die **Provisionsabrechnung** ist bewusst ohne eigenen Endpunkt eingerichtet. Sie dient als Bibliothek, aus der andere Server ihre Werkzeuge beziehen – Abrechnungsdaten sollen nicht versehentlich an einem offenen Endpunkt landen. ## [Angebundene Fremdsysteme](#angebundene-fremdsysteme) Diese Server sprechen bereits MCP. Das Gateway reicht sie unverändert durch und ergänzt Zugangsschutz und Protokollierung. | Server | Pfad | Wofür | | :---------------- | :--------------------- | :-------------------------------------------------------- | | Bodenrichtwerte | /bodenrichtwerte | Amtliche Bodenrichtwerte zu einer Lage | | Grundbuchauszug | /mcp/grundbuchauszug | Abteilungen, Lasten und Beschränkungen zu einem Flurstück | | Geoportal Hamburg | /mcp/geoportal-hamburg | Bebauungspläne, Lärmkarten und Milieuschutzgebiete | Für Fremdsysteme gilt derselbe Zugangsschutz wie für die eigenen Server. Ein Zugang, der Grundbuchdaten nicht sehen darf, bekommt das entsprechende Werkzeug gar nicht erst in seiner Liste angezeigt. Aus der Spezifikation, nicht daneben Die Werkzeuge der Fachverfahren entstehen aus denselben OpenAPI-Spezifikationen, die auch den API-Katalog speisen. Ändert sich ein Endpunkt, ändert sich das Werkzeug mit – eine zweite Beschreibung, die veralten kann, gibt es nicht. Berechtigungen je Werkzeug Der Zugriff wird nicht nur je Server geregelt, sondern je Werkzeug. Ein lesender Zugang erhält `objekte-auflisten`, aber nicht `objekt-aendern` – und sieht den Unterschied schon in der Werkzeugliste. Jeder Aufruf ist nachvollziehbar Das Gateway protokolliert, welcher Zugang wann welches Werkzeug mit welchem Ergebnis aufgerufen hat. Bei einem Agenten, der selbständig entscheidet, ist das kein Zusatz, sondern die Voraussetzung. **Zugang:** MCP-Server werden mit demselben API-Schlüssel aufgerufen wie die übrigen Schnittstellen. Wie Sie einen Schlüssel erzeugen, steht unter [Authentifizierung](https://maklerportal.apim.eu/leitfaeden/authentifizierung). Die Basisadresse des Gateways hängt von der Umgebung ab – die Pfade oben bleiben in allen Umgebungen gleich. ## [Betriebsarten der Server](#betriebsarten-der-server) Ein MCP-Server im Gateway hat immer eine von mehreren Betriebsarten. Für das Maklerportal sind drei davon im Einsatz: | Betriebsart | Was sie tut | Hier im Einsatz | | :------------------- | :--------------------------------------------------------------------- | :--------------------- | | conversion-listener | Übersetzt eine REST-API in Werkzeuge und nimmt MCP-Anfragen entgegen | Die vier Fachverfahren | | conversion-only | Übersetzt eine REST-API in Werkzeuge, ohne selbst erreichbar zu sein | Provisionsabrechnung | | passthrough-listener | Reicht einen fremden MCP-Server durch, ohne die Werkzeuge zu verändern | Die drei Fremdsysteme | Wer die Server selbst nachbauen will, findet die vollständige deklarative Konfiguration im Repository unter `ai-gateway/config/mcp-servers.yaml`. ## Bereit für die erste Anbindung? Registrieren Sie sich, legen Sie eine Anwendung an und erzeugen Sie Ihr erstes Exposé in unter zehn Minuten. [Zugang anfordern](https://maklerportal.apim.eu/erste-schritte)[API-Katalog ansehen](https://maklerportal.apim.eu/apis)