Connecteur MCP pour Claude & ChatGPT

Connecte Plantime à Claude ou ChatGPT pour lire les plannings, planifier des shifts et gérer les feuilles de temps en discutant.

Ce que fait le connecteur MCP de Plantime

Le serveur MCP (Model Context Protocol) de Plantime permet aux assistants IA comme Claude et ChatGPT de travailler avec ton espace Plantime en ton nom. Une fois connecté, tu peux demander à l'assistant de :

  • Lire ton espace de travail — organisations, équipes, plannings, statistiques de shifts et feuilles de temps
  • Planifier des shifts — créer des shifts individuels, répéter des modèles sur des plages de dates, copier des semaines ou remplir une période à partir du rythme récent de ton équipe
  • Affecter les shifts — assigner ou retirer des membres de l'équipe, appliquer ou rejeter les affectations suggérées, ou lancer le planificateur automatique pour pourvoir les shifts ouverts selon les disponibilités, compétences et charges de travail
  • Gérer les feuilles de temps — lister, consulter, approuver, rejeter ou recalculer les feuilles de temps

Tout se passe avec ton propre compte Plantime. Le connecteur ne voit et ne modifie que ce que tu peux toi-même voir et modifier : la plupart des outils de planification exigent un rôle de manager, d'admin ou de propriétaire dans l'équipe, et les outils de feuilles de temps permettent aussi aux employés de consulter et d'approuver leurs propres feuilles.

Configuration

Le connecteur est un serveur MCP distant avec connexion OAuth — il n'y a rien à installer.

URL du serveur : https://www.plantime.io/api/mcp/v1

Claude (claude.ai et Claude Desktop)

  1. Ouvre Paramètres → Connecteurs (avec un abonnement Claude payant)
  2. Choisis Ajouter un connecteur personnalisé
  3. Saisis l'URL du serveur ci-dessus et confirme
  4. Claude te redirige vers Plantime pour te connecter et autoriser l'accès
  5. Les outils Plantime deviennent disponibles dans tes conversations

Claude Code

claude mcp add --transport http plantime https://www.plantime.io/api/mcp/v1

Lance ensuite /mcp dans Claude Code pour terminer la connexion OAuth.

ChatGPT

  1. Ouvre Paramètres → Apps & Connecteurs
  2. Choisis Créer (mode développeur) ou ajoute l'app Plantime depuis le catalogue une fois publiée
  3. Saisis l'URL du serveur ci-dessus, sélectionne l'authentification OAuth et enregistre
  4. Connecte-toi à Plantime quand l'autorisation t'est demandée

Exemples de prompts

  • « Quelles équipes je gère dans Plantime ? »
  • « Montre-moi le planning de la semaine prochaine pour l'équipe cuisine, avec les personnes assignées. »
  • « Ajoute un shift bar mardi prochain de 16h00 à 23h00 pour deux personnes. »
  • « Copie les shifts de cette semaine sur les deux semaines suivantes. »
  • « Assigne automatiquement les shifts ouverts de la première semaine de juillet. »
  • « Montre-moi les feuilles de temps en attente et approuve celle de Maria si les heures sont correctes. »

Accès aux données et sécurité

  • L'autorisation passe par OAuth : tu te connectes directement à Plantime et l'assistant reçoit un jeton d'accès limité. Ton mot de passe Plantime n'est jamais partagé avec l'assistant.
  • Toutes les actions sont vérifiées côté serveur selon les rôles de ton compte, exactement comme dans l'application web Plantime.
  • Les actions destructives sont prudentes : la suppression de shifts est une suppression douce avec une fenêtre d'annulation d'une heure (undo_delete_shifts), et les feuilles de temps approuvées ne peuvent pas être recalculées.
  • Tu peux révoquer l'accès à tout moment en retirant le connecteur de Claude ou ChatGPT.

Dépannage

Erreur « Unauthenticated » ou 401 — ta session a expiré. Retire puis rajoute le connecteur, ou utilise l'option de reconnexion de l'assistant pour te reconnecter.

L'assistant ne voit pas une équipe ou une organisation — le connecteur n'affiche que les espaces auxquels ton compte Plantime appartient. Les outils de planification exigent en plus un rôle de manager, d'admin ou de propriétaire dans l'équipe concernée.

Les plages de dates se comportent bizarrement — pour la plupart des outils, la fin de plage est exclusive : pour inclure tout le 15 juin, indique le 16 juin à 00h00 comme fin. Les dates sont interprétées au format ISO 8601.

Annuler une suppression — demande à l'assistant de l'annuler. Les suppressions renvoient une référence d'annulation valable une heure. Au-delà, il faut recréer les shifts.

Les outils sont listés mais les appels échouent — vérifie d'abord que ton compte Plantime fonctionne dans l'application web sur plantime.io ; le connecteur a exactement les mêmes permissions.

Support

Si tu es bloqué, écris-nous à support@plantime.io ou consulte la page de support. Joins le prompt utilisé et le message d'erreur affiché par l'assistant — c'est généralement suffisant pour identifier le problème.