Connecter des outils d'IA à Espobase
Le connecteur Espobase permet à Claude, ChatGPT, Cursor, VS Code et aux autres outils compatibles avec le Model Context Protocol (MCP) de travailler avec vos projets : lire le schéma et la référence d'API, générer des types, lancer des requêtes en lecture seule, consulter les journaux et l'utilisation, et proposer des modifications de la base de données que vous approuvez.
Connexion
Claude (claude.ai, Claude Desktop) et ChatGPT : ajoutez un connecteur personnalisé avec l'URL du serveur ci-dessous et cliquez sur Connect. Vous vous connectez à Espobase (e-mail, GitHub, Google, Apple ou SSO), vous vérifiez ce que l'outil pourra faire et vous autorisez l'accès. Aucune clé à copier.
https://app.espobase.com/api/mcp
Dans Claude : Settings › Connectors › Add custom connector. Dans ChatGPT : Settings › Connectors (ou Apps).
Claude Code, Cursor, VS Code et autres clients MCP : créez un jeton d'accès personnel dans le tableau de bord (Paramètres du compte › Développeur), où vous trouverez aussi une configuration prête à coller pour chaque outil. Par exemple, dans Claude Code :
claude mcp add --transport http espobase https://app.espobase.com/api/mcp \ --header "Authorization: Bearer <your token>"
Il vous faut un compte Espobase ; le connecteur fonctionne avec toutes les offres.
Ce qu'un outil connecté peut et ne peut pas faire
- Il agit en votre nom : uniquement dans les organisations et projets auxquels vous avez accès, avec votre rôle.
- Il ne voit que ce que vous avez autorisé sur l'écran de consentement (par exemple le schéma, les journaux, le SQL en lecture seule).
- Le SQL est toujours en lecture seule : les instructions qui modifieraient les données ou la structure sont refusées, même si vous êtes propriétaire du projet.
- Il peut proposer des modifications de la base de données, mais jamais les appliquer. Vous relisez le SQL et l'appliquez depuis l'onglet IA de votre projet.
- Il ne reçoit jamais de mots de passe de base de données, de clés secrètes d'API ni d'autres identifiants.
- Vous pouvez le déconnecter à tout moment dans Paramètres du compte › Développeur › Applications connectées ; l'accès prend fin immédiatement.
Outils
| whoami | Votre compte Espobase et vos organisations. |
| list_projects | Les projets auxquels vous avez accès, avec statut, environnement, région et votre rôle. |
| get_project | Les détails d'un projet. |
| get_schema | Tables, colonnes, relations, sécurité au niveau des lignes et politiques (structure uniquement). |
| get_api_reference | Endpoints REST, filtres, authentification et utilisation du SDK pour écrire du code client. |
| generate_typescript_types | espobase.types.ts pour des requêtes typées avec @espobase/client. |
| run_read_only_sql | Requêtes SELECT, exécutées avec l'utilisateur en lecture seule de la base de données du projet. |
| get_logs | Journaux des requêtes récentes (chemins, statut, durée ; jamais les corps de requête ni les secrets). |
| get_usage | Requêtes API, bande passante, stockage de base de données et de fichiers, utilisation de l'IA. |
| list_storage | Buckets, dossiers et noms de fichiers (pas leur contenu). |
| propose_schema_change | Un plan (tables, relations, politiques…) et son SQL, que vous relisez et appliquez. |
| create_project | Un nouveau projet, si vous avez autorisé la création de projets. |
Idées de demandes
- “Liste mes projets Espobase et résume le schéma de la base de données de mon projet principal.”
- “Quelles tables de mon projet ont la sécurité au niveau des lignes mais pas encore de politiques ?”
- “Écris une page Next.js qui liste les 20 dernières commandes de mon projet Espobase avec @espobase/client.”
- “Combien de requêtes API mon projet a-t-il traitées cette semaine, et y a-t-il eu des erreurs dans les journaux ?”
- “Propose une table todos où chaque utilisateur connecté ne voit que ses propres tâches.”
Vos données
Quand vous demandez quelque chose à votre outil d'IA, le connecteur renvoie la réponse à cet outil : par exemple des noms de tables et de colonnes, des résultats de requêtes, des entrées de journal ou des noms de fichiers. Le fournisseur d'IA traite ensuite ce contenu selon ses propres conditions et sa politique de confidentialité. Espobase ne reçoit jamais votre conversation avec l'outil d'IA. Il reçoit uniquement ce que chaque appel d'outil envoie : par exemple la requête SQL à exécuter ou, pour propose_schema_change, votre demande de modification, qui est conservée dans l'historique IA du projet comme les demandes saisies dans le tableau de bord. Les appels d'outils sont journalisés (quel endpoint, quand, le statut du résultat) à des fins de sécurité et d'audit.
Consultez la politique de confidentialité d'Espobase pour savoir comment nous traitons vos informations.
Dépannage
- Un outil indique qu'un scope manque : déconnectez-le puis reconnectez-le (ou créez un jeton avec ce scope).
- Votre organisation exige l'authentification unique (SSO) : connectez-vous à Espobase avec SSO avant de connecter l'outil.
- Un projet n'apparaît pas dans la liste : vous n'avez peut-être accès qu'à certains projets ; demandez à un administrateur de l'organisation.
Besoin d'aide ? Contactez le support.