API, Webhooks und MCP
Agile Coworking lässt sich in Ihre eigenen Systeme und in KI-Assistenten einbinden. Alles finden Sie im Profilmenü unter API & Webhooks (Einstellungen › Entwickler).
Agile Coworking lässt sich in Ihre eigenen Systeme und in KI-Assistenten einbinden. Alles finden Sie im Profilmenü unter API & Webhooks (Einstellungen › Entwickler).
REST-API
- Adresse:
https://coworking.agiledeveloper.de/api/v1/… - Dokumentation mit allen Endpunkten und Beispielen:
https://coworking.agiledeveloper.de/docs(OpenAPI) - Anmeldung mit einem API-Schlüssel als Bearer-Token
Einen Schlüssel legen Sie unter API & Webhooks an. Sie geben ihm einen Namen, wählen die Rechte und auf Wunsch ein Ablaufdatum. Der Schlüssel wird nur einmal angezeigt; speichern Sie ihn sicher. Er gehört zu Ihrem Arbeitsbereich und zu Ihrer Person: Ihre Rolle im Team gilt zusätzlich.
Rechte (Auszug): Belegung lesen, Buchungen schreiben, Kunden lesen bzw. verwalten, Verträge lesen bzw. verwalten, Rechnungen lesen bzw. verwalten (auch SEPA, Kontoauszug-Import, Export), Post verwalten, Identitätsprüfungen (nur Admins), Katalog und Einstellungen (nur Admins), Team, Webhooks.
Typische Anwendungen: freie Plätze auf Ihrer Website anzeigen, Buchungen aus einem anderen System anlegen (bei belegtem Platz antwortet die API mit 409 ausgebucht), Rechnungen und DATEV-Stapel abholen, Post erfassen.
Schreibende Aufrufe können Sie mit dem Kopf Idempotency-Key sicher wiederholen. Die API begrenzt die Zahl der Anfragen und meldet das in den RateLimit-Köpfen.
Webhooks
Webhooks melden Ereignisse sofort an Ihre Adresse (nur HTTPS, keine internen Adressen). Verfügbar sind unter anderem: Buchung angelegt oder storniert, Vertrag angefragt, unterschrieben oder gekündigt, Rechnung angelegt, Zahlung eingegangen, Post eingegangen, Unterlagen zur Identitätsprüfung eingereicht und neues Kundenkonto. Jede Zustellung ist mit HMAC-SHA256 signiert, damit Sie die Herkunft prüfen können. Zustellungen sehen Sie in der App. Webhooks verwalten nur Team-Admins.
MCP für KI-Assistenten
Über das Model Context Protocol verbinden Sie Agile Coworking mit KI-Assistenten, die MCP unterstützen. Die Adresse ist https://coworking.agiledeveloper.de/mcp; die Anmeldung läuft über OAuth mit Ihrer Zustimmung (Lesen oder Lesen und Schreiben).
Werkzeuge: Überblick, Verfügbarkeit, Angebote, Buchungen auflisten, Buchung anlegen und stornieren, Kunden suchen und anlegen, Verträge und Rechnungen auflisten, Post erfassen.
Schreibende Werkzeuge fragen vorher nach: Eine Buchung zeigt zuerst den Preis und wird erst angelegt, wenn Sie zugestimmt haben. Bewusst nicht über MCP erreichbar sind Ausweisdaten der Identitätsprüfung, SEPA-Läufe, Rechtstexte und Einstellungen; das bleibt in der App.
Verbindungen widerrufen
API-Schlüssel und verbundene Apps können Sie unter API & Webhooks jederzeit widerrufen. Jeder Zugriff wird protokolliert (API-Log).