Connexion MCP
Utilisez https://mcp.vesta.services/mcp pour connecter un client MCP à Vesta, y compris aux données de Vesta Time. L’authentification utilise votre compte Vesta et le consentement OAuth dans votre navigateur. Tous les employeurs utilisent le même serveur ; sélectionnez l’employeur lors de l’autorisation.
ChatGPT et Claude
Section intitulée « ChatGPT et Claude »Dans ChatGPT, ouvrez Plugins > + > Add custom MCP server, saisissez l’URL Vesta et choisissez OAuth. Créez le plugin, installez-le depuis vos plugins personnels, puis appelez-le avec @ dans une conversation. Les restrictions de votre espace s’appliquent. Consultez le guide de connexion OpenAI.
Dans Claude, ouvrez Customize > Connectors > + Add > Add custom connector. Saisissez l’URL Vesta, choisissez la connexion et l’enregistrement OAuth automatique, puis connectez-vous. Le propriétaire d’un espace géré peut devoir ajouter le connecteur au préalable. Consultez le guide de connexion Claude.
Il s’agit de connexions personnalisées. Une inscription publique nécessite une évaluation et une publication distinctes par l’éditeur ; ce guide ne confirme pas que Vesta figure déjà dans le catalogue.
Connexion en lecture seule
Section intitulée « Connexion en lecture seule »- Activez Vesta AI pour l’employeur et votre compte, et vérifiez que votre rôle permet de lire les données nécessaires.
- Ajoutez un serveur MCP HTTP distant dans votre client avec l’URL ci-dessus. Le client doit prendre en charge la découverte OAuth MCP et l’authentification dans le navigateur.
- Connectez-vous sur la page d’autorisation de Vesta. Ne collez jamais votre mot de passe Vesta dans le client ou une conversation.
- Sélectionnez uniquement l’employeur à partager. Autoriser à nouveau le même client OAuth remplace sa sélection d’employeurs. Des connexions simultanées isolées nécessitent des enregistrements de clients OAuth distincts, si votre client le permet ; utilisez des intégrations API client séparées pour un accès automatique par employeur.
- Chaque employeur sélectionné commence avec un accès en lecture seule. Utilisez Adapter les autorisations pour définir séparément les droits de cet employeur. Sélectionnez uniquement les autorisations de lecture : Personnel pour retrouver les travailleurs, Planning pour les shifts et disponibilités, Heures prestées pour le temps travaillé, et Coût salarial pour les rapports salariaux. Ne sélectionnez aucune autorisation d’écriture.
- Confirmez le consentement et actualisez la liste des outils du client.
Votre rôle, les modules actifs de l’employeur et votre consentement limitent ensemble l’accès. Le consentement ne peut pas accorder un droit que votre compte Vesta ne possède pas. Lire les coûts employeur agrégés nécessite le droit de lecture des coûts employeur (laborcost.read) et l’autorisation Coût salarial. Les taux salariaux individuels restent inaccessibles via MCP. Une connexion existante ne reçoit pas automatiquement les nouveaux scopes : autorisez-la à nouveau pour ajouter Coût salarial.
Les autorisations sont contrôlées séparément pour chaque employeur. Un droit d’écriture chez un employeur ne permet jamais de modifier les données d’un autre. Le client peut afficher un outil disponible pour un autre employeur sélectionné ; chaque appel exige les droits nécessaires pour l’employeur indiqué.
Une connexion en lecture seule ne peut ni créer, ni modifier, ni supprimer des données. Avec des droits d’écriture, les actions réversibles, comme modifier des shifts en brouillon, peuvent être exécutées immédiatement. Les actions ayant des conséquences pour autrui, comme publier le planning, nécessitent une confirmation distincte dans Vesta.
Lire les données de reporting
Section intitulée « Lire les données de reporting »| Question | Outil | Autorisation de lecture |
|---|---|---|
| Shifts par travailleur et par jour | get_planning | Planning |
| Disponibilité par travailleur et par jour | get_availability | Planning |
| Temps travaillé par travailleur et par jour | list_time_entries | Heures prestées |
| Coût prévu et réel par statut, équipe ou tâche, par jour ou mois | get_labor_cost_report | Coût salarial |
Transmettez employerUniqueCode, from et to à chaque outil. Le rapport de coûts accepte aussi
groupBy (Statute, Team, Task) et granularity (Day, Month), pour 93 jours inclus au maximum.
Demandez explicitement un mois civil complet pour obtenir des totaux mensuels.
Les disponibilités acceptent offset et limit (1 à 100, 100 par défaut) ; suivez l’offset suivant
renvoyé. La période est limitée à 42 jours inclus. Une disponibilité absente est inconnue, pas un
refus de travailler. Les pointages utilisent offset et limit (50 par défaut, maximum 100) ; lisez
toutes les pages avant d’additionner les pointages terminés. Le planning comprend les shifts Concept et Published sur 42 jours inclus au maximum. La vue planning est limitée ; réduisez
à un travailleur ou établissement si la réponse est partielle, ou utilisez l’API client paginée pour
exporter tous les shifts publiés.
Le guide de reporting de l’API client
explique la réponse commune : les brouillons de planning sont inclus, les chiffres réels en cours
sont mesurés à asOf, les absences sont exclues et les coûts inconnus ou estimés doivent rester
visibles. Il s’agit du coût opérationnel, pas de la paie définitive.
MCP et l’API client
Section intitulée « MCP et l’API client »MCP utilise une connexion OAuth personnelle. Pour les rapports automatiques depuis votre serveur, utilisez l’API client : ses identifiants appartiennent à un seul employeur et ses scopes sont en lecture seule. Les jetons de l’API client et de MCP sont distincts et ne peuvent pas être échangés ou réutilisés entre les deux services.
Gérer l’accès
Section intitulée « Gérer l’accès »Ouvrez Paramètres > Compte > Connexions dans Vesta pour consulter les autorisations et les employeurs d’une connexion, ou révoquer son accès. La révocation est vérifiée lors des requêtes suivantes. Si la connexion est refusée, vérifiez votre rôle, l’employeur sélectionné, ses modules et les paramètres Vesta AI avant de vous reconnecter.
Vérifier la connexion
Section intitulée « Vérifier la connexion »L’hôte MCP expose la découverte OAuth à https://mcp.vesta.services/.well-known/oauth-authorization-server et les métadonnées de la ressource protégée à https://mcp.vesta.services/.well-known/oauth-protected-resource/mcp.
Le 13 octobre 2026, les deux endpoints de découverte ont répondu avec succès. L’endpoint MCP annonçait la prise en charge de POST ; ouvrir directement /mcp dans un navigateur peut renvoyer 405 Method Not Allowed. Une requête POST d’initialisation sans authentification a renvoyé 401 avec la découverte OAuth dans WWW-Authenticate. Cela vérifie l’accessibilité publique et l’exigence d’authentification, pas une session employeur authentifiée. Pour vérifier votre connexion, autorisez-la, demandez au client de lister les outils, puis lisez une courte période pour votre employeur.
Si des outils manquent, vérifiez les autorisations de lecture de la connexion et vos droits actuels dans Vesta. Reconnectez-vous si l’autorisation a été révoquée ou a expiré. Ne transmettez jamais de jetons d’accès ni de secrets client au support ; partagez l’erreur et l’identifiant de requête.