# ConvoyPlan — Entwickler und Integrationen

> REST-API und MCP-Server jeder ConvoyPlan-Installation. Kein öffentlicher Endpunkt
> auf convoyplan.de: die Schnittstellen gehören zur selbst gehosteten Instanz der
> Organisation, Zugangsdaten stellt deren Administration aus.

Einstiegspunkte: REST unter `https://{instanz}/api` (öffentlich erreichbare Instanz:
`https://web.convoyplan.de/api`), MCP unter `https://{instanz}/mcp`.
Authentifizierung per `Authorization: Bearer <JWT>` aus `POST /api/auth/login`, per
`X-API-Key: cvp_<prefix>_<secret>` oder per OAuth 2.0 mit PKCE über MCP.
Ohne gültiges Token: `401` mit `WWW-Authenticate: Bearer`.

## Einstieg

- [Entwicklerportal](https://convoyplan.de/developers/): Einstiegspunkte, Verfahren, Berechtigungen
- [Entwicklerportal als Markdown](https://convoyplan.de/developers.md)
- [auth.md](https://convoyplan.de/auth.md): Zugangsdaten beschaffen, verwenden und widerrufen

## Schnittstellen

- [API-Dokumentation](https://github.com/RettTechSolutions/ConvoyPlan/wiki/API-Dokumentation): alle REST- und WebSocket-Endpunkte
- [MCP-Server](https://github.com/RettTechSolutions/ConvoyPlan/wiki/MCP-Server): Tools, Ressourcen, Live-Abonnements, OAuth-Ablauf.
  Standardmäßig abgeschaltet und dann nicht montiert — ein `404` auf `/mcp` heißt
  "nicht freigegeben". Zusätzlich gibt jede Organisation ihre Bereiche einzeln frei;
  `tools/list` ist deshalb instanz- und verbindungsabhängig und nicht cachebar.
- [ChatGPT verbinden](https://github.com/RettTechSolutions/ConvoyPlan/wiki/ChatGPT-verbinden): Developer Mode, Schreibrechte beim Zustimmen
- Instanz-Selbstauskunft: `GET /api/status/capabilities` (ohne Anmeldung) sagt, ob MCP
  montiert ist und wo die maschinenlesbaren Beschreibungen liegen;
  [Agenten-Auskunft](https://github.com/RettTechSolutions/ConvoyPlan/wiki/Agenten-Auskunft)
- [MCP-Steckbrief](https://convoyplan.de/.well-known/mcp/server-card.json)
- [API-Katalog nach RFC 9727](https://convoyplan.de/.well-known/api-catalog)
- OpenAPI: `/openapi.json` der Instanz, standardmäßig deaktiviert; Freischaltung über `DOCS_API_KEY` oder `ENABLE_DOCS=true`

## Testen

- [Demo-Modus — sandbox / test environment](https://github.com/RettTechSolutions/ConvoyPlan/wiki/Lizenz-und-Demo-Modus): lesend frei, schreibend `HTTP 402` — Testumgebung ohne Produktivdaten
- [Installation und Setup](https://github.com/RettTechSolutions/ConvoyPlan/wiki/Installation-und-Setup): `curl -fsSL https://convoyplan.de/install.sh | bash`
- [Entwicklung](https://github.com/RettTechSolutions/ConvoyPlan/wiki/Entwicklung): Aufbau des Stacks, lokale Umgebung

## Berechtigungen

- [Sicherheit und Datenschutz](https://github.com/RettTechSolutions/ConvoyPlan/wiki/Sicherheit-und-Datenschutz): Rollenmodell, Mandantentrennung, Datenhaltung
- Rollen: Admin, Planer, Fahrer, Beobachter — je Organisation, geprüft bei jedem Aufruf
- [Wiki-Übersicht](https://github.com/RettTechSolutions/ConvoyPlan/wiki): alle Seiten zu Betrieb und Sicherheit

## Fähigkeiten als Agent Skill

- [Agent-Skills-Index](https://convoyplan.de/.well-known/agent-skills/index.json)
- [SKILL.md: ConvoyPlan-API nutzen](https://convoyplan.de/.well-known/agent-skills/convoyplan-api/SKILL.md)
- [SKILL.md: ConvoyPlan betreiben](https://convoyplan.de/.well-known/agent-skills/convoyplan-selfhosting/SKILL.md)

## Kontakt

Integrationen und Sonderfälle: anfrage@convoyplan.de