MCP-Server – Geodata Portal

Endpunkt

Der MCP-Server spricht JSON-RPC 2.0 über HTTP POST und authentifiziert sich mit demselben API-Key wie die REST-API. Der Key benötigt den Scope mcp:use.

POST https://geodata.bitfertig.de/mcp
Authorization: Bearer 42|geo_xxxxxxxxxxxx
Content-Type: application/json

Werkzeuge

Werkzeug	Zweck	Pflichtparameter
`geocode`	Adresse, PLZ oder Ortsname zu Koordinaten	`query`
`reverse_geocode`	Koordinaten zur nächstgelegenen Adresse	`lat`, `lon`

Die maschinenlesbare Werkzeugliste liegt unter https://geodata.bitfertig.de/mcp/tools.

Einmalig im Terminal registrieren:

claude mcp add --transport http geodata \
  https://geodata.bitfertig.de/mcp \
  --header "Authorization: Bearer $GEO_API_KEY"

Danach steht der Server in jeder Session zur Verfügung; mit /mcp lässt sich der Status prüfen.

In claude_desktop_config.json eintragen (HTTP-Server werden über mcp-remote angebunden):

{
  "mcpServers": {
    "geodata": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://geodata.bitfertig.de/mcp",
        "--header", "Authorization: Bearer 42|geo_xxxxxxxxxxxx"
      ]
    }
  }
}

Nach dem Speichern Claude Desktop neu starten.

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "geodata": {
      "url": "https://geodata.bitfertig.de/mcp",
      "headers": {
        "Authorization": "Bearer 42|geo_xxxxxxxxxxxx"
      }
    }
  }
}

Werkzeugaufruf ohne Client:

curl -X POST https://geodata.bitfertig.de/mcp \
  -H "Authorization: Bearer $GEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "reverse_geocode",
      "arguments": {
        "lat": 52.520008,
        "lon": 13.404954,
        "limit": 3
      }
    }
  }'

Beispiel-Prompts

Sobald der Server verbunden ist, genügen Aufgaben in natürlicher Sprache:

Nimm diese 20 Kundenadressen und ergänze für jede Koordinaten und PLZ.

Welche Adresse liegt an den Koordinaten 53.5503, 10.0007? Nenne die drei nächsten.

Prüfe, ob es die Straße „Neue Promenade“ in Berlin gibt, und nenne die Hausnummer 5.

Wie weit ist es Luftlinie von der Bahnhofstraße Leipzig zur Königstraße 1 in Stuttgart?

Ordne diese Liste von Postleitzahlen den zugehörigen Orten zu.

Bereinige diese Adressliste: markiere Einträge, zu denen keine Hausnummer gefunden wird.

Gut zu wissen

Gleiche Zählung wie REST: MCP-Aufrufe teilen Kontingent und Rate-Limit.
Werkzeugfehler kommen als Ergebnis mit isError, nicht als Transportfehler.
Antworten enthalten neben Text auch structuredContent zur Weiterverarbeitung.
Den API-Key wie ein Passwort behandeln – er steht im Klartext in der Client-Konfiguration.

Protokoll

Transport

HTTP POST, JSON-RPC 2.0

Protokollversion

2025-06-18

Methoden

initialize, ping, tools/list, tools/call

Batching

unterstützt (Array von Nachrichten)

MCP-Server für KI-Clients

Endpunkt

Werkzeuge

Beispiel-Prompts

Gut zu wissen

Protokoll