Serveur MCP

Un serveur Model Context Protocol publié sous le nom @capydb/mcp. Il s’exécute en local via stdio, ou à distance sur https://mcp.capydb.dev/mcp via Streamable HTTP, et appelle la même API du plan de contrôle que le tableau de bord et la CLI, avec le même périmètre d’organisation, les mêmes permissions et la même piste d’audit.

Il embarque un client écrit à la main plutôt que de dépendre du SDK à l’exécution : l’installation reste légère et le démarrage instantané.

Claude sur le web, sur ordinateur et sur mobile – ainsi que tout client qui prend en charge les serveurs MCP distants – se connecte à https://mcp.capydb.dev/mcp. Rien à installer, aucune clé à coller : la première fois qu’un outil a besoin de votre compte, le client vous fait passer par la connexion CapyDB dans le navigateur, où vous choisissez l’espace de travail qu’il peut utiliser. Les bases éphémères jetables fonctionnent avant même la connexion.

La connexion est une clé d’API d’agent, listée dans Paramètres → Clés d’API et révocable à tout moment. Elle expire au bout de 90 jours ; le client vous demande alors de vous reconnecter. Dans Claude Code, ajoutez la même URL avec la commande ci-dessous.

claude mcp add --transport http capydb https://mcp.capydb.dev/mcp

Ajoutez-le à la configuration serveur de n’importe quel client MCP. Le serveur gère lui-même l’authentification : au premier usage sans clé, il renvoie une URL de connexion par appareil à approuver dans un navigateur.

{
  "mcpServers": {
    "capydb": {
      "command": "npx",
      "args": ["-y", "@capydb/mcp"],
      "env": { "CAPYDB_API_KEY": "capy_live_..." }
    }
  }
}

• -Claude sur le web, sur ordinateur et sur mobile via le serveur distant ; Claude Code à distance ou en local
• -Cursor, Windsurf et les autres éditeurs prenant en charge MCP
• -Tout client implémentant le Model Context Protocol en stdio ou en Streamable HTTP - le serveur sert à la fois la révision actuelle et l’ancienne
• -Votre propre agent, via n’importe quel SDK MCP

• -Projets : lister, créer, inspecter ; bases éphémères que vous pouvez réclamer ou détruire
• -Connexions : obtenir les chaînes de connexion directes et poolées, et les identifiants du store K/V
• -SQL : requêtes en lecture seule et, dans un outil séparé, instructions qui modifient les données, résultats renvoyés en JSON structuré
• -Schéma : inspecter tables, colonnes, index et extensions
• -Previews : créer, lister, réinitialiser et supprimer des bases de preview
• -Sauvegardes : créer et lister les sauvegardes, exporter des dumps, créer des points de restauration, restaurer dans une preview
• -Imports : démarrer et suivre un import depuis un autre fournisseur
• -Exploitation : consommation, logs, observabilité, alertes, jobs et recommandations d’index

Les outils en lecture seule se déclarent en lecture seule et les outils destructeurs se déclarent destructeurs, pour qu’un client puisse les encadrer. Un UPDATE ou un DELETE sans WHERE, ou un TRUNCATE, est refusé par le plan de contrôle avant de s’exécuter, et le refus indique à l’agent comment corriger l’appel ; le serveur MCP ne contourne jamais cette vérification. Pour tout ce qui est plus risqué, la description de l’outil demande à l’agent de créer d’abord un point de restauration.

Restaurer par-dessus une base de production n’est délibérément pas exposé comme outil. Un agent peut restaurer dans une preview que vous promouvez ensuite vous-même ; il ne peut pas écraser vos données de production de sa propre initiative.

Tout ce que le serveur dit de lui-même part sur la sortie d’erreur standard, car la sortie standard est le canal du protocole. Si un client affiche une liste d’outils vide, la réponse se trouve presque toujours dans le journal MCP du client, pas dans le serveur.