Schnellstart
CLI installieren, authentifizieren, Server in Claude Code einbinden und alles in fünf Minuten verifizieren.
Installieren
# macOS via Homebrew
brew install mapular/tap/mapular
# oder via pip
pip install mapular
Authentifizieren
mapular login
Dies öffnet einen Browser-Tab für den Auth0 Device Flow. Nach der Bestätigung wird das Token unter ~/.mapular/state.json gespeichert. Dieser Schritt ist nur einmalig erforderlich.
In KI-Client einbinden
mapular install
Dies schreibt die MCP-Server-Konfiguration in:
.mcp.jsonim aktuellen Verzeichnis (für Claude Code)- die Konfigurationsdatei von Claude Desktop (falls installiert)
Öffnen Sie Claude Code neu. Tippen Sie /mcp — alle drei Server sollten als verbunden aufgelistet sein.
Funktionalität verifizieren
Diese drei Prompts in Claude Code bestätigen, dass jeder Server aktiv ist:
| Prompt | Testet |
|---|---|
| "List available MPOI regions" | mapular-mpoi |
| "Run SELECT 1 as test" | mapular-geo |
| "Show session info" | mapular-admin |
Alle drei sollten ohne Fehler Ergebnisse zurückgeben.
Demo-Modus
Wenn Sie mapular login überspringen, startet mapular-mpoi im Demo-Modus mit einem mitgelieferten demo-berlin-Datensatz. Alle sieben MPOI-Tools funktionieren damit — nützlich zur Erkundung vor der Authentifizierung.
mapular-geo benötigt nie Zugangsdaten. mapular-admin erfordert eine aktive Sitzung.