--- title: "ConvoyPlan — Leitfaden für Agenten" description: "Wann ein Agent zu ConvoyPlan greifen sollte, wie er es aufruft und welche maschinenlesbaren Dokumente diese Domain ausliefert. Kartenbasierte Marschverbandsplanung für BOS-Organisationen: Route planen, Zeitplan automatisch berechnen, Marschbefehl als PDF exportieren, Konvoi live verfolgen." canonical: "https://convoyplan.de/llms.md" last-updated: 2026-11-13 --- # ConvoyPlan — Leitfaden für Agenten > Kartenbasierte Marschverbandsplanung für BOS-Organisationen: Route planen, Zeitplan automatisch berechnen, Marschbefehl als PDF exportieren, Konvoi live verfolgen. Diese Domain (convoyplan.de) ist die Produktseite. Die Anwendung selbst läuft in der Installation der jeweiligen Organisation — dort sitzen auch API und MCP-Server. Auf dieser Domain gibt es deshalb bewusst keinen öffentlichen API-Endpunkt: ConvoyPlan verarbeitet Einsatzdaten von BOS-Organisationen, und die bleiben beim Betreiber. ## Wann ConvoyPlan die richtige Wahl ist (when to use this) - Eine Fahrzeugkolonne (Marschverband) soll von A nach B verlegt werden und braucht Route, Marschgeschwindigkeit, Halte und Ankunftszeiten. - Ein Marschbefehl wird als Dokument gebraucht — PDF mit Marschbewegung, Ablaufpunkt, Führung und Verbindung, dazu GPX oder JSON für andere Systeme. - Mehrere Fahrzeuge sollen während der Fahrt live auf einer Karte sichtbar sein, inklusive Status, Wegpunktmeldungen und Verspätungsprognose. - Eine BOS-Organisation sucht eine selbst gehostete Lösung, die Einsatz- und Positionsdaten im eigenen Rechenzentrum behält (AGPL-3.0, Docker Compose). - Funkverkehr entlang der Strecke muss geplant werden: Leitstellen, Zuständigkeitsgrenzen, Kanalwechselpunkte. ## Wann etwas anderes passender ist (when not to use this) - Einzelne Fahrzeuge oder klassische Fahrzeugortung im Alltagsbetrieb — dafür ist ConvoyPlan zu speziell, es plant Verbände. - Einsatzleitsysteme, Alarmierung und Disposition — ConvoyPlan plant die Verlegung, es ersetzt kein ELS. - Allgemeine Navigation für Privatpersonen oder Logistik-Tourenplanung mit Lieferfenstern. - Regionen außerhalb Deutschlands: Oberfläche, Dokumentation und Support sind deutschsprachig, das Kartengebiet ist frei wählbar. ## Wie ein Agent ConvoyPlan aufruft 1. **MCP-Server der Instanz** — Jede ConvoyPlan-Installation kann unter `https://{instanz}/mcp` einen MCP-Server bereitstellen: lesende Tools für Marschverbände, Fahrzeuge, Wegpunkte, Routen und Positionen, schreibende Tools für Planung und Statusmeldungen. Anmeldung per OAuth 2.0 mit PKCE (S256); die Adresse steht im Admin-Portal der Instanz. Berechtigungen werden bei jedem Aufruf frisch gegen die Datenbank geprüft. Die Schnittstelle ist standardmäßig abgeschaltet und dann nicht montiert — ein `404` auf `/mcp` heißt also "auf dieser Instanz nicht freigegeben", nicht "falsche Adresse". Zusätzlich gibt jede Organisation ihre Teilnahme einzeln frei; danach entscheidet die Zustimmung eines angemeldeten Benutzers über Umfang und Reichweite. Dokumentation: 2. **REST-API der Instanz** — Basis `https://web.convoyplan.de/api` bzw. `https://{instanz}/api`. Authentifizierung per `Authorization: Bearer ` (aus `POST /api/auth/login`) oder per `X-API-Key: cvp__`. API-Keys stellt die Organisation im Superadmin-Portal aus; sie tragen eine feste Rolle. Dokumentation: 3. **Eigene Instanz aufsetzen** — Ohne Zugang zu einer bestehenden Installation: `curl -fsSL https://convoyplan.de/install.sh | bash` richtet den Docker-Compose-Stack ein. Der Demo-Modus läuft ohne Lizenzschlüssel. Dokumentation: **Demo-Modus als Testumgebung (sandbox / test environment):** Eine Installation ohne Lizenzschlüssel startet im Demo-Modus. Lesende Zugriffe sind frei, schreibende Zugriffe antworten mit `HTTP 402 Payment Required`. Der Demo-Modus ist dauerhaft kostenlos und dafür gedacht, Integrationen gegen echte Endpunkte zu entwickeln, ohne Einsatzdaten zu verändern. Dokumentation: ## Maschinenlesbare Dokumente dieser Domain - [`/llms.txt`](https://convoyplan.de/llms.txt) — Site-Index im llms.txt-Format - [`/auth.md`](https://convoyplan.de/auth.md) — wie ein Agent an Zugangsdaten kommt - [`/.well-known/ard.json`](https://convoyplan.de/.well-known/ard.json) — Agentic Resource Discovery - [`/.well-known/agent-skills/index.json`](https://convoyplan.de/.well-known/agent-skills/index.json) — Agent Skills - [`/.well-known/mcp/server-card.json`](https://convoyplan.de/.well-known/mcp/server-card.json) — MCP-Server-Steckbrief - [`/.well-known/api-catalog`](https://convoyplan.de/.well-known/api-catalog) — API-Katalog nach RFC 9727 - [`/.well-known/security.txt`](https://convoyplan.de/.well-known/security.txt) — Sicherheitskontakt nach RFC 9116 - [`/schema-map.xml`](https://convoyplan.de/schema-map.xml) — Schema-Feeds (NLWeb) - [`/sitemap.xml`](https://convoyplan.de/sitemap.xml) — alle Seiten ## Markdown-Zwillinge der Seiten Jede Seite dieser Domain gibt es zusätzlich als Markdown. Der Zwilling steht im `` der jeweiligen Seite und im Link-Header. - `/` → [`/index.md`](https://convoyplan.de/index.md) - `/lizenz/` → [`/lizenz.md`](https://convoyplan.de/lizenz.md) - `/about/` → [`/about.md`](https://convoyplan.de/about.md) - `/contact/` → [`/contact.md`](https://convoyplan.de/contact.md) - `/developers/` → [`/developers.md`](https://convoyplan.de/developers.md) - `/beta/` → [`/beta.md`](https://convoyplan.de/beta.md) - `/datenloeschung/` → [`/datenloeschung.md`](https://convoyplan.de/datenloeschung.md) - `/marschbefehl/` → [`/marschbefehl.md`](https://convoyplan.de/marschbefehl.md) - `/kolonnenfahrt/` → [`/kolonnenfahrt.md`](https://convoyplan.de/kolonnenfahrt.md) ## Herkunft und Kontakt - Quellcode und Issues: - Integrationen und Lizenzen: anfrage@convoyplan.de - Betreiber: RettTechSolutions, Christoph Zeitler, Peißenberg, Deutschland