Alle Doku-Themen

API und MCP: das Cockpit automatisieren

Stand:

Alles, was du im Cockpit klicken kannst, kannst du auch automatisieren: über eine REST-Schnittstelle oder direkt aus Claude heraus, per MCP. Das ist praktisch, wenn du viele Kunden verwaltest, eigene Auswertungen bauen willst oder deine Abläufe ohnehin schon mit KI-Werkzeugen laufen.

API-Schlüssel erstellen

In den Einstellungen unter „API-Schlüssel & Claude (MCP)“ erstellst du einen Schlüssel. Er wird dir genau einmal angezeigt, kopiere ihn also direkt an einen sicheren Ort, etwa in euren Passwort-Manager. Danach zeigt die Liste nur noch den Anfang des Schlüssels, wann er zuletzt benutzt wurde, und einen Knopf zum Widerrufen.

Ein Schlüssel hat dieselben Rechte wie du im Cockpit. Behandle ihn wie ein Passwort:

  • Nicht in Code-Repositories einchecken, nicht per Mail verschicken.
  • Pro Anwendung ein eigener Schlüssel, dann kannst du einzeln widerrufen.
  • Nicht mehr gebrauchte Schlüssel widerrufen. Der Widerruf wirkt sofort.

Cockpit aus Claude steuern (MCP)

Mit einem API-Schlüssel kannst du das Cockpit als Werkzeug in Claude einbinden. Danach erledigst du Agentur-Aufgaben im Chat: „Zeig mir die Besucherzahlen der Bäckerei diesen Monat“, „Schick Frau Meier eine Bewertungsanfrage“, „Welche Termine stehen nächste Woche an?“. Claude ruft dafür dieselben Funktionen auf, die auch das Cockpit benutzt — mit denselben Zugriffsrechten.

Die Verbindungsdaten für die Einrichtung zeigt dir das Cockpit direkt neben dem API-Schlüssel.

Was Claude damit kann

Die Werkzeuge decken die Cockpit-Arbeit ab:

  • Überblick und Zahlen: Kunden und Websites auflisten, Besucherzahlen (7/30/90 Tage), Uptime und Performance, Änderungshistorie einer Website.
  • Module bedienen: Chatbot einrichten und Gespräche nachlesen, Newsletter samt Abonnenten und Kampagnen verwalten, Entwürfe schreiben und versenden, Bewertungsanfragen senden und eingegangene Bewertungen ansehen, Terminbuchung konfigurieren und Termine auflisten, Monats-Report einstellen.
  • Kunden anbinden: Kopplungs-Codes für WhatsApp, Telegram und E-Mail erzeugen, Kunden ins Kundenportal einladen.
  • Domain und Hosting: Eigene Domains verbinden und prüfen, Umgebungsvariablen verwalten, den Wechsel auf eigenes Hosting samt Push-to-Deploy-Prüfung durchführen.
  • Website-Wissen: Design-Profil einer Website abrufen, Neu-Indexierung anstoßen, eine frühere Version wiederherstellen.

Claude kennt außerdem diese Dokumentation und beantwortet Fragen zur Bedienung direkt daraus. Bei allem, was Geld kostet oder nicht rückgängig zu machen ist — Module buchen, Hosting wechseln, Newsletter versenden, Versionen zurücksetzen — fragt Claude vorher nach.

REST-Schnittstelle

Für eigene Skripte und Integrationen sprichst du die Schnittstelle direkt an. Der Schlüssel wird als Bearer-Token im Authorization-Header mitgeschickt. Die verfügbaren Endpunkte decken dieselben Bereiche ab wie das Cockpit: Kunden, Websites, Module, Analytics, Hosting.

Widget-API: Module direkt in die Kunden-Website integrieren

Chatbot, Terminbuchung und Newsletter-Anmeldung müssen nicht als fertiges Widget eingebettet werden — jedes Modul hat eine öffentliche JSON-API, mit der du die Funktion nativ in die Endkunden-Seite baust (eigenes Markup, eigenes Verhalten). Authentifiziert wird über den public_token des Moduls (der Wert aus dem Einbau-Code, z. B. data-pagora-booking="…"); CORS ist offen, die Aufrufe funktionieren direkt aus dem Browser. Basis-URL: https://api.pagoras.de.

  • Chatbot: GET /api/chat/{token}/config (Name, Begrüßung, Farben) · POST /api/chat/{token}/message mit { "text": "…", "conversationId": "…" } → { "conversationId", "reply" }. Die conversationId aus der ersten Antwort bei Folgenachrichten mitschicken. Hinweis: Bei eigener Integration bist du für die KI-Kennzeichnung im UI verantwortlich (im fertigen Widget ist sie eingebaut).
  • Terminbuchung: GET /api/booking/{token}/config (Leistungen, Modus, Texte) · GET /api/booking/{token}/slots?from=JJJJ-MM-TT&days=7&service={id} → freie Slots je Tag + nextFree · POST /api/booking/{token}/book mit { "service_id", "starts_at", "name", "email", "phone?", "note?", "party?" } · Umbuchen über POST /api/booking/{token}/reschedule.
  • Newsletter: GET /api/newsletter/{token}/config · POST /api/newsletter/{token}/subscribe mit { "email", "name?" } — das Double-Opt-In (Bestätigungs-Mail) übernimmt die Plattform. Den Double-Opt-In-Hinweis im eigenen Formular nicht vergessen.

Es gelten dieselben Limits wie in den Widgets (z. B. Chatbot-Nachrichten pro Minute/Tag). Die fertigen Widgets bleiben der einfachste Weg — die API ist für Fälle, in denen sich das Modul nahtlos ins Design und Verhalten der Website einfügen soll.

ZurückEinstellungen