Le serveur suit la spécification MCP, avec le transport Streamable HTTP et l’autorisation OAuth 2.1. Un client MCP récent n’a besoin que de l’URL. Il découvre lui-même la configuration d’autorisation et ouvre la page d’autorisation de Puncto dans le navigateur.
https://api.puncto.fr/mcpVous pouvez aussi copier l’adresse dans Puncto, sur la page Sécurité de votre compte, dans la carte Applications MCP.
Configurer un client
Dans Paramètres › Connecteurs, choisissez Ajouter un connecteur personnalisé et collez l’URL. Claude ouvre ensuite la page d’autorisation de Puncto.
claude mcp add --transport http puncto https://api.puncto.fr/mcpPuis lancez /mcp dans Claude Code pour vous authentifier.
Dans ~/.cursor/mcp.json :
{
"mcpServers": {
"puncto": { "url": "https://api.puncto.fr/mcp" }
}
}Dans .vscode/mcp.json :
{
"servers": {
"puncto": { "type": "http", "url": "https://api.puncto.fr/mcp" }
}
}Pour ChatGPT, Gemini et les autres clients compatibles OAuth, ajoutez l’URL comme connecteur MCP distant.
Autorisation
Puncto est son propre serveur d’autorisation OAuth 2.1.
| Découverte | Une requête sans jeton reçoit 401 et un en-tête WWW-Authenticate vers /.well-known/oauth-protected-resource/mcp (RFC 9728), qui désigne /.well-known/oauth-authorization-server (RFC 8414) |
| Enregistrement du client | Dynamique sur POST /oauth/register (RFC 7591), ou par un Client ID Metadata Document (un client_id sous forme d’URL HTTPS) |
| Clients | Publics uniquement (token_endpoint_auth_method: none), PKCE S256 obligatoire |
| Redirection | URL HTTPS, ou http://localhost pour les clients en ligne de commande |
| Scopes | mcp (lecture), mcp:write (saisie) |
| Jetons | Code d’autorisation 10 minutes, jeton d’accès 60 minutes, jeton de rafraîchissement 30 jours |
| Révocation | POST /oauth/revoke (RFC 7009) |
Les points d’accès OAuth sont sur https://api.puncto.fr : /oauth/authorize, /oauth/token,
/oauth/register et /oauth/revoke.
La page d’autorisation
Sur cette page, l’utilisateur se connecte à Puncto, voit au nom de quels rôles l’assistant agira,
puis choisit Lecture seule (mcp) ou Lecture et modification (mcp mcp:write). Même si le
client demande mcp:write, c’est l’utilisateur qui décide d’accorder ou non la modification.
L’autorisation couvre les entreprises dont l’utilisateur fait partie au moment où il la donne. S’il rejoint une autre entreprise ensuite, il doit reconnecter l’assistant. Un compte suspendu, ou un administrateur qui doit encore accepter des conditions d’utilisation, n’apparaît pas dans les outils.
Retirer l’accès
L’utilisateur peut retirer l’accès d’une application depuis la carte Applications MCP de la
page Sécurité de son compte. Elle liste chaque application avec sa date d’autorisation et sa date
de dernière utilisation. Le client peut aussi révoquer son jeton avec POST /oauth/revoke.
Limites
| Sessions | Serveur sans état. Chaque requête porte son jeton, il n’y a pas de session à maintenir |
| Corps de requête | 64 Kio au plus |
| Paramètres d’un outil | 1 000 éléments au plus |
| Listes paginées | perPage jusqu’à 100, 25 par défaut |
Une erreur métier (mois clôturé, solde insuffisant, entreprise à préciser) est renvoyée comme une erreur d’outil, avec un message en français que l’assistant peut relayer tel quel.