Skip to content

Serveur MCP

Accéder à la paie depuis Claude, ChatGPT, Cursor ou un autre client MCP.

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/mcp

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 ? »

Type to search…

↑↓ navigate↵ selectEsc close