Skip to content

Connecter un client

Transport, OAuth 2.1 et configuration des clients MCP.

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

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

Puis 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.

Type to search…

↑↓ navigate↵ selectEsc close