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
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 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
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.
Bodenrichtwerte
1.0.0
Amtliche Bodenrichtwerte zu einer Lage abfragen.
Geoportal Hamburg
1.0.0
Bebauungspläne, Lärmkarten und Milieuschutzgebiete abfragen.
Grundbuchauszug
1.0.0
Abteilungen, Lasten und Beschränkungen zu einem Flurstück abrufen.
Interessenten und Leads
1.0.0
Interessenten und Anfragen verwalten, passende Suchprofile zu einem Objekt finden.
Marktwertermittlung
1.0.0
Marktwerte, Vergleichswerte und Mietspiegelwerte zu einem Objekt ermitteln.
Objektverwaltung
1.0.0
Objekte des Maklerbestands auflisten, abrufen, anlegen und ändern.
Provisionsabrechnung
1.0.0
Provisionsabrechnungen abrufen und die Courtage vorab berechnen.
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
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. Die Basisadresse des Gateways hängt von der Umgebung ab – die Pfade oben bleiben in allen Umgebungen gleich.
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.