Serveur MCP Supabase : se connecter en toute sécurité en cinq minutes

Serveur MCP Supabase

Serveur MCP Supabase : configuration, mode lecture seule et sécurité | We.Inc

Connectez un outil de code IA à Supabase avec le serveur MCP officiel : l'URL du serveur, les options read_only et project_ref, les groupes de fonctionnalités, les outils et les conseils de sécurité.

Le serveur MCP Supabase permet à un assistant de code IA de lire vos tables, d'exécuter du SQL, de consulter les logs et de déployer des fonctions via un seul lien : https://mcp.supabase.com/mcp. Ajoutez ?read_only=true pour que les requêtes ne puissent pas modifier les données et ?project_ref= pour qu'il n'atteigne qu'un seul projet, et continuez à approuver chaque appel d'outil à la main.

Les options d'URL documentées par Supabase

Option
Ce qu'elle fait

read_only=true
Exécute chaque requête avec un utilisateur Postgres en lecture seule

project_ref=<id>
Limite l'accès à un seul projet et désactive les outils de compte

features=database,docs
Active uniquement les groupes d'outils listés ; storage est désactivé par défaut

URL locale

MCP, le Model Context Protocol, est une méthode standard qui permet à une application d'IA d'appeler des outils externes. Construisez votre lien de connexion ci-dessous : choisissez un projet, le mode lecture seule et les groupes d'outils, puis copiez la configuration. Rien ne quitte votre navigateur.

Trouvez l'ID de référence de votre projet dans les paramètres du projet, dans le tableau de bord Supabase.
Construisez le lien avec les options souhaitées et collez le JSON dans le fichier de paramètres de votre client MCP.
À la première utilisation, le client ouvre une fenêtre de navigateur : connectez-vous à Supabase, choisissez l'organisation et autorisez l'accès.
Pour la CI ou une machine sans navigateur, créez un jeton d'accès personnel à portée limitée et envoyez-le dans un en-tête Authorization: Bearer.

Pointez-le vers un projet de développement, pas vers votre boutique en production. Supabase conseille de ne se connecter à la production que lorsque la tâche l'exige vraiment.
Méfiez-vous de l'injection de prompt : un texte stocké dans vos tables, comme un ticket de support, peut contenir des instructions qui poussent l'assistant à lancer une requête dangereuse.
Considérez-le comme un outil réservé à vos propres développeurs. Supabase indique qu'il dispose de vos permissions et ne doit pas être confié à des clients.
Pour les tâches sans surveillance, n'autorisez que des outils en lecture seule limités au projet et faites en sorte que la tâche produise un rapport au lieu d'écrire.
Utilisez le branching pour tester des modifications de schéma loin de la production. Supabase indique que les outils de branching sont expérimentaux et réservés aux forfaits payants.

Questions fréquentes

Que peut faire le serveur MCP Supabase ?

Ses outils documentés listent les tables et les migrations, appliquent des migrations, exécutent du SQL, interrogent les logs, lisent les conseillers de sécurité et de performance, génèrent des types TypeScript, gèrent les Edge Functions, cherchent dans la documentation et, sauf restriction, gèrent les projets.

Le mode lecture seule est-il assez sûr ?

Il empêche les écritures, car les requêtes s'exécutent avec un utilisateur de base de données en lecture seule, mais l'assistant peut toujours lire tout ce que cet utilisateur peut lire. Associez-le à project_ref et gardez les données personnelles hors de vos demandes.

Ai-je besoin d'un jeton d'accès ?

Pas avec la connexion par défaut du serveur hébergé, qui passe par une connexion dans le navigateur. Un jeton d'accès personnel n'est nécessaire que pour la CI ou les configurations headless, et tous les clients ne prennent pas en charge les en-têtes personnalisés.

Quels groupes de fonctionnalités existent ?

Le code du serveur liste docs, account, database, debugging, development, functions, branching, storage et notebooks. La documentation de Supabase indique que tous les groupes sauf storage sont activés par défaut.

Les visiteurs de mon site peuvent-ils l'utiliser ?

Non. Il fonctionne avec vos permissions de développeur, c'est pourquoi Supabase recommande de le garder comme outil interne plutôt que comme quelque chose d'accessible aux utilisateurs finaux.

Ce que couvre chaque groupe d'outils

database : list_tables, list_extensions, list_migrations, apply_migration et execute_sql. debugging : query_logs et get_advisors. development : get_project_url, get_publishable_keys et generate_typescript_types.
functions permet de lister, lire et déployer des Edge Functions et de définir leurs secrets. docs contient search_docs. account regroupe les outils de projet et d'organisation, dont create_project et pause_project, et se désactive quand vous limitez l'accès à un seul projet.

Une configuration de départ sûre

Limitée à un projet, en lecture seule, avec uniquement les outils database et docs. Remplacez par votre propre ID de référence.

Connexion limitée et en lecture seule

La plupart des clients lisent un objet mcpServers comme celui-ci ; le nom du fichier dépend du client.

Générateur de connexion

ID de référence du projet (facultatif, mais recommandé)

la référence de votre projet

Mode lecture seule

Groupes d'outils

Lien du serveur

JSON de configuration (par exemple .cursor/mcp.json)

Copier

Copié

Choisissez au moins un groupe d'outils.

Le groupe account est ignoré dès que vous définissez une référence de projet.

Serveur MCP Supabase : se connecter en toute sécurité en cinq minutes