MCP ServerFür Entwickler
Überblick
Der MCP-Server sitzt unter https://mcp.bodenrichtwert.ai/mcp und spricht Streamable HTTP mit OAuth-2.0-Authentifizierung. Clients, die den MCP-Standard unterstützen, finden die OAuth-Endpoints automatisch über die Discovery-Dokumente und führen den Token-Flow selbst durch.
Verfügbare Tools
| Tool | Beschreibung |
|---|---|
get_bodenrichtwert | Bodenrichtwert per Adresse abfragen (optional mit Nutzungsart W / M / G / S / L / F / SO) |
calculate_bodenwert | Bodenrichtwert bei abweichender Geschossflächenzahl (GFZ) umrechnen, optional mit Grundstücksfläche zum Bodenwert (Gesamtwert) — reine Berechnung, zählt nicht gegen dein Kontingent |
Deine aktuelle Nutzung und dein Plan-Limit siehst du im Dashboard oder per REST unter GET /api/me.
Claude Desktop (als Referenz-Client)
- Claude Desktop → Settings → Developer → Edit Config.
- Eintrag ergänzen:
{
"mcpServers": {
"bodenrichtwert": {
"url": "https://mcp.bodenrichtwert.ai/mcp"
}
}
}
- Claude neu starten. Beim ersten Aufruf öffnet sich der Browser zum OAuth-Login.
Weitere MCP-Clients
Jeder Client, der die MCP-OAuth-Discovery (/.well-known/oauth-protected-resource) unterstützt, kann den Server nutzen. Die Einrichtung ist immer die gleiche: URL https://mcp.bodenrichtwert.ai/mcp eintragen, OAuth-Flow bestätigen, fertig.
| Client | Einstellungsort |
|---|---|
| Perplexity Desktop / Mobile | Settings → „Connectors" → Custom MCP Server → URL eintragen |
| Cursor | Settings → „MCP" → neuen Server mit URL registrieren |
| Windsurf | Settings → „MCP" → MCP Server hinzufügen |
| Zed | mcp.json im Workspace ergänzen, URL eintragen |
Eigene Hosts (z. B. claude-code-CLI, mcp-host) | Server mit URL registrieren |
| Lokale Modelle (Ollama mit MCP-Adapter) | URL als MCP-Server eintragen |
In allen Fällen läuft OAuth über denselben Authority-URL — du meldest dich einmal bei bodenrichtwert.ai an, danach sprechen Client und Server unsichtbar.
Prompt-Beispiele
„Was ist der Bodenrichtwert für Unter den Linden 1, Berlin?"
„Vergleich die Bodenrichtwerte von Alexanderplatz, Potsdamer Platz und Hackescher Markt."
Eigenen MCP-Client bauen
Wenn du einen eigenen MCP-Client implementierst, siehe Einführung für direkt verwendbare Code-Beispiele — in vielen Fällen ist die REST API der einfachere Weg als eine eigene MCP-Implementierung.
Technische Details
Der Server implementiert Streamable HTTP nach RFC 9728 mit OAuth 2.0 Protected Resource Metadata und liefert die Discovery-Dokumente unter:
https://mcp.bodenrichtwert.ai/.well-known/oauth-protected-resource— verweist auf den Authority-Server (https://bodenrichtwert.ai)https://mcp.bodenrichtwert.ai/.well-known/oauth-authorization-server— RFC 8414 Metadata mitauthorization_endpoint,token_endpoint,registration_endpoint
Beim ersten Call ohne Token antwortet /mcp mit 401 und dem Header WWW-Authenticate: Bearer resource_metadata="…". Standardkonforme Clients lesen daraus die Discovery-URL, fragen die OAuth-Metadata ab, registrieren sich dynamisch via RFC 7591 (/oauth/register) und führen den Authorization-Code-Flow mit PKCE (S256) durch.
Nach erfolgreichem Login erhält der Client ein Bearer Token, das er in jedem folgenden Request als Authorization: Bearer <token> mitschickt.