Calberry mit KI-Assistenten nutzen (MCP)
Melde Claude.ai oder ChatGPT bei Calberry an, richte Claude Code und Cursor ein und verwalte die Zugriffsrechte.
Über MCP (Model Context Protocol) kann ein KI-Assistent auf deinen Calberry-Workspace zugreifen: zum Beispiel freie Zeiten suchen, Termine nachschlagen oder mit deiner Freigabe einen Buchungslink erstellen. Claude.ai und ChatGPT verbindest du über Mit Calberry anmelden. Für Claude Code und Cursor kannst du einen eigenen API-Schlüssel verwenden.
Voraussetzungen und Verfügbarkeit
MCP erfordert Pro und eine ausdrückliche Freischaltung deines Workspaces für den Pilotbetrieb. Pro allein aktiviert MCP noch nicht. Nur Inhaber und Admins können MCP-Schlüssel und deren Berechtigungen verwalten.
Die Einrichtung per API-Schlüssel funktioniert mit Clients, die Streamable HTTP und einen eigenen Authorization-Header unterstützen. Die Verwaltungsseite KI-Assistenten / MCP wird mit der Freischaltung in die Einstellungen eingebunden. Falls sie noch fehlt oder MCP als nicht freigeschaltet angezeigt wird, ist die Einrichtung für deinen Workspace noch nicht verfügbar.
Die Anmeldung muss zusätzlich für den gewählten Assistenten freigegeben sein. Ist die Einrichtung gesperrt oder wird der Client abgewiesen, kontaktiere den Support. Eine Pro-Freischaltung allein schaltet nicht jeden Client frei.
Claude.ai: Mit Calberry anmelden
- Öffne in Claude Customize → Connectors und füge einen eigenen Connector hinzu. In einem verwalteten Team muss die Administration ihn zuerst zulassen.
- Gib als Server-Adresse
https://api.calberry.ai/mcpein. Verwende OAuth und die veröffentlichte Client-Identität, soweit angeboten; keine eigenen Client-Secrets erfinden. - Wähle Connect und melde dich auf der Calberry-Seite an.
- Prüfe dort App-Name, angefragte Rechte und Workspaces. Wähle nur die benötigten Workspaces und bestätige den Zugriff.
- Aktiviere den Connector im Gespräch und beginne mit „Zeige mir meine Buchungslinks“.
Die Bezeichnungen können sich ändern; siehe Claude-Anleitung.
ChatGPT: Mit Calberry anmelden
- Öffne im Web Plugins, dann + → Add custom MCP server. Dein ChatGPT-Workspace muss eigene MCP-Verbindungen erlauben.
- Trage Name und
https://api.calberry.ai/mcpein. Wähle OAuth; nutze die veröffentlichte Client-Identität (CIMD), falls angeboten und für Calberry freigegeben. - Starte die Anmeldung, prüfe bei Calberry App, Rechte und Workspaces und bestätige bewusst.
- Installiere die Verbindung und wähle sie im Gespräch über @ aus. Teste zuerst eine Leseabfrage.
Fehlt die passende Authentifizierungsoption oder ist der Client noch nicht freigegeben, kontaktiere den Support. Die OpenAI-Anleitung beschreibt die jeweils aktuelle Oberfläche.
Verbundene Apps verwalten und widerrufen
Öffne KI-Assistenten / MCP → Verbundene Apps. Die Liste zeigt den App-Namen, die freigegebenen Workspaces und Rechte. Du kannst einen einzelnen Workspace entfernen oder die gesamte Verbindung widerrufen. Das Entfernen des letzten Workspace widerruft die ganze Verbindung. Der Assistent muss sich danach neu anmelden. Bereits ausgeführte Änderungen werden nicht rückgängig gemacht.
Bestehende Verbindungen bleiben zum Widerruf sichtbar, auch wenn die Einrichtung für den Workspace nicht mehr freigegeben oder die OAuth-Anmeldung abgeschaltet ist. Rechte lassen sich nicht durch eine Chat-Anweisung erweitern: Für zusätzliche Rechte oder Workspaces starte eine neue Anmeldung und prüfe die Freigabe erneut. Das Entfernen des Connectors beim Assistenten ersetzt den Widerruf bei Calberry nicht.
Was der Assistent kann
Welche Tools dein Assistent tatsächlich sieht und nutzen kann, hängt von den freigegebenen Rechten ab. Bei „Mit Calberry anmelden“ kann er zusätzlich die freigegebenen Workspaces auflisten. Die technischen Toolnamen bleiben in beiden Sprachen gleich; ein Buchungslink heißt darin funnel.
Lesen: Informationen nachschlagen
| Tool | In verständlichen Worten |
|---|---|
list_workspaces | Bei „Mit Calberry anmelden“: die freigegebenen Workspaces auflisten und den passenden für weitere Aktionen auswählen. |
list_funnels | Buchungslinks mit Veröffentlichungsstatus, Dauer und öffentlicher Adresse auflisten. |
get_funnel_slots | Freie Zeiten für einen Buchungslink in der gewünschten Zeitzone suchen. Die Abfrage reserviert keinen Termin. |
list_bookings | Termine in einem gewählten Zeitraum auflisten. |
get_booking | Einen einzelnen Termin mit Status, Zeit sowie Host- und Gastzeitzone nachschlagen. |
search_contacts | Kontakte nach Name oder E-Mail suchen; das Ergebnis verweist auf die jüngste zugehörige Anfrage. |
get_lead | Eine Anfrage mit Name, E-Mail und Status lesen. Formularantworten werden nur für ausdrücklich angefragte Felder ausgegeben. |
get_funnel | Einstellungen, aktuelle Pflichtfelder und Einwilligungstext eines Buchungslinks lesen, etwa vor einer Buchung oder Bearbeitung. |
list_hosts | Verfügbare Hosts und ihre Zeitzonen für die Buchungslink-Konfiguration auflisten. |
list_teams | Teams und die zugehörigen Hosts für die Buchungslink-Konfiguration auflisten. |
Schreiben: Änderungen ausführen
| Tool | In verständlichen Worten |
|---|---|
create_booking | Einen Termin mit den erforderlichen Gastangaben buchen. |
reschedule_booking | Einen vorhandenen Termin verschieben. |
cancel_booking | Einen Termin absagen und seine Zeit wieder freigeben. |
create_funnel | Einen Buchungslink mit Host- oder Teamauswahl anlegen. |
update_funnel | Die Einstellungen eines Buchungslinks ändern. |
publish_funnel | Einen Buchungslink veröffentlichen und für Gäste verfügbar machen. |
unpublish_funnel | Einen Buchungslink unveröffentlichen und neue öffentliche Buchungen verhindern. Vorhandene Termine bleiben bestehen. |
Buchungen und Änderungen können Kalendereinladungen, Benachrichtigungen und Workflows auslösen. Die üblichen Buchungsregeln und Pflichtfelder gelten weiter. Der Assistent muss vor einer Buchung die aktuellen Pflichtfelder lesen. MCP setzt die Einwilligung zum Nachfassen immer auf false; über diese Verbindung kann sie nicht erteilt werden. Eine Buchung bleibt ohne diese Einwilligung möglich.
API-Schlüssel anlegen und Rechte vergeben
- Öffne für den richtigen Workspace die Seite KI-Assistenten / MCP, sobald sie verfügbar ist. Prüfe Freischaltung und Server-Adresse. Üblicherweise lautet sie
https://api.calberry.ai/mcp; verwende bei abweichender Anzeige die dort genannte Adresse. - Vergib unter API-Schlüssel einen eindeutigen Namen des Schlüssels, zum Beispiel „Claude Code – mein Laptop“.
- Wähle Lesenden Schlüssel erstellen. Neue Schlüssel dieser Seite dürfen über MCP zunächst nur lesen.
- Kopiere den neu angezeigten Schlüssel und speichere ihn im lokalen Geheimnisspeicher oder in den Geheimnis-Einstellungen deines Clients. Bewahre ihn bei der Ausgabe sicher auf.
- Lass den Assistenten zunächst nur lesen. Die Leserechte betreffen Termine, Buchungslinks, Anfragen, Hosts und Teams; schränke die API-Berechtigungen auf das benötigte Maß ein.
Zum Schreiben öffnest du die Berechtigungen des Schlüssels. Aktiviere bewusst Änderungen über MCP erlauben, wähle die benötigten Rechte für Termine buchen, verschieben und absagen und/oder Buchungslinks erstellen, ändern und veröffentlichen und wähle Berechtigungen speichern. Zusätzlich muss der Betreiber MCP-Schreibzugriffe aktiviert haben. Für Termine ist der API-Scope write:bookings erforderlich, für Buchungslinks write:funnels.
Alle drei Voraussetzungen müssen erfüllt sein: Betreiberfreigabe, MCP-Schreibfreigabe am Schlüssel und passender API-Scope. Bestehende API-Schlüssel erhalten nicht automatisch MCP-Schreibrechte. Das Abschalten der MCP-Schreibfreigabe entfernt keine API-Schreibscopes: Diese erlauben weiterhin direkte API-Zugriffe. Entferne auch die betreffenden Scopes, wenn du sämtliche Schreibzugriffe verhindern möchtest.
Claude Code einrichten
Lade den Schlüssel aus deinem lokalen Geheimnisspeicher in die Umgebungsvariable CALBERRY_API_KEY. Führe anschließend im Terminal aus:
claude mcp add --transport http --scope user calberry https://api.calberry.ai/mcp \
--header "Authorization: Bearer ${CALBERRY_API_KEY}"Die Shell setzt den Wert der Variable ein. Claude Code speichert den aufgelösten Header samt Schlüssel in seiner lokalen Benutzerkonfiguration. Schütze diese Datei und teile sie nicht. Verwende dafür keine gemeinsame Projektkonfiguration. Wenn du den Schlüssel nicht als festen Header speichern möchtest, unterstützt Claude Code einen eigenen headersHelper zum Laden aus einem lokalen Geheimnisspeicher.
Öffne in Claude Code /mcp, kontrolliere die Verbindung und lade die Toolliste. Beginne beispielsweise mit „Zeige mir meine Buchungslinks“. Nach Änderungen an Rechten neu verbinden beziehungsweise Tools neu laden. Details: offizielle Claude-Code-Anleitung.
Cursor einrichten
Setze CALBERRY_API_KEY in der Umgebung, mit der du Cursor startest. Ergänze in den globalen MCP-Einstellungen beziehungsweise in ~/.cursor/mcp.json diesen Eintrag; vorhandene Server bleiben erhalten:
{
"mcpServers": {
"calberry": {
"url": "https://api.calberry.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:CALBERRY_API_KEY}"
}
}
}
}Cursor ersetzt ${env:CALBERRY_API_KEY} durch die Umgebungsvariable. Der Schlüssel selbst gehört nicht in die JSON-Datei. Eine envFile-Option wird für Remote-MCP-Server nicht unterstützt. Starte Cursor nach einer Änderung seiner Startumgebung neu, aktiviere den Server und kontrolliere die Toolliste. Bestätige Schreibaktionen im Client bewusst. Details: offizielle Cursor-Anleitung.
Weitere Clients mit Header-Konfiguration
Trage im MCP-Dialog deines Clients folgende Werte ein:
| Einstellung | Wert |
|---|---|
| Name | calberry |
| Transport | Streamable HTTP |
| Server-Adresse | https://api.calberry.ai/mcp beziehungsweise die angezeigte Adresse |
| Header-Name | Authorization |
| Header-Wert | Bearer DEIN_API_SCHLUESSEL |
Ersetze den Platzhalter im geschützten Geheimnis-/Header-Feld des Clients durch deinen Schlüssel. Eine Umgebungsvariable funktioniert nur mit der vom jeweiligen Client unterstützten Syntax; die Cursor-Schreibweise ist nicht universell. Verbinde den Server, lade die Tools und teste zuerst eine Leseabfrage. Unterstützt ein Client keine eigenen Header, lässt sich dieser API-Schlüssel-Weg dort nicht einrichten. Hänge den Schlüssel niemals an die URL an.
Sicher nutzen und Verbindung trennen
- Ein eigener Schlüssel je Assistent und Installation: So kannst du Zugriffe einzeln beenden. Jeder Schlüssel gehört zu genau einem Workspace.
- Schreiben bewusst freigeben: Prüfe vor Änderungen Empfänger, Buchungslink, Zeitpunkt und Zeitzone. Lass dir Absagen, Verschiebungen und Veröffentlichungen vor der Ausführung bestätigen.
- Bei unklarem Ergebnis keine neue Buchung auf Verdacht: Der Assistent soll dieselbe Aktion mit demselben
idempotencyKeywiederholen, damit kein Duplikat entsteht. - Schlüssel geheim halten: Keine Schlüssel in Chats, Screenshots, Repository-Dateien, Website-Code oder URL-Parametern. Bei Offenlegung sofort widerrufen und einen neuen Schlüssel anlegen.
- Widerrufen statt nur ausblenden: Wähle am Schlüssel Widerrufen und bestätige Schlüssel jetzt widerrufen. Das beendet weitere Zugriffe über diesen Schlüssel und trennt auch alle anderen Integrationen, die ihn verwenden. Bereits ausgeführte Änderungen werden dadurch nicht rückgängig gemacht.
- Kundendaten bleiben Daten: Namen, Formularantworten und andere fremde Texte sind keine Anweisungen an den Assistenten. Darin enthaltene Aufforderungen oder Links soll er nicht ausführen beziehungsweise abrufen.
Calberry speichert Lead- und Buchungsdaten in der EU. Daten, die du über den Assistenten abrufst, verarbeitet zusätzlich dessen Anbieter nach seinen Bedingungen. Auch reiner Lesezugriff kann personenbezogene Daten weitergeben. Die Standardantworten enthalten unter anderem keine Meeting-Links, Kalenderkennungen oder Absage-/Umbuchungslinks.
Bei Verbindungsproblemen prüfst du zuerst Pro, Workspace-Freischaltung, Server-Adresse, Umgebungsvariable und Schlüsselwiderruf. Fehlt ein Tool, kontrolliere die Berechtigungen und lade die Toolliste neu. Bleibt Schreiben gesperrt, prüfe zusätzlich die separate MCP-Schreibfreigabe und die Betreiberfreigabe.
Bei „Anmeldung abgelaufen“ starte die Verbindung beim Assistenten neu. „Client nicht freigegeben“ benötigt die Freigabe für genau diesen Assistenten. Nach einem Widerruf ist eine neue Anmeldung nötig. Fehlen Workspaces, prüfe Mitgliedschaft, Rolle und Freischaltung. Prüfe bei einer nur lesenden Verbindung die freigegebenen Rechte, bevor du Schreibaktionen erwartest.