Serveur MCP de CalendarPA
CalendarPA dispose d’un serveur MCP, pour qu’un assistant IA comme Claude ou ChatGPT puisse travailler avec votre compte CalendarPA. Une fois connecté, l’assistant peut voir vos types de réservation et vos réservations, trouver des créneaux libres, et réserver, reprogrammer ou annuler des rendez-vous pour vous. Il se connecte avec votre compte CalendarPA : aucune clé d’API à copier. Toutes les offres peuvent se connecter, y compris l’offre gratuite.
URL du serveur
https://calendarpa.com/api/mcpCollez cette adresse telle quelle, y compris /api/mcp.
Se connecter depuis Claude
- Dans Claude, ouvrez Customize, puis Connectors.
- Cliquez sur + Add, puis sur Add custom connector.
- Nommez-le CalendarPA, collez l’URL du serveur et cliquez sur Continue.
- Cliquez sur Continue pour passer les réglages de connexion que Claude détecte.
- Sous OAuth client, choisissez Register automatically, puis cliquez sur Add.
- Connectez-vous à CalendarPA quand on vous le demande et approuvez les autorisations.
- Dans une conversation, cliquez sur +, puis sur Connectors, et activez CalendarPA.
Avec un forfait Claude Team ou Enterprise, un propriétaire ajoute le connecteur dans Organization settings, puis Connectors, et chaque membre le connecte ensuite depuis Customize, puis Connectors.
Ces étapes suivent l’article d’aide de Claude sur les connecteurs personnalisés. Claude peut renommer ses menus.
Se connecter depuis ChatGPT
- Dans ChatGPT, ouvrez Plugins.
- Sélectionnez le bouton plus, puis Add custom MCP server.
- Nommez-le CalendarPA et, sous Connection, collez l’URL du serveur.
- Choisissez OAuth comme authentification, lisez l’avertissement et sélectionnez I understand and want to continue.
- Sélectionnez Create as a plugin, puis connectez-vous à CalendarPA et approuvez les autorisations.
- Dans une nouvelle conversation, tapez @ et choisissez CalendarPA.
La possibilité d’ajouter un serveur MCP personnalisé à votre compte ChatGPT dépend des règles de compte et d’espace de travail de ChatGPT.
Ces étapes suivent le guide d’OpenAI pour connecter un serveur MCP. ChatGPT peut renommer ses menus.
Les trois autorisations
Quand vous vous connectez, CalendarPA vous demande d’approuver trois autorisations. Chacune ne couvre que les outils indiqués à côté.
- Consulter vos types de réservation : lister vos types de réservation et trouver leurs créneaux libres.
- Consulter vos réservations et leurs détails : lister vos réservations et lire une réservation.
- Créer et annuler des réservations en votre nom : réserver, reprogrammer et annuler.
Aucune autorisation donnée à un assistant ne lui permet de rembourser un paiement.
Ce que l’assistant peut faire
| Outil | Ce qu’il fait | Type |
|---|---|---|
whoami | Le compte auquel il est connecté : nom, e-mail, nom d’utilisateur, offre et fuseau horaire. | Lecture |
list_booking_types | Vos types de réservation actifs, avec titre, durée, options de lieu et prix. | Lecture |
find_available_times | Les créneaux libres d’un type de réservation, tels que votre page de réservation les propose. Jusqu’à 60 jours par appel. | Lecture |
list_bookings | Les réservations que vous organisez, plus les réservations round robin qui vous sont attribuées. Filtrable par statut, date de création ou e-mail de l’invité. | Lecture |
get_booking | L’heure, le statut, l’invité, le lieu et le lien de réunion d’une réservation. | Lecture |
create_booking | Réserve un créneau proposé par find_available_times. L’invité reçoit la confirmation habituelle et le rendez-vous s’ajoute à votre calendrier. | Écriture |
reschedule_booking | Déplace à une autre heure une réservation que vous organisez. | Écriture |
cancel_booking | Annule une réservation que vous organisez et prévient l’invité. Pour une réservation payée par carte, le paiement est conservé ; les crédits utilisés pour payer sont rendus. | Écriture, destructive |
Ce qu’il ne peut pas faire
- Réserver un type de réservation payant.
- Déplacer ou annuler une place dans une session de groupe.
- Lister les réservations que vous co-organisez.
- Rembourser un paiement.
Offres
Le serveur MCP fonctionne avec toutes les offres, y compris l’offre gratuite. Si une action utilise une fonction que votre offre n’inclut pas, comme les réservations récurrentes, l’assistant apprend quelle offre la propose.
Limites
- Jusqu’à 300 appels d’outils par minute et par connexion, dans la limite de 1 000 par minute et par compte.
- La recherche de créneaux libres lit vos calendriers en direct, elle est donc limitée à 30 appels par minute et par compte.
- Au-delà d’une limite, l’assistant est informé du nombre de secondes à attendre avant de réessayer.
- Un résultat de plus de 100 Ko est refusé plutôt que tronqué, et l’assistant affine alors sa demande.
- L’accès dure 1 heure à la fois et peut être renouvelé pendant 90 jours sans utilisation. Si la connexion ne fonctionne plus, reconnectez-la.
Déconnecter
Dans CalendarPA, allez dans Réglages, puis Intégrations, trouvez l’app dans Applications connectées et cliquez sur Déconnecter. L’accès s’arrête aussitôt : la requête suivante de l’assistant est refusée.
Confidentialité
L’assistant n’accède qu’à votre propre compte, et seulement à ce que permettent les autorisations que vous avez approuvées. Ce que Claude ou ChatGPT font de ce qu’ils lisent relève de leurs propres règles de confidentialité ; les nôtres figurent dans la Politique de confidentialité.
Pour les développeurs
Le serveur parle MCP en Streamable HTTP et se connecte avec OAuth, avec PKCE et l’enregistrement dynamique des clients. Ses métadonnées de ressource protégée sont à /.well-known/oauth-protected-resource/api/mcp. L’API REST est documentée dans la documentation de l’API.