Le serveur MCP (Model Context Protocol) de Puncto donne à un assistant IA un accès à la paie, avec les droits de la personne qui le connecte :
- un administrateur consulte collaborateurs, absences, mois de paie et tâches, et, s’il l’autorise, pose et valide des absences, saisit les variables du mois, modifie un contrat ou invite un collaborateur ;
- un collaborateur consulte ses congés, ses absences et ses bulletins, et peut demander ou annuler une absence.
https://api.puncto.fr/mcpConnecter un client
OAuth 2.1, découverte, clients compatibles et limites.Outils
Les 26 outils, par rôle et par niveau d’accès.Pour une présentation sans détail technique, voir le guide Assistant IA du centre d’aide.
Données accessibles
L’assistant agit en tant que la personne qui l’a connecté, sur les entreprises auxquelles elle appartient au moment de la connexion. Il n’a jamais accès à plus de données qu’elle dans Puncto, et souvent à moins. Pour l’identité d’un collaborateur, les outils renvoient le nom, l’email et le matricule, mais jamais l’adresse, le numéro de sécurité sociale, les coordonnées bancaires ni les justificatifs.
Si elle appartient à plusieurs entreprises, l’assistant commence par list_my_companies et passe
ensuite companyId à chaque outil. Chaque réponse contient le lien de la page Puncto
correspondante, pour vérifier ou terminer la saisie dans l’application.
Deux niveaux d’accès
À la connexion, la page d’autorisation de Puncto propose :
| Accès | Scope OAuth | Outils |
|---|---|---|
| Lecture seule | mcp |
Consultation uniquement |
| Lecture et modification | mcp mcp:write |
Consultation, plus les outils de saisie |
Pour utiliser les outils de saisie, un administrateur doit aussi avoir l’accès administrateur Lecture & Edition dans Puncto. Pour changer de niveau, retirez l’accès puis reconnectez l’assistant.
Les mêmes contrôles que dans l’application
Chaque outil de saisie appelle le même code que la page correspondante de Puncto :
- une saisie sur un mois clôturé, un congé au-delà du solde disponible ou une variable issue d’une feuille de temps sont refusés comme dans l’application, avec le même message ;
- les bulletins en brouillon concernés sont recalculés ;
- les outils de saisie sont annotés
readOnlyHint: false, si bien que Claude et ChatGPT demandent l’accord de l’utilisateur avant chaque appel ; - chaque élément créé par un assistant est enregistré avec la personne qui l’a autorisé et l’assistant utilisé, et signalé dans Puncto par le logo de l’assistant.
Les opérations qui demandent un justificatif, une déclaration ou un calcul à vérifier restent dans Puncto : arrêts de travail, congés parentaux, abonnements annuels, indemnités kilométriques, temps de travail, classification et fin de contrat.
Serveur MCP ou API publique
| Serveur MCP | API publique | |
|---|---|---|
| Pour | Un assistant IA, piloté en langage naturel | Votre SIRH, ERP ou script |
| Agit en tant que | La personne connectée, avec ses droits | L’entreprise, par une clé d’API |
| Authentification | OAuth 2.1, sans secret à copier | Clé d’API en Bearer |
| Périmètre | Les opérations courantes | Toutes les données de la paie, en lecture et en écriture |
Exemples de demandes
- « Quelles demandes d’absence attendent une validation ? »
- « Valide le congé de Courtney. »
- « Ajoute une prime de cooptation de 500 € à Thomas ce mois-ci. »
- « Pose une semaine de congés à Courtney à partir du 14 décembre. »
- « Nicholas a fait 3 h supplémentaires hier. »
- « Passe Thomas à 52 000 € brut annuels au 1er janvier. »
- « Invite Ada Lovelace, qui commence en CDI le 1er décembre. »
- « Où en est la paie d’octobre ? »
- « Qu’est-ce que j’ai à faire cette semaine ? »
- « Combien de jours de congés il me reste ? »
- « Pourquoi mon net a baissé en août ? »