Bodenrichtwerte per MCP-Server integrieren

Ein MCP-Server lässt sich in jeden MCP-fähigen Client einbinden — Claude Desktop, Perplexity, Cursor, Windsurf, Zed oder einen selbst gebauten Agenten. In allen Fällen genügt eine URL, der Rest läuft automatisch über OAuth. Was dabei technisch passiert — und wie du die Anbindung in deinem Client einrichtest — ist Thema dieses Artikels.

Für die reine Klick-Anleitung ohne Technik in Claude: Bodenrichtwert mit Claude abfragen. Hier geht es eine Ebene tiefer.

Was MCP ist

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Clients (Claude Desktop, Perplexity, Cursor, Agenten-Frameworks, eigene Apps) externe Werkzeuge und Datenquellen ansprechen. Statt für jede KI eine eigene Integration zu bauen, stellst du einen MCP-Server bereit — und jeder MCP-fähige Client kann ihn nutzen.

Unser Server liegt unter:

MCP-Server

https://mcp.bodenrichtwert.ai/mcp

Er spricht Streamable HTTP (die aktuelle MCP-Transport-Variante) und stellt das Bodenrichtwert-Werkzeug als Tool bereit, das die KI bei Bedarf aufruft.

Warum MCP und nicht manuelle Tool-Definition

Ohne MCP müsstest du das Werkzeug bei jeder Integration von Hand beschreiben — pro Framework ein eigenes Schema, das Name, Parameter und Einsatzzweck des Tools festlegt, etwa:

{
  "name": "get_bodenrichtwert",
  "description": "Amtlichen Bodenrichtwert für eine deutsche Adresse abrufen",
  "parameters": {
    "type": "object",
    "properties": { "address": { "type": "string" }, "nutzungsart": { "type": "string" } },
    "required": ["address"]
  }
}

Das funktioniert, muss aber für jedes Framework einzeln gepflegt werden — ändert sich ein Parameter, aktualisierst du jede Integration separat. Mit MCP entfällt das: Der Client fragt den Server bei der Verbindung selbst nach den verfügbaren Werkzeugen, inklusive Beschreibung und Parametern. Das Modell weiß dadurch, wann es den Bodenrichtwert nachschlagen soll, ohne dass du es ihm in jeder Tool-Definition manuell erklärst — genau das macht aus einem ratenden ein nachschlagendes Modell (warum der Unterschied zählt: Warum dein KI-Assistent halluziniert).

Der Verbindungsablauf (OAuth-Discovery)

Anders als ein API-Key-Setup handelt MCP die Authentifizierung über OAuth aus. Der Client muss nichts außer der URL kennen — den Rest findet er selbst. Das Ergebnis: kein manuelles Kopieren von Tokens, kein Konfigurationsfile mit Geheimnissen. Genau deshalb genügt in jedem MCP-Client nur die URL.

Beispiel: Claude Desktop (Referenz-Client)

Einstellungen öffnen

Öffne in Claude Desktop die Einstellungen und wähle „Customize".

Custom Connector hinzufügen

Klicke auf „Custom Connector hinzufügen" und trage diese Adresse ein:

MCP-Server

https://mcp.bodenrichtwert.ai/mcp

Anmelden

Einmal anmelden — im Chat erscheint die Abfrage danach als get_bodenrichtwert.

Connectors

bodenrichtwert.ai

mcp.bodenrichtwert.ai/mcp

Verbunden

In anderen Clients und eigenen Agenten

Das Prinzip ist überall identisch: Server-URL eintragen, OAuth-Flow oben bestätigen, fertig. Perplexity, Cursor, Windsurf, Zed, selbst gehostete Clients (etwa claude-code) und lokale Modelle mit MCP-Adapter (Ollama) funktionieren alle so — die vollständige Client-Tabelle mit den jeweiligen Einstellungsorten steht in den Docs → MCP-Server. Für Frameworks, die noch kein MCP sprechen, ist die REST-API der direktere Weg.

Was das Tool zurückgibt

Die Antwort ist dieselbe normalisierte Struktur wie bei der REST-API: Bodenrichtwert(e) pro Nutzungsart, Stichtag, Gutachterausschuss, Koordinaten — plus das attribution-Objekt und den Disclaimer. Mehrere Zonen pro Punkt kommen als Array; SH/SN/BY werden mit einem klaren Block beantwortet statt mit Falschwerten.

Compliance ist eingebaut: Jede Antwort trägt die dl-de/by-2-0-Attribution und den Hinweis, dass der Bodenrichtwert ein Orientierungswert ist — kein Verkehrswert, kein Verkaufspreis, keine Rechtsberatung. Reich beides in deinem Client mit durch.

Ein Beispiel im Chat

Du (in Claude): Wie hoch ist der amtliche Bodenrichtwert für die Musterstraße 12 in Köln, Nutzungsart Wohnen?

Claude erkennt selbst, dass die Frage zum verbundenen Werkzeug passt, ruft get_bodenrichtwert mit address="Musterstraße 12, Köln" und nutzungsart="W" auf und bekommt strukturiert zurück:

{
  "bodenrichtwerte": [
    { "nutzungsart": "Wohnen", "code": "W", "brw_euro_pro_m2": 620, "stichtag": "2025-01-01", "gutachterausschuss": "Köln" }
  ],
  "attribution": { "text": "© Daten der Gutachterausschüsse für Grundstückswerte 2025, dl-de/by-2-0" }
}

Claude: Der amtliche Bodenrichtwert für Wohnbauflächen liegt bei 620 €/m² (Stichtag 1. Januar 2025, Gutachterausschuss Köln). Quelle: dl-de/by-2-0.

Der Client entscheidet selbst, wann er das Tool braucht. Fragst du stattdessen nach einer anderen Nutzungsart oder einer zweiten Adresse, ruft Claude dasselbe Tool erneut mit anderen Parametern auf — ohne dass du dafür etwas konfigurierst.

MCP-Server testen: Token bzw. Account holen, https://mcp.bodenrichtwert.ai/mcp in deinem Client eintragen — die ersten Abfragen sind im 14-Tage-Trial frei. Volle Doku: Docs → MCP-Server.