Serveur MCP Deposium¶

Le serveur MCP Deposium branche tes documents, ta recherche, ton graphe de connaissances et tes workflows directement dans ton assistant IA — Claude Code, Claude Desktop, Codex, et tout client compatible Model Context Protocol.

Une fois connecté, ton assistant découvre les outils Deposium tout seul : tu n'as rien à configurer de ce côté. Tu lui demandes de chercher dans tes documents, d'explorer le graphe ou de lancer un workflow, sans quitter ton éditeur.

Avant de commencer¶


Endpoint	`https://mcp.deposium.ai/mcp`
Transport	HTTP (Streamable HTTP) à distance, ou stdio en pont local
Authentification	en-tête `X-API-Key: dep_…`
Obtenir ta clé	app.deposium.ai → Clés API

Rien à régler côté outils

Ton assistant verra l'outil deposium_chat (recherche + réponse sourcée) en premier, plus quelques outils macro. Il choisit lui-même lequel utiliser selon ta demande.

Connecter ton client¶

Claude CodeClaude DesktopCodexOdysseus

claude mcp add --transport http deposium https://mcp.deposium.ai/mcp \
  --header "X-API-Key: dep_VOTRE_CLÉ"

Vérifie avec claude mcp list. Réf. : code.claude.com/docs/en/mcp

Claude Desktop n'utilise que le transport local stdio : on relaie vers l'endpoint HTTP avec mcp-remote. Dans claude_desktop_config.json :

{
  "mcpServers": {
    "deposium": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.deposium.ai/mcp",
               "--header", "X-API-Key: dep_VOTRE_CLÉ"]
    }
  }
}

Redémarre Claude Desktop ensuite.

Windows / WSL

Claude Desktop tourne côté Windows, pas dans WSL : Node/npx doivent être installés sur Windows, et le fichier se trouve dans %APPDATA%\Claude\claude_desktop_config.json.

Dans ~/.codex/config.toml — recommandé : la clé est lue depuis une variable d'environnement (DEPOSIUM_API_KEY), pas écrite dans le fichier :

[mcp_servers.deposium]
url = "https://mcp.deposium.ai/mcp"
env_http_headers = { "X-API-Key" = "DEPOSIUM_API_KEY" }

Variante rapide (clé en clair dans le fichier — moins recommandé) :

[mcp_servers.deposium]
url = "https://mcp.deposium.ai/mcp"
http_headers = { "X-API-Key" = "dep_VOTRE_CLÉ" }

codex mcp add gère --url/--bearer-token-env-var mais pas d'en-tête arbitraire : pour X-API-Key, passe par le TOML ci-dessus. Réf. : developers.openai.com/codex/mcp

Odysseus est un espace de travail IA open-source qui fait office d'hôte MCP. Pour un serveur HTTP distant, son interface ne gère aujourd'hui que l'authentification OAuth (pas d'en-tête personnalisé) — pour te connecter avec ta clé API, passe par un pont stdio avec mcp-remote.

Dans Settings → Integrations → MCP → Add MCP Server :

Transport : stdio
Command : npx
Args : ["-y", "mcp-remote", "https://mcp.deposium.ai/mcp", "--header", "X-API-Key: dep_VOTRE_CLÉ"]

Que demander ensuite¶

Une fois connecté, essaie par exemple :

« Cherche dans mes documents ce qui parle de [sujet] et donne-moi les sources. »
« Résume les points clés de [document] avec les citations. »
« Quelles entités sont liées à [X] dans mon graphe de connaissances ? »
« Compare ce que disent [doc A] et [doc B] sur [sujet]. »

Ton assistant traduit ça en appels deposium_chat / deposium_query et te répond avec les passages sources.

En cas de souci¶

401 / refusé : vérifie l'en-tête X-API-Key et que ta clé dep_… est active dans app.deposium.ai.
npx introuvable (Claude Desktop, Windows) : installe Node.js sur Windows, ou lance via wsl.exe.
deposium_chat n'apparaît pas : redémarre le client après avoir modifié la config.