---
title: "Connecter un client"
description: "Transport, OAuth 2.1 et configuration des clients 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.

# Connecter un client

Le serveur suit la [spécification MCP](https://modelcontextprotocol.io/specification), 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

### Claude

Dans **Paramètres › Connecteurs**, choisissez **Ajouter un connecteur personnalisé** et collez
l’URL. Claude ouvre ensuite la page d’autorisation de Puncto.

### Claude Code

```bash
claude mcp add --transport http puncto https://api.puncto.fr/mcp
```

Puis lancez `/mcp` dans Claude Code pour vous authentifier.

### Cursor

Dans `~/.cursor/mcp.json` :

```json
{
  "mcpServers": {
    "puncto": { "url": "https://api.puncto.fr/mcp" }
  }
}
```

### VS Code

Dans `.vscode/mcp.json` :

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

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