Agile Developer Hilfe-Center › Agile Vibes

Team, API, Webhooks und MCP für Claude und ChatGPT

Mitglieder einladen, API-Schlüssel anlegen, Webhooks empfangen und Agile Vibes als Konnektor in Claude oder ChatGPT nutzen.

Team

Ein Konto gehört zu einem Team. Projekte, Guthaben und Tarif gelten für das ganze Team.

Mitglieder einladen: Einstellungen › Team › Einladen. E-Mail-Adresse eingeben, Rolle Mitglied oder Admin wählen, Einladen. Die Einladung kommt per E-Mail und gilt 7 Tage. Offene Einladungen lassen sich zurückziehen.

  • Free: 1
  • Start: 1
  • Pro: 3
  • Business: 10

Rollen: Admins verwalten zusätzlich Tarif, KI-Guthaben und automatisches Aufladen. Mitglieder bauen in den Projekten des Teams.
Sichtbarkeit je Projekt: Im Editor unter Einstellungen › Zugriff wählen Sie Ganzes Team oder Nur ich.

API

Die REST-API v1 kann alles, was die App kann: Projekte anlegen und importieren, mit der KI bauen, Dateien lesen und schreiben, Versionen, Teile, Geheimnisse, Datenbanken, Veröffentlichen, Domains und Abrechnung.

Schlüssel anlegen:

  1. Einstellungen › Entwickler › API-Schlüssel › Neuer Schlüssel.
  2. Namen vergeben (zum Beispiel „GitHub Actions“) und Rechte wählen.
  3. Anlegen. Kopieren Sie den Schlüssel sofort; wir zeigen ihn nur dieses eine Mal. Er beginnt mit agile_vb_.
  4. Senden Sie ihn als Header: Authorization: Bearer agile_vb_…

Rechte: projekte:lesen, projekte:schreiben, ki:ausfuehren, dateien:lesen, dateien:schreiben, veroeffentlichen, team:lesen, team:verwalten, webhooks:verwalten, abrechnung:lesen. Geben Sie jedem Schlüssel nur die Rechte, die er braucht.
Widerrufen: Mülleimer bzw. Widerrufen beim Schlüssel. Anfragen mit diesem Schlüssel schlagen sofort fehl.

Beispiel: neues Projekt aus einer Beschreibung, die KI startet sofort:

curl -X POST https://vibes.agiledeveloper.de/api/v1/projekte \
  -H "Authorization: Bearer agile_vb_…" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Baue eine Landingpage für mein Café"}'

Webhooks

Agile Vibes sendet Ereignisse per POST an Ihre Adresse.

  1. Einstellungen › Entwickler › Webhooks › Neuer Webhook.
  2. Adresse (https) und Ereignisse wählen, Anlegen.
  3. Kopieren Sie das Signatur-Geheimnis; es wird nur einmal angezeigt.
  4. Mit Test senden prüfen Sie die Zustellung.

Ereignisse: lauf.fertig, lauf.fehler, veroeffentlichung.live, veroeffentlichung.fehler, projekt.erstellt, projekt.importiert, guthaben.niedrig, guthaben.leer, team.beigetreten.
Signatur: Header Agile-Signature: t=<unix>,v1=<hex>. v1 ist HMAC-SHA256 mit dem Signatur-Geheimnis über <t>.<body>. Prüfen Sie die Signatur und den Zeitstempel, bevor Sie dem Inhalt vertrauen.
Wiederholung: Antwortet Ihr Server nicht mit 2xx, versuchen wir es nach 1, 5, 30, 120, 360 und 1440 Minuten erneut.

MCP: Agile Vibes in Claude und ChatGPT

Mit dem MCP-Konnektor bauen Sie Apps direkt aus Claude oder ChatGPT heraus: „Bau mir eine Terminbuchung für meinen Friseursalon“, „Mach die Startseite dunkler“ oder „Veröffentliche die App unter mein-salon“.
Konnektor-Adresse: https://vibes.agiledeveloper.de/mcp
Die Anmeldung läuft über OAuth. Sie melden sich bei Agile Vibes an und entscheiden, was der Assistent darf (lesen oder zusätzlich schreiben). Kein Passwort und kein Schlüssel wird kopiert.

Claude (claude.ai und Desktop):

  1. Einstellungen › Konnektoren öffnen.
  2. Benutzerdefinierten Konnektor hinzufügen, Name „Agile Vibes“, URL wie oben.
  3. Verbinden, bei Agile Vibes anmelden, Rechte prüfen, Erlauben.
  4. Im Chat den Konnektor über das Werkzeug-Menü einschalten.

In Team- und Enterprise-Organisationen fügt meist die Verwaltung den Konnektor einmal für alle hinzu.

ChatGPT:

  1. Einstellungen › Apps und Konnektoren › Erweiterte Einstellungen, Entwicklermodus einschalten.
  2. Konnektor erstellen, Name „Agile Vibes“, URL wie oben, Authentifizierung OAuth.
  3. Bei Agile Vibes anmelden und Erlauben.

Ob der Entwicklermodus in Ihrem ChatGPT-Tarif verfügbar ist, legt OpenAI fest; Menünamen können sich ändern.

Claude Code:

claude mcp add --transport http agile-vibes https://vibes.agiledeveloper.de/mcp

Dann in Claude Code /mcp eingeben, agile-vibes wählen und authentifizieren.

Werkzeuge: projekt_erstellen, nachricht_senden (wartet bis zu 50 Sekunden auf das Ergebnis), lauf_anzeigen, projekte_auflisten, projekt_anzeigen, vorschau_link, dateien_auflisten, datei_lesen, versionen_auflisten, version_wiederherstellen, veroeffentlichen, nutzung_anzeigen, dazu search und fetch.
Die vollständige Anleitung steht unter https://vibes.agiledeveloper.de/docs/mcp.

Verbundene Apps verwalten: Einstellungen › Verbundene Apps zeigt alle Assistenten mit Zugriff. Trennen entzieht den Zugriff sofort.

Tipps

  • Jede Nachricht über MCP oder API startet einen KI-Lauf und verbraucht Guthaben Ihres Teams, genau wie in der App. Den Stand zeigt nutzung_anzeigen bzw. GET /api/v1/nutzung.
  • Für Automatisierungen eignen sich Webhooks auf lauf.fertig und veroeffentlichung.live, etwa für eine Nachricht in Ihren Team-Chat.

Häufige Fragen

Brauche ich für MCP einen API-Schlüssel?
Nein, die Anmeldung läuft über OAuth. Für Skripte ohne Browser geht in Claude Code auch ein API-Schlüssel als Header.

Gilt ein Schlüssel für alle Teams?
Nein, ein Schlüssel gehört zu genau einem Team.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 14. Oktober 2026

Weitere Artikel zu Agile Vibes

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