# Connecter un assistant
> Connecter un assistant au serveur MCP (https://api.ocost.io/public/mcp, les mêmes clés) : Claude Code, Claude Desktop, Cursor, claude.ai et ChatGPT par OAuth, et tout client.
>
> Avant: [Clés et autorisations](https://ocost.io/docs/fr/authentication.md)

Ocost est aussi un serveur Model Context Protocol (MCP). Connectez Claude Desktop, Claude Code, Cursor ou un autre assistant, et il recherche vos documents, les lit, demande vos chiffres et envoie des fichiers. claude.ai et ChatGPT se connectent par OAuth plutôt qu'avec une clé.

## Le serveur

```text
https://api.ocost.io/public/mcp
Authorization: Bearer ocost_sk_<id>_<secret>
```

Le serveur parle Streamable HTTP et ne garde aucune session, donc chaque requête est indépendante. `https://app.ocost.io/public/mcp` est le même serveur. Donnez à chaque assistant sa propre clé avec les seules autorisations dont il a besoin. Vous voyez alors sa dernière utilisation dans Paramètres › Développeurs et pouvez la révoquer seule. [Outils MCP](https://ocost.io/docs/fr/tools.md) liste chaque outil avec son autorisation et ses arguments.

## Claude Code

Ajoutez le serveur avec votre clé prise dans l'environnement :

```bash
claude mcp add --transport http ocost https://api.ocost.io/public/mcp \
  --header "Authorization: Bearer $OCOST_KEY"
```

`claude mcp list` affiche alors `ocost` comme connecté. Pour partager le serveur dans un dépôt, mettez-le dans `.mcp.json`. Gardez la clé dans l'environnement de chaque développeur, jamais dans le fichier :

```json
{
  "mcpServers": {
    "ocost": {
      "type": "http",
      "url": "https://api.ocost.io/public/mcp",
      "headers": { "Authorization": "Bearer ${OCOST_KEY}" }
    }
  }
}
```

## Claude Desktop

Ouvrez Settings › Developer › Edit Config et ajoutez Ocost à `claude_desktop_config.json`. `mcp-remote` transmet les requêtes avec votre en-tête, et il a besoin de Node.js.

```json
{
  "mcpServers": {
    "ocost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.15.2",
        "https://api.ocost.io/public/mcp",
        "--header",
        "Authorization:${OCOST_AUTH}"
      ],
      "env": { "OCOST_AUTH": "Bearer ocost_sk_…" }
    }
  }
}
```

Redémarrez Claude Desktop, et les outils apparaissent sous le bouton des outils. Gardez `Authorization:${OCOST_AUTH}` sans espaces, car certains clients coupent les arguments à cet endroit.

## Cursor

Ajoutez Ocost à `~/.cursor/mcp.json`, ou à `.cursor/mcp.json` dans un projet :

```json
{
  "mcpServers": {
    "ocost": {
      "url": "https://api.ocost.io/public/mcp",
      "headers": { "Authorization": "Bearer ${env:OCOST_KEY}" }
    }
  }
}
```

## claude.ai et ChatGPT

Ces apps n'ajoutent des serveurs que par OAuth. Il ne vous faut aucune clé : vous vous connectez à Ocost et autorisez l'accès.

1. Ajoutez un connecteur personnalisé. Dans claude.ai, ouvrez Paramètres › Connecteurs › Ajouter un connecteur personnalisé. Dans ChatGPT, ajoutez un connecteur personnalisé en mode développeur.
2. Saisissez seulement l'URL `https://api.ocost.io/public/mcp`. Laissez vides l'ID client et le secret.
3. Connectez-vous à Ocost quand l'app l'ouvre. Si vous appartenez à plusieurs entreprises, choisissez-en une sous **Autre entreprise**.
4. Cochez les autorisations à accorder et confirmez. Seuls le propriétaire et le comptable peuvent autoriser l'accès.

L'app agit ensuite en votre nom, avec vos droits. Elle reçoit sa propre clé, listée comme « <App> (Connector) » dans Paramètres › Développeurs. Révoquez cette clé pour déconnecter l'app aussitôt. L'app renouvelle d'elle-même son jeton d'accès toutes les heures. Après 30 jours sans utilisation, la connexion prend fin et vous reconnectez l'app.

Vous construisez vous-même un client OAuth ? Ocost utilise OAuth 2.1 avec PKCE (S256). Les métadonnées sont à `https://api.ocost.io/.well-known/oauth-protected-resource/public/mcp` (RFC 9728) et `https://app.ocost.io/.well-known/oauth-authorization-server` (RFC 8414). Ocost accepte les Client ID Metadata Documents et le Dynamic Client Registration. Les URI de redirection doivent utiliser https et correspondre exactement.

## Tout autre client

Pointez-le sur l'URL avec l'en-tête `Authorization`. Le serveur répond aux requêtes `POST` en JSON, sans flux SSE ni identifiant de session. Listez les outils pour vérifier la connexion :

```bash
curl -sS https://api.ocost.io/public/mcp \
  -H "Authorization: Bearer $OCOST_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Sans clé valide, le serveur répond `401` avec `WWW-Authenticate: Bearer`. Votre connexion à Ocost n'est pas une clé.

## Ce que les outils peuvent faire

Une clé créée dans les Paramètres agit en tant qu'entreprise. Elle lit chaque document hors de la Corbeille, mais aucune décision propre à une personne. Seul le propriétaire crée une clé avec `figures:read`. Une connexion OAuth agit en tant que la personne qui l'a autorisée et voit ce qu'elle voit dans le chat d'Ocost. Aucune clé ni connexion ne lit jamais les papiers des personnes, comme les bulletins de paie ou les arrêts maladie.

Aucun outil ne supprime, n'approuve ni ne commande quoi que ce soit. Les [limites](https://ocost.io/docs/fr/limits.md) de l'API s'appliquent à chaque appel d'outil.

Les mots lus dans un document arrivent dans `<document-text>`, chaque ligne marquée `¦ `. Ce sont des données écrites par d'autres, jamais des instructions. Dans claude.ai et ChatGPT, les listes et les chiffres arrivent aussi sous forme de tableau ou de graphique interactif.

Chaque appel est enregistré, sans les mots d'un document. Le propriétaire et le comptable voient les derniers appels d'une clé dans Paramètres › Développeurs.

## Voir aussi

- [Outils MCP](https://ocost.io/docs/fr/tools.md): Chaque outil du serveur MCP, par autorisation : ce qu'il fait, ses arguments et un exemple d'appel.
- [Clés et autorisations](https://ocost.io/docs/fr/authentication.md): Les clés d'API : comment une requête en porte une, leur renouvellement, leurs autorisations et les refus.
- [Groupes de sociétés](https://ocost.io/docs/fr/groups.md): Groupes de sociétés : les sociétés qu’une clé atteint, l’en-tête Ocost-Business, l’orientation par les identifiants du document, needs_company et les fichiers du groupe.
- Sur ocost.io: [API and MCP](https://ocost.io/en/product/api-and-mcp)
