Comment connecter le serveur MCP OneCal Calendar à ChatGPT

OneCal expose un serveur Model Context Protocol (MCP) qui permet aux clients d'IA comme ChatGPT de lire et de gérer vos calendriers connectés en votre nom. Une fois connecté, vous pouvez demander à ChatGPT de lister vos calendriers, de vérifier votre disponibilité, et de créer, mettre à jour ou supprimer des événements de calendrier.

Sur ChatGPT, les connecteurs MCP personnalisés sont appelés apps. La connexion de OneCal implique de passer d'un côté à l'autre entre ChatGPT et OneCal : vous commencez par créer l'app dans ChatGPT pour obtenir son callback URL, vous utilisez cette URL pour créer le client MCP dans OneCal, puis vous revenez sur ChatGPT avec les identifiants que OneCal vous fournit.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un compte OneCal avec un essai gratuit actif ou un plan payant.
• Au moins un calendrier connecté à votre compte OneCal.
• Vous êtes déjà connecté à votre compte OneCal.
• Un abonnement payant à ChatGPT. La création d'apps personnalisées n'est disponible que sur les plans payants de ChatGPT, et non sur le plan gratuit.

Étape 1 : Commencer à créer l'app dans ChatGPT et copier le callback URL

1. Ouvrez ChatGPT et accédez à Settings > Apps.

2. Dans la section Advanced settings, cliquez sur Create app.

3. Dans la boîte de dialogue New App, saisissez un Name pour l'app, par exemple : « OneCal MCP ».

4. Sous Connection, conservez Server URL sélectionné et saisissez l'URL du serveur MCP OneCal :

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

5. Réglez Authentication sur OAuth, puis cliquez sur Advanced OAuth settings.

6. Dans Advanced OAuth settings, réglez Registration method sur User-Defined OAuth Client, puis copiez le Callback URL que ChatGPT affiche. Le callback URL est unique à cette app, copiez-le donc directement plutôt que de le saisir de mémoire. Vous en aurez besoin à l'étape suivante pour créer le client MCP dans OneCal.

Gardez cet onglet ChatGPT ouvert, car vous y reviendrez à l'étape 3.

Étape 2 : Créer un client MCP dans OneCal

1. Dans un nouvel onglet, accédez à https://app.onecal.io/ et ouvrez Settings > MCP Config.

2. Cliquez sur le bouton New Client.

3. Donnez au client un nom reconnaissable, par exemple : « ChatGPT ». Cela vous aidera à identifier plus tard à quelle app appartient le client.

4. Laissez Supports client-secret OAuth authentication activé.

5. Choisissez les scopes que vous souhaitez accorder. Les scopes contrôlent ce que ChatGPT peut faire via le serveur MCP. Pour un accès complet au calendrier, activez Read your calendar events et Create and modify calendar events. L'accès au profil, à l'email et hors ligne est requis et toujours inclus. N'accordez que les scopes dont vous avez réellement besoin.

6. Dans le champ Default Redirect URI, collez le Callback URL que vous avez copié depuis les Advanced OAuth settings de ChatGPT.

7. Cliquez sur Create Client. OneCal générera vos identifiants client, notamment le Client ID, le Client Secret et d'autres détails de connexion.

8. Copiez et conservez ces valeurs en lieu sûr. Traitez le Client Secret comme un mot de passe. Il n'est affiché qu'une seule fois et ne doit jamais être partagé publiquement.

Étape 3 : Finaliser l'app dans ChatGPT

1. Revenez à l'app ChatGPT que vous avez commencée à l'étape 1, dans la section Advanced OAuth settings.

2. Collez le Client ID et le Client Secret de OneCal dans leurs champs correspondants.

3. Acceptez l'avertissement de ChatGPT relatif au serveur MCP personnalisé en cochant I understand and want to continue, puis cliquez sur Create.

4. ChatGPT affiche une invite Add "{app name}" to ChatGPT avec un bouton Sign in with "{app name}", où {app name} est le nom que vous avez donné à l'app précédemment. Cliquez dessus pour démarrer le flux OAuth.

5. Vous serez redirigé vers OneCal. Connectez-vous si vous y êtes invité, examinez l'accès demandé par ChatGPT et cliquez sur Authorize pour accorder l'accès.

6. Après l'autorisation, ChatGPT vous redirige et marque l'app comme connectée.

Étape 4 : Utiliser OneCal dans ChatGPT

Une fois connecté, vous pouvez appeler l'app OneCal dans une conversation en saisissant @ suivi du nom de l'app (par exemple, @OneCal MCP) puis de votre demande. Par exemple, vous pouvez demander à ChatGPT de :

• Lister vos calendriers connectés.
• Vérifier votre disponibilité pour un jour ou une plage horaire donnés.
• Créer, mettre à jour ou supprimer des événements de calendrier.

ChatGPT ne pourra effectuer que les actions autorisées par les scopes que vous avez sélectionnés lors de la création du client.

Dépannage

• L'autorisation échoue ou redirige vers une page d'erreur : Assurez-vous que le redirect URI que vous avez ajouté dans OneCal correspond exactement au Callback URL des Advanced OAuth Settings de ChatGPT. Même une différence de barre oblique finale fera échouer le flux.
• L'app peut lire mais ne peut pas créer ou modifier d'événements : Vérifiez que vous avez accordé le scope d'écriture du calendrier lors de la création du client. Vous pouvez modifier les scopes du client dans Settings > MCP Config.
• Erreurs de client invalide : Vérifiez attentivement que le Client ID et le Client Secret ont été copiés correctement, sans espaces superflus.