Lassen Sie Ihren KI-Assistenten Termine planen
Calio hat einen eingebauten MCP-Server und eine REST-API. Verbinden Sie Claude oder einen anderen KI-Assistenten und sagen Sie einfach: „Buche nächste Woche ein Kennenlerngespräch mit Herrn Jansen“, der Assistent prüft Ihre Verfügbarkeit und bucht den Slot.
MCP: die KI-Verbindung in 3 Schritten
Connector hinzufügen
Geben Sie Ihrem MCP-Client (etwa Claude) den Endpunkt https://calio.nl/api/mcp. Kein Schlüssel zum Eintragen.
Zugriff genehmigen
Ihr Client leitet Sie zu Calio; Sie melden sich an und sehen genau, was Sie erlauben. Ein Klick, und die Verbindung steht. Unter Integrationen können Sie sie jederzeit widerrufen.
In natürlicher Sprache planen
"Was habe ich am Donnerstag frei?" oder "Buche 30 Minuten mit piet@bedrijf.nl", der Assistent nutzt die Tools unten.
Verfügbare MCP-Tools
list_event_types | Alle buchbaren Termintypen, mit Dauer, Host und Buchungslink (mit language auch in der Sprache Ihres Gastes) |
get_available_slots | Freie Zeitfenster für einen Termintyp innerhalb eines Zeitraums |
create_booking | Einen Termin auf ein freies Zeitfenster buchen (der Gast erhält automatisch eine E-Mail) |
list_bookings | Buchungen innerhalb eines Zeitraums, optional nach Status gefiltert |
cancel_booking | Eine bestätigte Buchung stornieren (der Kalender wird aktualisiert) |
Lieber selbst bauen? Die REST-API
Dieselben Möglichkeiten wie die MCP-Tools, als schlichte JSON-API. Hier sind API-Schlüssel der richtige Weg: Ein Skript hat keinen Browser, in dem es eine Einwilligung erteilen könnte. Authentifizieren Sie sich mit Authorization: Bearer calio_sk_...
| GET | /api/v1/event-types?locale= | Termintypen Ihrer Organisation |
| GET | /api/v1/event-types/{slug}/slots?from=&to= | Freie Zeitfenster (UTC) |
| GET | /api/v1/bookings?from=&to=&status= | Buchungen abrufen |
| POST | /api/v1/bookings | Termin buchen |
| POST | /api/v1/bookings/{id}/cancel | Buchung stornieren |
curl -X POST https://calio.nl/api/v1/bookings \
-H "Authorization: Bearer calio_sk_..." \
-H "Content-Type: application/json" \
-d '{
"eventType": "intro-call",
"startUtc": "2026-08-03T09:00:00Z",
"name": "Piet Jansen",
"email": "piet@bedrijf.nl"
}'Häufig gestellte Fragen
Wie verbinde ich Claude mit Calio?
Fügen Sie in Claude (oder einem anderen MCP-Client) einen Connector mit der URL https://calio.nl/api/mcp hinzu. Der Client leitet Sie zu Calio, Sie melden sich an, sehen auf einem Bildschirm, was der Assistent darf, und klicken auf Genehmigen, kein Schlüssel zum Kopieren. Ab dann kann der Assistent Ihre Verfügbarkeit einsehen und Termine buchen oder stornieren. Sie widerrufen die Verbindung unter Integrationen; der Zugriff endet sofort.
Was kann der KI-Assistent genau, und was nicht?
Der Assistent kann Termintypen und freie Slots abfragen, buchen, Buchungen einsehen und stornieren. Er kommt nicht an den Inhalt Ihres Kalenders oder Ihre Kontoeinstellungen: Die API gibt nur Buchungsdaten frei, innerhalb Ihrer eigenen Organisation.
Wie funktioniert die OAuth-Verbindung?
Calio folgt der MCP-Autorisierungsspezifikation: OAuth 2.1 mit verpflichtendem PKCE (S256) und dynamischer Client-Registrierung (RFC 7591), sodass sich ein Connector selbst registrieren kann, ohne dass jemand dazwischensteht. Die Metadaten liegen unter /.well-known/oauth-protected-resource und /.well-known/oauth-authorization-server. Ein Access-Token ist eine Stunde gültig und wird mit einem Refresh-Token erneuert, das bei jeder Nutzung rotiert. Die Einwilligung gehört der Person, die sie erteilt hat, innerhalb ihrer Organisation: Verlässt diese Person das Team, endet die Verbindung mit ihr. Wir geben keine Client-Secrets aus, ein MCP-Client läuft auf dem Rechner des Nutzers und kann dort nichts geheim halten; diese Aufgabe übernimmt PKCE.
Funktioniert die API in mehreren Sprachen?
Ja. Fragen Sie Ihre Termintypen mit ?locale=de, en oder nl ab (in MCP: der Parameter language) und Sie erhalten Titel, Beschreibung und eigene Fragen in dieser Sprache zurück, sofern der Host eine Übersetzung hinterlegt hat, sonst dessen eigenen Text. Beim Buchen bestimmt dasselbe Feld, in welcher Sprache Ihr Gast die Bestätigungs- und Erinnerungsmails erhält. Bei einer Multiple-Choice-Frage senden Sie immer den Wert aus options zurück statt des übersetzten Labels: So bleiben Antworten von Gästen in verschiedenen Sprachen vergleichbar.
Ist das sicher?
Jeder Schlüssel und jede Verbindung ist an Ihre Organisation gebunden und kann jederzeit widerrufen werden; von Schlüsseln und Tokens speichern wir nur einen Hash. Alle Daten bleiben auf europäischer Infrastruktur. Widerrufen Sie einen Schlüssel oder eine Verbindung, endet der Zugriff sofort, einschließlich der darunterliegenden Refresh-Tokens. Wer was verbunden und getrennt hat, steht im Audit-Log.
Was kostet die API?
Während der Beta stehen die API und der MCP-Server allen Konten ohne Aufpreis zur Verfügung. Es gilt Fair Use; Limits pro Plan folgen mit den bezahlten Plänen.
Ihr Kalender, mit einem KI-Assistenten darauf
Kostenloser Plan, API-Schlüssel mit einem Klick, Daten in Europa.
Kostenlos starten