---
title: "Serveur MCP"
description: "Accéder à la paie depuis Claude, ChatGPT, Cursor ou un autre client MCP."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.puncto.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Serveur MCP

Le serveur [MCP](https://modelcontextprotocol.io) (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
```

- [Connecter un client](/developpeurs/mcp/connexion) — OAuth 2.1, découverte, clients compatibles et limites.
- [Outils](/developpeurs/mcp/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](/aide/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](/developpeurs/authentification) |
| --- | --- | --- |
| 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 ? »

Source: https://docs.puncto.fr/developpeurs/mcp/index.mdx
