Pour les agents

Serveur MCP

Quarante outils en stdio, pour que l’assistant avec qui vous parlez déjà exécute votre travail de base de données au lieu de le décrire.

01

De quoi il s’agit

Un serveur Model Context Protocol publié sous le nom @capydb/mcp. Il parle stdio, s’exécute localement 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é.

02

Installation

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_..." }
    }
  }
}

03

Clients

  • -Claude Code et l’application de bureau Claude
  • -Cursor, Windsurf et les autres éditeurs prenant en charge MCP
  • -Tout client implémentant le Model Context Protocol en stdio - le serveur sert à la fois la révision actuelle et l’ancienne
  • -Votre propre agent, via n’importe quel SDK MCP

04

Ce que couvrent les outils

  • -Projets : lister, créer, inspecter, renommer, mettre en pause, reprendre, supprimer
  • -Connexions : obtenir les chaînes de connexion directes et poolées, faire tourner les identifiants
  • -SQL : exécuter requêtes et instructions sur un projet, 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 : lister les sauvegardes, créer des points de restauration, restaurer une preview à un instant donné
  • -Imports : démarrer et suivre un import depuis un autre fournisseur
  • -Espace de travail : organisations, membres, clés d’API, consommation et entrées d’audit

05

Sûreté

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. Le SQL destructeur exige la création préalable d’un point de restauration : le serveur le signale à l’agent au lieu d’exécuter l’instruction.

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.

06

Diagnostic

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.