So verbindest du den OneCal Kalender MCP-Server mit ChatGPT

OneCal stellt einen Model Context Protocol (MCP)-Server bereit, mit dem KI-Clients wie ChatGPT deine verbundenen Kalender in deinem Namen lesen und verwalten können. Sobald die Verbindung hergestellt ist, kannst du ChatGPT bitten, deine Kalender aufzulisten, deine Verfügbarkeit zu prüfen sowie Kalenderereignisse zu erstellen, zu aktualisieren oder zu löschen.

In ChatGPT werden benutzerdefinierte MCP-Connectors als apps bezeichnet. Beim Verbinden von OneCal wechselst du zwischen ChatGPT und OneCal hin und her: Du beginnst mit der Erstellung der App in ChatGPT, um deren Callback-URL zu erhalten, verwendest diese URL, um den MCP-Client in OneCal zu erstellen, und kehrst dann mit den von OneCal bereitgestellten Anmeldedaten zu ChatGPT zurück.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

• Ein OneCal-Konto mit einer aktiven kostenlosen Testphase oder einem kostenpflichtigen Tarif.
• Mindestens einen mit deinem OneCal-Konto verbundenen Kalender.
• Du bist bereits in deinem OneCal-Konto angemeldet.
• Ein kostenpflichtiges ChatGPT-Abonnement. Das Erstellen benutzerdefinierter Apps ist nur in den kostenpflichtigen ChatGPT-Tarifen verfügbar, nicht im kostenlosen Tarif.

Schritt 1: Beginne mit der Erstellung der App in ChatGPT und kopiere die Callback-URL

1. Öffne ChatGPT und gehe zu Settings > Apps.

2. Klicke im Abschnitt Advanced settings auf Create app.

3. Gib im Dialog New App einen Name für die App ein, zum Beispiel: „OneCal MCP".

4. Lasse unter Connection die Option Server URL ausgewählt und gib die OneCal MCP-Server-URL ein:

https://mcp-server.onecal.io/mcp

5. Setze Authentication auf OAuth und klicke dann auf Advanced OAuth settings.

6. Setze in Advanced OAuth settings die Registration method auf User-Defined OAuth Client und kopiere dann die Callback URL, die ChatGPT anzeigt. Die Callback-URL ist für diese App eindeutig, kopiere sie also direkt, anstatt sie aus dem Gedächtnis einzugeben. Du benötigst sie im nächsten Schritt, um den MCP-Client in OneCal zu erstellen.

Lasse diesen ChatGPT-Tab geöffnet, da du in Schritt 3 darauf zurückkommst.

Schritt 2: Erstelle einen MCP-Client in OneCal

1. Navigiere in einem neuen Tab zu https://app.onecal.io/ und öffne Settings > MCP Config.

2. Klicke auf die Schaltfläche New Client.

3. Gib dem Client einen wiedererkennbaren Namen, zum Beispiel: „ChatGPT". Das hilft dir später dabei, zu erkennen, zu welcher App der Client gehört.

4. Lasse Supports client-secret OAuth authentication aktiviert.

5. Wähle die Berechtigungen (Scopes) aus, die du gewähren möchtest. Scopes steuern, was ChatGPT über den MCP-Server tun kann. Für vollen Kalenderzugriff aktiviere Read your calendar events und Create and modify calendar events. Profil-, E-Mail- und Offline-Zugriff sind erforderlich und immer enthalten. Gewähre nur die Scopes, die du tatsächlich benötigst.

6. Füge im Feld Default Redirect URI die Callback URL ein, die du aus den Advanced OAuth settings von ChatGPT kopiert hast.

7. Klicke auf Create Client. OneCal generiert deine Client-Anmeldedaten, einschließlich der Client ID, des Client Secret und weiterer Verbindungsdetails.

8. Kopiere diese Werte und speichere sie sicher. Behandle das Client Secret wie ein Passwort. Es wird nur einmal angezeigt und sollte niemals öffentlich geteilt werden.

Schritt 3: Schließe die App in ChatGPT ab

1. Kehre zu der ChatGPT-App zurück, die du in Schritt 1 begonnen hast, in den Abschnitt Advanced OAuth settings.

2. Füge die Client ID und das Client Secret aus OneCal in die entsprechenden Felder ein.

3. Bestätige die Warnung von ChatGPT zum benutzerdefinierten MCP-Server, indem du I understand and want to continue ankreuzt, und klicke dann auf Create.

4. ChatGPT zeigt eine Aufforderung Add "{app name}" to ChatGPT mit einer Schaltfläche Sign in with "{app name}" an, wobei {app name} der Name ist, den du der App zuvor gegeben hast. Klicke darauf, um den OAuth-Flow zu starten.

5. Du wirst zu OneCal weitergeleitet. Melde dich an, falls du dazu aufgefordert wirst, überprüfe den von ChatGPT angeforderten Zugriff und klicke auf Authorize, um den Zugriff zu gewähren.

6. Nach der Autorisierung leitet ChatGPT zurück und markiert die App als verbunden.

Schritt 4: Verwende OneCal in ChatGPT

Sobald die Verbindung hergestellt ist, kannst du die OneCal-App in einer Unterhaltung aufrufen, indem du @ gefolgt vom Namen der App eingibst (zum Beispiel @OneCal MCP) und dann deine Anfrage stellst. Du kannst ChatGPT zum Beispiel bitten:

• Deine verbundenen Kalender aufzulisten.
• Deine Verfügbarkeit für einen bestimmten Tag oder Zeitraum zu prüfen.
• Kalenderereignisse zu erstellen, zu aktualisieren oder zu löschen.

ChatGPT kann nur Aktionen ausführen, die durch die Scopes erlaubt sind, die du beim Erstellen des Clients ausgewählt hast.

Fehlerbehebung

• Die Autorisierung schlägt fehl oder leitet auf eine Fehlerseite weiter: Stelle sicher, dass die in OneCal hinzugefügte Redirect-URI exakt mit der Callback URL aus den Advanced OAuth Settings von ChatGPT übereinstimmt. Selbst ein Unterschied bei einem abschließenden Schrägstrich führt zum Fehlschlagen des Flows.
• Die App kann lesen, aber keine Ereignisse erstellen oder bearbeiten: Vergewissere dich, dass du beim Erstellen des Clients den Schreib-Scope für den Kalender gewährt hast. Du kannst die Scopes des Clients unter Settings > MCP Config bearbeiten.
• Fehler „Invalid client": Überprüfe, ob die Client ID und das Client Secret korrekt kopiert wurden, ohne zusätzliche Leerzeichen.