Mapbox MCP Server einrichten
Mapbox MCP Server einrichten: gehosteter Endpunkt oder lokales Token, erster Test und sinnvolle Grenzen.
- Skill Road
- Mapbox MCP Server einrichten
Veröffentlicht am 30.09.2026
Der Mapbox MCP Server gibt KI-Clients wie Claude Code oder Cursor Zugriff auf Geocoding, Routing und Kartenbilder von Mapbox. Dieser Ratgeber zeigt den schnellsten Weg zur ersten funktionierenden Verbindung.
Gehosteten Endpunkt nutzen
Der einfachste Weg ist der gehostete Server. In Claude Code genügt claude mcp add --transport http mapbox https://mcp.mapbox.com/mcp. Beim ersten Start öffnet sich ein Browserfenster für den OAuth-Login bei Mapbox, danach sind die Werkzeuge verfügbar.
Lokal mit Access Token betreiben
Wer den Server lokal oder in einer Pipeline ausführen möchte, legt ein kostenloses Mapbox-Konto an, erstellt ein Access Token und installiert das npm-Paket @mapbox/mcp-server. Das Token übergeben Sie als Umgebungsvariable MAPBOX_ACCESS_TOKEN, nie im Prompt oder im Repository. Konfigurationsbeispiele für Claude Desktop, VS Code, Cursor und Goose stehen im offiziellen Repository.
Verbindung testen
Starten Sie mit einer harmlosen Anfrage, etwa der Entfernung zwischen zwei Städten oder dem Geocoding einer öffentlichen Adresse. Die Distanz- und Flächenwerkzeuge rechnen offline und zeigen schnell, ob der Server läuft.
Grenzen bewusst setzen
API-Werkzeuge senden Adressen und Koordinaten an Mapbox. Geben Sie vertrauliche Kundendaten nur nach Prüfung der Datenschutzbedingungen weiter, und behalten Sie die Nutzung in Ihrem Mapbox-Konto im Blick.
Häufige Fragen
Gehosteter Endpunkt oder lokale Installation?
Für interaktive Clients ist der gehostete Endpunkt mit OAuth am schnellsten. Lokal mit Token lohnt sich für Pipelines, Headless-Agenten oder wenn Sie den Server selbst kontrollieren möchten.
Welche Werkzeuge verursachen keine API-Aufrufe?
Laut README rechnen die Offline-Geospatial-Werkzeuge wie Distanz, Fläche, Puffer oder Polygon-Operationen rein lokal. Suche, Routing und Kartenbilder nutzen dagegen die Mapbox-APIs.
Warum zeigt mein Client nur ein statisches Kartenbild?
Interaktive Karten benötigen einen Client mit Unterstützung für MCP Apps. Andere Clients fallen auf das statische Kartenbild zurück.
Wie halte ich die Kosten im Griff?
Nutzen Sie möglichst die Offline-Werkzeuge und prüfen Sie Kontingente sowie Verbrauch im Mapbox-Konto. Details zu Preisen veröffentlicht Mapbox auf der offiziellen Preisseite.