Connecter un assistant

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 liste chaque outil avec son autorisation et ses arguments.

Claude Code

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

Shell
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 :

Shell
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 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