Zum Inhalt springen
MCP-Server für Österreich-Geodaten

MCP-Server für Österreich-Geodaten

Der mapx-MCP-Server gibt einem KI-Assistenten 23 Werkzeuge für Österreich-Geodaten: Adresssuche, Routen, öffentlicher Verkehr, Höhen, Katastergrundstücke, Verkehr und Wetter. Er nutzt das Model Context Protocol (MCP), jeder MCP-Client kann sich verbinden. Alle Werkzeuge lesen nur, die Daten gelten nur für Österreich und stammen aus amtlichen offenen Daten, jede Antwort nennt ihre Quelle.

Endpunkthttps://mcp.mapx.at/mcp
TransportStreamable HTTP, nur POST, zustandslos
Protokollfassungen2026-07-28 und ältere ab 2024-11-05
AnmeldungEntweder über dein mapx-Konto (OAuth 2.1 mit PKCE, nur die Adresse eintragen) oder mit einem Token vom Typ „KI-Assistent (MCP)“, Präfix mx_mcp_, im Header Authorization: Bearer …

Einrichten

Es gibt zwei Wege. Die Anmeldung über dein Konto ist der einfachere: Du trägst nur die Adresse ein, ein Token wird nicht kopiert. Der Weg mit Token funktioniert mit jedem MCP-Client.

Mit Anmeldung über dein Konto

  1. Trage https://mcp.mapx.at/mcp als MCP-Server in deiner Anwendung ein (siehe unten).
  2. Der Assistent leitet dich zu account.mapx.at. Melde dich an oder registriere dich.
  3. Auf der Zustimmungsseite siehst du die Anwendung, das Weiterleitungsziel, dein Konto und was der Zugriff erlaubt: nur lesende Werkzeuge, Aufrufe zählen zu deiner Nutzung, kein Zugriff auf dein Konto oder deine anderen Tokens. Bestätige die Verbindung.
  4. Stelle eine Frage, die österreichische Daten braucht, zum Beispiel „Wie komme ich mit dem Rad vom Bahnhof Melk zum Stift Melk, und wie lange dauert das?“.

Die Verbindung erscheint danach unter account.mapx.at → Tokens als „verbunden über “. Je Anwendung sind bis zu fünf Verbindungen gleichzeitig möglich, zum Beispiel Browser, Desktop und Handy. Die Verbindung läuft nicht von selbst ab.

Diese Anwendungen sind für die Anmeldung über das Konto freigegeben:

  • claude.ai (Web, Desktop, Mobil): in den Einstellungen unter Connectors einen eigenen Connector hinzufügen und die Adresse eintragen. Die genaue Menüführung hängt vom Tarif ab und ändert sich; sie steht in der Hilfe von Anthropic. In Team- und Enterprise-Tarifen legt zuerst ein Owner den Connector an.
  • Claude Code: claude mcp add --transport http mapx https://mcp.mapx.at/mcp, dann in Claude Code /mcp eingeben und die Anmeldung für mapx starten.
  • ChatGPT: Connectoren bzw. Apps mit eigener MCP-Adresse, je nach Tarif und Einstellung verfügbar (teils nur im Entwicklermodus). Schritte und Verfügbarkeit stehen in der Hilfe von OpenAI.

Die Anmeldung über das Konto ist auf bekannte Anwendungen beschränkt. Für alle anderen Clients nimm den Weg mit Token; weitere Anwendungen schaltet der Support auf Anfrage frei (support@mapx.at).

Mit Token

  1. Lege unter account.mapx.at/tokens/new?kind=mcp einen Token an. Wähle den Typ KI-Assistent (MCP), vergib einen Namen und optional ein Ablaufdatum. Der Token wird einmal angezeigt; kopiere ihn dann.
  2. Trage den Server in deinen Client ein (siehe unten) und setze den Token dort ein, wo die Beispiele YOUR_MCP_TOKEN zeigen.
  3. Stelle eine Frage, die österreichische Daten braucht.

Der Token gilt nur am MCP-Server. Er hat keine Domain- oder IP-Bindung, kann ein Ablaufdatum haben und lässt sich in deinem Konto jederzeit sperren oder rotieren.

Clients für den Weg mit Token

Diese Clients nehmen einen festen Header, der Token steht also direkt in der Konfiguration.

claude mcp add --transport http mapx https://mcp.mapx.at/mcp --header "Authorization: Bearer YOUR_MCP_TOKEN"

Verbindung trennen

Unter account.mapx.at → Tokens findest du jede Verbindung über das Konto als „verbunden über “. Mit Verbindung trennen beendest du sie, mit Sperren wird sie sofort abgelehnt und lässt sich wieder entsperren. Der Assistent bekommt danach 401 und fragt bei Bedarf neu nach der Anmeldung.

Für Entwickler

Der MCP-Server folgt der MCP-Autorisierung (OAuth 2.1):

  • Protected Resource Metadata: https://mcp.mapx.at/.well-known/oauth-protected-resource/mcp
  • Autorisierungsserver: https://account.mapx.at (Metadaten unter /.well-known/oauth-authorization-server)
  • Authorization Code mit PKCE (S256); öffentliche Clients identifizieren sich über Client ID Metadata Documents, eine dynamische Registrierung gibt es nicht.
  • Scope mcp. Das Zugriffstoken läuft nicht ab, es gibt keinen Refresh-Token; der Widerruf geschieht im Konto.

Limits, Zählung und Werkzeuge sind für beide Wege gleich.

Werkzeuge

Der Assistent wählt die Werkzeuge selbst. Koordinaten sind {lon, lat} in WGS84; geocode macht aus einem Ortsnamen Koordinaten für die anderen Werkzeuge.

GruppeWerkzeugZweckWichtigste Eingaben
SuchegeocodeKoordinaten zu Adresse, Straße, Ort, PLZ, POI, Grundstück oder Straßenkilometerquery, near, types, limit
Suchereverse_geocodeNächste Adresse oder nächster Ort zu einer Koordinatelon, lat, radius_m, types
Suchevalidate_addressAdresse gegen das amtliche Register prüfen und normalisierenaddress oder street, housenumber, postcode, place
Suchesearch_placesOrte (POI) nach Kategorie oder Namecategory, query, near, radius_m, limit
Suchelist_place_categoriesKategorie-Ids für search_placeskeine
RoutingrouteRoute mit Auto, Lkw, Rad oder zu Fuß mit Distanz, Zeit und Anweisungenprofile, waypoints (2 bis 25), exclude, truck
RoutingisochroneGebiet, das in gegebenen Minuten oder Metern erreichbar istprofile, lon, lat, minutes, meters, depart_at
Routingtravel_matrixFahrzeiten zwischen 2 bis 25 Punktenprofile, points, sources, destinations
Routingoptimize_stopsSchnellste Reihenfolge von 2 bis 25 Stoppsprofile, stops, roundtrip, start, end
ÖVtransit_routeVerbindungen zwischen zwei Punkten aus dem Fahrplanfrom, to, depart_at, arrive_by, access, connections
ÖVdeparturesNächste planmäßige Abfahrten an einer Haltestelle oder um einen Punktstop_id oder near, time, limit
ÖVfind_stopsHaltestellen nahe einem Punkt oder in einem Rechteck, mit stop_idnear, radius_m, bbox, limit
HöheelevationHöhe über dem Meer (Gelände- oder Oberflächenmodell)points, model
Höheelevation_profileAnstieg, Abstieg, tiefster und höchster Punkt entlang einer Liniepath (2 bis 200 Punkte), samples, model
Grundstückparcel_at_pointKatastergrundstück an einer Koordinatelon, lat, radius_m
Grundstückparcel_detailsGrundstücks-Dossier: Fläche, Nutzung, Gebäude, Neigung, Adressenparcel_id
Verkehrtraffic_incidentsUnfälle, Stau, Baustellen und Sperrenbbox, road, road_class, types, planned
Verkehrspeed_limitsGesetzliche Tempolimits an einem Punkt, in einem Rechteck oder entlang eines Pfadsat, bbox, path, buffer_m
WetterweatherAktuelle Messwerte, stündliche Vorhersage oder Nowcastlon, lat, kind, hours
Wetterweather_warningsAmtliche Wetterwarnungenat, bbox, type, min_level, active_now
WetterclimateLangfristige Klimadaten, Solarpotenziallon, lat, sections
Wetterair_qualityLuftgüteindex und Schadstoffelon, lat, hours
Kartestatic_mapKartenbild mit Markern und Liniecenter, zoom, pins, line, style, width, height

search_places mit Freitext und near sucht nur im Umkreis radius_m (500 bis 100000 Meter, Standard 25000), sortiert nach Entfernung und sagt ausdrücklich, wenn es auf weiter entfernte Treffer ausweichen muss. Die Kategoriesuche liefert immer die nächsten zuerst und ignoriert radius_m.

Zeitangaben im Antworttext sind österreichische Ortszeit mit Versatz, zum Beispiel 2026-11-18T08:00+01:00; das gilt für Wetter, Warnungen, Luftqualität und Verkehrsmeldungen. ÖV-Zeiten sind ebenfalls Ortszeit. Der strukturierte Teil des Ergebnisses (structuredContent) behält die Zeitstempel der API.

Routing-Profile sind driving, driving-traffic, driving-truck, cycling, cycling-mtb und walking; isochrone kennt zusätzlich transit.

Beispielfragen

  • „Wo liegt die Herrengasse 13 in Wien, und wo ist die nächste Tankstelle?“
  • „Wie lange braucht ein Lkw mit 40 t von Wien nach Linz, und gibt es Sperren auf dem Weg?“
  • „Was erreiche ich vom Bahnhof Melk in 15 Minuten zu Fuß?“
  • „Was sind die nächsten Abfahrten am Bahnhof Melk?“
  • „Wie hoch liegt die Gegend um den Großglockner, und wie sieht das Profil meines Wanderwegs aus?“
  • „Welches Grundstück liegt bei 16.3725, 48.2085, wie groß ist es, und ist es Bauland?“
  • „Regnet es in Innsbruck in den nächsten drei Stunden?“
  • „Plane die beste Reihenfolge für diese fünf Lieferadressen und zeig sie auf einer Karte.“

Limits und Zählung

Jeder Werkzeugaufruf zählt wie ein API-Aufruf und erscheint in deiner Nutzungsansicht als MCP. Manche Werkzeuge lösen mehrere API-Aufrufe aus, etwa die Freitextsuche in search_places (bis zu 11). Die Protokollnachrichten selbst (jede Anfrage an /mcp) stehen getrennt als Produkt mcp in der Nutzung; sie verbrauchen das Minutenlimit nicht. Es gelten das Minutenlimit deines Tokens (standardmäßig 6000) und die Zonenlimits der API, über MCP je Token statt je IP-Adresse (Zugang und Limits). Der MCP-Endpunkt selbst nimmt 10 Anfragen pro Sekunde je IP-Adresse an (Burst 40), Anfragekörper bis 256 KB. Je Token laufen höchstens 4 Aufrufe gleichzeitig; weitere warten oder scheitern mit einer Wartezeit. Bei Überschreitung bekommt der Assistent eine Fehlermeldung mit Wartezeit.

Fehler

Der Assistent erhält den Fehler als Text und kann darauf reagieren. Fehlercodes und Ursachen stehen unter Fehler und Limits, besonders mcp-token-only und mcp-token-required.

Grenzen

  • Nur Österreich; die Daten stammen aus amtlichen offenen Daten, jede Antwort nennt die Quelle.
  • Alle Werkzeuge lesen nur; nichts wird geändert oder gespeichert.
  • ÖV-Antworten stammen aus dem Fahrplan, ohne Echtzeitdaten.
  • Klima, Wetter, Warnungen und Luftqualität stammen von der GeoSphere Austria, Verkehrsmeldungen von ASFINAG und EVIS.AT.
  • Lange Ergebnisse werden gekürzt.

Datenschutz

Deine Fragen und die Ergebnisse laufen über den Anbieter deines Assistenten. mapx sieht nur die Werkzeugaufrufe, wie bei normalen API-Aufrufen.

Fehlersuche

SymptomUrsache und Abhilfe
401Kein oder ungültiger Token. Bei Anmeldung über das Konto startet der Assistent damit die Anmeldung; nach dem Trennen oder Sperren meldet er 401 und fragt neu. Beim Weg mit Token prüfe den Header Authorization: Bearer und ob der Token gelöscht wurde oder abgelaufen ist.
Fehlerseite „Anwendung nicht zugelassen“Die Anwendung steht nicht auf der Liste der freigegebenen Anwendungen. Nimm den Weg mit Token oder schreibe an support@mapx.at.
403 mcp-token-requiredAm MCP-Server wurde ein öffentlicher (mx_pk_) oder geheimer (mx_sk_) Token verwendet. Lege einen Token vom Typ „KI-Assistent (MCP)“ an.
403 mcp-token-onlyEin mx_mcp_-Token wurde für einen direkten API-Aufruf verwendet. Nimm dort einen geheimen Token (mx_sk_).
429Ein Limit wurde überschritten. Warte die in der Meldung genannte Zeit und rufe weniger parallel auf.
403 bei einem Browser-ClientDer Origin ist nicht erlaubt. Browser-Clients müssen von einer erlaubten Seite kommen; nimm einen Desktop-Client oder die API.

Weiter