Agile Developer Hilfe-Center › Agile Coworking

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).

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 7. November 2026 · Quelle: agile-coworking docs/hilfe/17-api-webhooks-mcp.md

Weitere Artikel zu Agile Coworking

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.