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
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 :
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 :
{
"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.
{
"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 :
{
"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.
- 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.
- Saisissez seulement l'URL
https://api.ocost.io/public/mcp. Laissez vides l'ID client et le secret. - Connectez-vous à Ocost quand l'app l'ouvre. Si vous appartenez à plusieurs entreprises, choisissez-en une sous Autre entreprise.
- 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 :
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.