API, Webhooks und MCP für Claude und ChatGPT
Alles, was die App kann, geht auch per Schnittstelle. API und MCP sind in jedem Tarif enthalten. Sie finden alles unter Einstellungen › Entwickler.
API-Schlüssel anlegen
- Öffnen Sie Einstellungen › Entwickler und den Bereich API-Schlüssel.
- Klicken Sie auf Schlüssel anlegen.
- Vergeben Sie einen Namen, wählen Sie die Bereiche (zum Beispiel nur lesen, Redaktion, Posteingang, Statistik) und die Gültigkeit.
- Klicken Sie auf Anlegen und kopieren Sie den Schlüssel sofort. Er wird nur einmal angezeigt.
Ein Schlüssel handelt mit Ihren Rechten; halten Sie ihn geheim. Mit dem Bereich ki:nutzen verbraucht er KI-Credits Ihres Arbeitsbereichs. Nicht mehr gebrauchte Schlüssel widerrufen Sie; Integrationen damit funktionieren sofort nicht mehr.
Die REST-API
Die API liegt unter https://social.agiledeveloper.de/api/v1. Senden Sie den Schlüssel im Kopf Authorization: Bearer agile_social_… Die vollständige Dokumentation mit allen Endpunkten zum Ausprobieren finden Sie unter social.agiledeveloper.de/docs, die Beschreibung als OpenAPI 3.1 unter /api/openapi.json. Fehlermeldungen sind auf Deutsch und sagen, was zu tun ist.
Unter Protokoll sehen Sie alle Anfragen der letzten 30 Tage mit Methode, Pfad, Status und Dauer, ohne Inhalte.
Webhooks
Webhooks benachrichtigen Ihre Systeme, etwa Slack, Ihr CRM oder Make, wenn etwas passiert.
- Öffnen Sie den Bereich Webhooks und klicken Sie auf Webhook anlegen.
- Tragen Sie die Adresse (HTTPS) ein und wählen Sie die Ereignisse, zum Beispiel post.published, post.failed, post.approval_requested, inbox.received, inbox.crisis, channel.disconnected oder credits.warning.
- Kopieren Sie das Signatur-Geheimnis. Es wird nur jetzt angezeigt.
- Mit Testen schicken Sie ein Beispiel-Ereignis.
Jeder Aufruf ist im Kopf Agile-Signature signiert (t=Zeit, v1=HMAC-SHA256 mit Ihrem Geheimnis über „Zeit.Inhalt“). Scheitert eine Zustellung, versuchen wir es nach 1, 5, 30, 120, 360 und 1.440 Minuten erneut. Unter Zustellungen sehen Sie jeden Versuch.
Claude und ChatGPT verbinden (MCP)
Mit MCP planen Sie Beiträge, beantworten Kommentare und fragen Ihre Zahlen ab, einfach im Gespräch. Die Adresse des MCP-Servers lautet:
https://social.agiledeveloper.de/mcp
Claude:
- Öffnen Sie in Claude die Einstellungen und dort die Konnektoren.
- Wählen Sie Eigenen Konnektor hinzufügen und fügen Sie die Adresse ein.
- Klicken Sie auf Verbinden, melden Sie sich bei Agile Social an und erlauben Sie den Zugriff.
ChatGPT:
- Öffnen Sie in ChatGPT die Einstellungen und dort Apps und Konnektoren.
- Schalten Sie unter Erweitert den Entwicklermodus ein, wählen Sie Erstellen und fügen Sie die Adresse ein.
- Verbinden Sie mit OAuth, melden Sie sich an und erlauben Sie den Zugriff.
Fragen Sie danach zum Beispiel: „Plane für Bäckerei Sonnenschein drei Beiträge zum Herbst nächste Woche“, „Welche Kommentare von gestern sind noch offen?“ oder „Wie hat sich die Reichweite auf Instagram im September entwickelt?“. Der Assistent arbeitet mit Ihren Rechten. Verbundene Apps sehen und trennen Sie unter Einstellungen › Apps.