Dokumentation
Tripvanion MCP — dein Agent als Reise-Co-Pilot
Tripvanion MCP ist ein First-Party-Anschluss für Coding-Agents. Dein Agent plant mit dir Reisen, schreibt das Roadbook, pflegt Packlisten und kennt Fahrzeug und Inventar. Es ist keine Stellplatz-Datenbank und kein Campingplatz-Verzeichnis. Du brauchst dafür keinen Zugriff auf das Git-Repository.
So verbindest du deinen Agenten
1. In der App: Connector-Adresse (OAuth)
Öffne Tripvanion, dann Einstellungen → Mein Profil. Die Karte KI-Agent verbinden zeigt die Connector-Adresse. Kopiere sie und trage sie in Claude, ChatGPT, Codex oder Cursor ein. Der Login läuft über OAuth: CIMD für Claude, Dynamic Client Registration (DCR, RFC 7591) für die anderen. Du meldest dich mit deinem Tripvanion-Konto an — du kopierst kein Geheimnis.
- Claude: Einstellungen → Connectors → „Connector hinzufügen“ → Adresse einfügen.
- ChatGPT: Einstellungen → Connectors → „Connector erstellen“ → Adresse als MCP-Server eintragen.
- Codex / Cursor: als MCP-Server mit dieser Adresse hinzufügen — der OAuth-Login öffnet sich.
2. Persönliches Token (tvp_…)
Agents, die einen Bearer-Token statt OAuth wollen, nutzen die Form tvp_gegen POST /mcp. Das Token gilt nicht fürs ganze Konto. Es ist kein Vollzugriff. Neue Tokens decken Reisen, Packlisten, Inventar und die Einkaufsliste ab — nicht Account-Löschung, nicht Checklisten. Lege ein solches Token nur lokal im Agenten ab. Nicht ins Git, nicht in Screenshots, nicht ins Ticket.
Der interne Name dafür ist Agent-Zugang. Die aktuelle Settings-Karte kopiert die Connector-Adresse für OAuth; ein sichtbarer Knopf „Token erzeugen“ steht dort heute nicht. Wer den PAT-Pfad braucht, bleibt beim Bearer-Header und erzeugt das Token nur, wenn die App es wirklich anzeigt.
Endpoint
Live-Adresse (HTTP JSON-RPC, POST):
https://tripvanion-api-513634856828.us-west1.run.app/mcpHealth-Check: GET /mcp/health. Wer ein persönliches Token nutzt, schickt Authorization: Bearer tvp_….
Nach einem späteren Umzug der API auf Hostinger ändert sich diese URL. Eine neue Live-Adresse nennen wir hier erst, wenn sie wirklich erreichbar ist — bis dahin gilt nur die Cloud-Run-Adresse oben.
Was der Agent darf
| Tools | Wirkung |
|---|---|
| list_trips / get_trip / create_trip / update_trip | Reisen listen, lesen, anlegen und aktualisieren |
| get_itinerary / replace_itinerary / update_itinerary_day | Roadbook und Itinerary lesen und schreiben |
| get_stations / add_station / update_station / remove_station | Stationen anlegen, ändern, entfernen |
| get_packing_list / add_packing_item / update_packing_item / remove_packing_item | Packlisten lesen und pflegen |
| get_vehicle | Fahrzeugprofil lesen (Maße, Fristen, Kontakte — ohne Versicherungsnummern) |
| list_inventory / add_inventory_items / update_inventory_item / remove_inventory_item | Inventar lesen und pflegen |
| list_shopping_items / add_shopping_items / check_shopping_item / remove_shopping_item | Einkaufsliste unabhängig von einer Reise |
Was der Agent nicht darf
- Konto löschen
- eine Reise löschen
- Fahrzeuge löschen
- Ankunfts- und Abfahrts-Checklisten anfassen
Stationen und Packpunkte darf der Agent entfernen. Eine ganze Reise, das Konto oder hinterlegte Fahrzeuge nicht.
Verzeichnisse
Einreichungen in Connector-Verzeichnissen (Claude, PulseMCP und andere) bleiben beim Owner. Diese Seite reicht nichts ein. Die interne Checkliste liegt im Repo — nicht hier.
App und Packlisten
Universal Links sind nicht live. Der Agent verbindet sich über MCP, nicht über einen App-Link aus dem Browser. Noch keinen Account? Starte mit einer Packliste oder dem Generator und nimm die Liste per Code in die App.
Zurück zur Packlisten-Übersicht oder zur Embed-Dokumentation.