MCP-Server — verbinde eine KI mit deinen Routen

Waydo stellt einen MCP-Server (Model Context Protocol) bereit — den Standard, mit dem KI-Assistenten (z. B. Claude) sicher externe Tools nutzen können. Nach der Verbindung kann die KI deine gespeicherten Routen lesen und bearbeiten: Tage und Stopps ansehen, Orte suchen, Stopps hinzufügen, entfernen und umsortieren.

Voraussetzungen

Die MCP-Integration ist Teil des Premium-Plans. Die Tools arbeiten mit gespeicherten Routen („Meine Routen" in der App) — lade die Route in der App neu, um die Änderungen zu sehen.

Schritt 1 — API-Schlüssel generieren

1. Melde dich auf waydo.app an und öffne das Benutzermenü → Konto & Abo.
2. Wechsle zum Tab Abo → Abschnitt API-Schlüssel (MCP).
3. Klicke Schlüssel generieren und kopiere ihn sofort — der Schlüssel (Format wd_…) wird nur einmal angezeigt. Du kannst jederzeit einen neuen generieren (der alte verfällt) oder den Schlüssel löschen.

Behandle den Schlüssel wie ein Passwort

Wer deinen Schlüssel kennt, kann deine gespeicherten Routen lesen und ändern. Bei einem Leak sofort neu generieren oder in der App löschen.

Schritt 2 — MCP-Client verbinden

Endpoint: https://waydo.app/api/mcp (streamable HTTP). Autorisierung über den Header Authorization: Bearer <Schlüssel>.

Claude Code

In der .mcp.json des Projekts (oder via claude mcp add):

{
  "mcpServers": {
    "waydo": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://waydo.app/api/mcp",
        "--header", "Authorization:Bearer ${WAYDO_API_KEY}"
      ],
      "env": { "WAYDO_API_KEY": "wd_DEIN_SCHLUESSEL" }
    }
  }
}

Sicherer: den Schlüssel in einer Umgebungsvariable oder einem Secrets-Manager halten und über env injizieren, statt ihn in die Datei zu schreiben.

Claude Desktop

In claude_desktop_config.json (Einstellungen → Developer → Edit Config):

{
  "mcpServers": {
    "waydo": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://waydo.app/api/mcp",
        "--header", "Authorization:Bearer wd_DEIN_SCHLUESSEL"
      ]
    }
  }
}

Nach dem Neustart des Clients erscheinen die Waydo-Tools automatisch.

Verfügbare Tools

Tool	Beschreibung
list_trips	Deine gespeicherten Routen (ID, Name, Anzahl Tage und Stopps)
get_trip	Kompletter Routenplan: Tage, Stopps (Positionen, Adressen, Koordinaten), Abschnitte mit Reisemodus, Distanz und Dauer
search_places	Ortssuche per Freitext (Google Places) — liefert eine place_id für add_stop
add_stop	Stopp zu einem Tag hinzufügen (am Ende oder an einer Position)
remove_stop	Stopp an einer Position entfernen
move_stop	Stopps innerhalb eines Tages umsortieren
set_travel_mode	Reisemodus eines Abschnitts setzen (Auto / zu Fuß / Flug / Fähre) — neue Abschnitte sind standardmäßig „Auto"

Beispiel-Prompts für deinen Assistenten:

„Zeig meine Route Maiausflug und schlag vor, was wir unterwegs besichtigen können."

„Füge Sandomierz ans Ende des ersten Tages der Route Maiausflug hinzu."

„Verschiebe Kazimierz Dolny vor Lublin an Tag zwei."

Regeln und Limits

• Stopp-Positionen sind 1-basiert (erster Stopp = 1).
• Der erste Stopp von Tag 2+ spiegelt den letzten Stopp des Vortags — er kann nicht entfernt oder verschoben werden, und nichts kann davor eingefügt werden. Eine Änderung des letzten Stopps eines Tages aktualisiert automatisch den ersten Stopp des Folgetags (wie in der App).
• Routen und Distanzen werden beim nächsten Öffnen der Route in der App neu berechnet.
• Rate-Limit: 120 Anfragen pro Minute.
• Der Schlüssel funktioniert nur mit einem aktiven Premium-Abo — danach liefern Anfragen 403.