Claude Code + Supabase : Créer un Backend Complet sans Coder
Mis à jour le 3 mars 2026
Tu sais construire des interfaces avec Claude Code. Des dashboards, des formulaires, des landing pages. Le problème : ces interfaces n'ont pas de mémoire. Ferme le navigateur, les données disparaissent. Un formulaire qui n'enregistre rien. Un tableau de bord avec des chiffres en dur. C'est une maquette, pas une application.
Pour qu'une application soit réelle, il faut un backend. Un endroit pour stocker les données, gérer les comptes utilisateurs, servir des API. Traditionnellement, ça implique un serveur, du code côté serveur, une base de données à configurer. Des semaines de travail pour un développeur expérimenté.
Sauf si tu combines Claude Code et Supabase. Supabase te donne un backend complet clé en main : base de données PostgreSQL, authentification, API auto-générées, stockage fichiers, temps réel. Et grâce au serveur MCP officiel, Claude Code peut parler directement à Supabase. Tu décris ce que tu veux en français, Claude Code crée les tables, écrit les requêtes, configure la sécurité et construit l'interface connectée. Tout depuis ton terminal, en 30 minutes au lieu de 30 jours.
Pourquoi Supabase pour un vibecoder
Supabase est une alternative open source à Firebase qui te donne un backend complet en 2 minutes. Base de données PostgreSQL managée, authentification intégrée, API auto-générées, stockage fichiers et temps réel. Tout est inclus, tout est préconfiguré, et il y a un tier gratuit généreux pour commencer.
PostgreSQL est le moteur derrière Supabase. C'est la base de données relationnelle la plus fiable et la plus utilisée en production. Mais tu n'as pas besoin de l'installer, de la configurer ou de la maintenir. Supabase fait tout ça pour toi. Tu crées un projet en 2 clics et tu as une base de données professionnelle prête à l'emploi, avec une interface visuelle pour explorer tes tables.
L'authentification est incluse nativement. Connexion par email/mot de passe, Google, GitHub, Apple : tout est préconfiguré. Pas besoin de coder un système de login, de gérer les sessions, de stocker les mots de passe. Supabase Auth gère tout, y compris les emails de confirmation et les mots de passe oubliés.
Chaque table que tu crées dans Supabase devient automatiquement accessible via une API REST. Tu crées une table "produits" ? Une API /rest/v1/produits existe immédiatement pour lire, créer, modifier et supprimer des entrées. Zéro ligne de code backend à écrire.
Le stockage fichiers fonctionne comme un S3 simplifié. Upload d'images, de PDF, de documents. Avec des URL publiques ou privées selon tes besoins. Et le temps réel (realtime) permet de recevoir des mises à jour instantanées quand les données changent. Un nouveau client s'inscrit ? Ton dashboard se met à jour sans rafraîchir la page.
Pourquoi pas Firebase ? Firebase est propriétaire (Google), basé sur NoSQL (moins flexible pour les requêtes complexes), et crée un vendor lock-in. Si tu veux partir de Firebase, tu reconstruis tout. Supabase est open source, basé sur SQL standard, et tu peux exporter tes données et les héberger toi-même à tout moment. Pour un entrepreneur qui construit ses outils, c'est le choix rationnel.
Le tier gratuit est généreux : 500 Mo de base de données, 1 Go de stockage, 50 000 utilisateurs authentifiés, 500 000 appels Edge Functions. C'est largement suffisant pour valider une idée, construire un MVP, ou gérer un outil interne. Les plans payants commencent à 25$/mois quand tu as vraiment besoin de scaler.
Le serveur MCP Supabase
La vraie magie de la combinaison Claude Code + Supabase, c'est le serveur MCP. MCP (Model Context Protocol) est le protocole qui permet à Claude Code de communiquer directement avec des services externes. Supabase a un serveur MCP officiel, maintenu par l'équipe Supabase elle-même.
Concrètement, une fois le MCP configuré, Claude Code peut directement :
- Créer et modifier des tables dans ta base de données
- Insérer, lire, modifier et supprimer des données
- Écrire et exécuter des requêtes SQL complexes
- Configurer le Row Level Security (les règles de qui accède à quoi)
- Gérer les utilisateurs et les politiques d'authentification
- Créer des Edge Functions (fonctions côté serveur)
Tu n'as jamais besoin d'ouvrir l'interface Supabase. Tu parles à Claude Code en français, il traduit en SQL et en actions Supabase via MCP. La configuration tient en une seule commande :
claude mcp add --transport stdio supabase \
--env SUPABASE_URL=https://xxxxx.supabase.co \
--env SUPABASE_KEY=ta_service_role_key \
-- npx -y @supabase/mcp-serverRemplace xxxxx par l'identifiant de ton projet Supabase et ta_service_role_key par ta clé service_role (disponible dans Settings > API de ton projet Supabase). Cette commande installe le serveur MCP qui fait le pont entre Claude Code et ta base de données. C'est le même mécanisme que pour les autres serveurs MCP (GitHub, Slack, etc.).
Tutoriel : créer un backend complet en 30 minutes
Assez de théorie. Voici un cas concret de A à Z. On va construire un système de suivi clients avec base de données, CRUD complet (les 4 opérations : Create, Read, Update, Delete) et authentification. Le tout en 30 minutes.
Étape 1 : Créer le projet Supabase
Va sur supabase.com, crée un compte gratuit, et clique sur "New project". Choisis un nom et un mot de passe pour ta base de données. En 60 secondes, ton projet est prêt. Note l'URL du projet et tes clés API (Settings > API).
Étape 2 : Configurer le MCP
Dans ton terminal, lance la commande de configuration MCP vue plus haut. Ensuite, ouvre Claude Code et vérifie que la connexion fonctionne :
"Liste les tables dans ma base Supabase"Si Claude Code te retourne une liste vide (normal pour un nouveau projet), la connexion est bonne. Si tu as une erreur, vérifie l'URL et la clé API.
Étape 3 : Demander à Claude Code de créer les tables
Voici le prompt exact à donner :
"Crée les tables suivantes dans Supabase :
- clients : id (uuid auto), nom (texte requis), email (texte unique requis),
telephone (texte), statut (texte, défaut 'prospect'), notes (texte),
date_creation (timestamp auto)
- interactions : id (uuid auto), client_id (référence clients),
type (texte : appel/email/reunion), contenu (texte),
date_interaction (timestamp auto)
Active le RLS sur les deux tables."Claude Code génère et exécute le SQL via MCP. Les tables apparaissent dans Supabase. Il crée aussi les relations entre tables (un client a plusieurs interactions) et active le Row Level Security.
Étape 4 : Ajouter des données de test
"Ajoute 5 clients de test avec des statuts variés (prospect, client, perdu)
et 2-3 interactions par client. Utilise des noms et emails réalistes."Claude Code insère les données directement dans Supabase. Tu peux les voir dans l'interface Supabase, section Table Editor.
Étape 5 : Construire l'interface CRUD
"Construis une interface HTML complète pour gérer mes clients.
Elle doit :
- Afficher la liste des clients avec filtrage par statut
- Permettre d'ajouter un nouveau client via formulaire
- Permettre de modifier le statut et les notes d'un client
- Afficher l'historique des interactions d'un client
- Permettre d'ajouter une interaction
- Utiliser le SDK JavaScript Supabase (@supabase/supabase-js)
- Se connecter avec la clé anon (pas service_role)
Design moderne, sombre, responsive."Claude Code génère un fichier HTML complet avec le SDK Supabase importé, la connexion configurée, et toutes les fonctions CRUD. Le code utilise la clé anon (publique) pour le frontend, pas la service_role (admin). C'est la bonne pratique de sécurité.
Étape 6 : Ajouter l'authentification
"Ajoute un système de connexion avec Supabase Auth.
- Page de login avec email/mot de passe
- Inscription avec confirmation email
- Protection : l'app n'est accessible qu'aux utilisateurs connectés
- Bouton de déconnexion
- Politique RLS : chaque utilisateur ne voit que ses propres clients"Claude Code modifie l'interface pour ajouter le login, configure les politiques RLS dans Supabase via MCP, et lie chaque client à l'utilisateur qui l'a créé. Résultat : chaque utilisateur a son propre espace, ses propres données, isolées des autres.
Étape 7 : Tester et itérer
Ouvre le fichier HTML dans ton navigateur. Inscris-toi, connecte-toi, ajoute des clients, change des statuts, consulte les interactions. Tout fonctionne avec de vraies données persistantes dans Supabase. En 30 minutes, tu as un outil de gestion clients fonctionnel.
🎯 Construis ton premier backend complet avec Claude Code + Supabase
Dans le programme LE LABO IA, on te guide étape par étape pour connecter Supabase, créer tes tables, sécuriser tes données et construire des applications complètes — front et back — sans écrire une ligne de code toi-même.
Découvrir le programme LE LABO IA →4 projets concrets à construire
Le système de suivi clients était un exemple. Voici 4 autres projets que tu peux construire avec Claude Code + Supabase, chacun réalisable en une journée.
Dashboard client avec authentification
Un portail privé où tes clients se connectent pour suivre l'avancement de leurs projets, consulter leurs factures, télécharger des livrables. Supabase Auth gère les comptes. Le RLS garantit que chaque client ne voit que ses propres données. Claude Code construit le dashboard avec des graphiques et des indicateurs en temps réel.
Système de réservation
Un outil de prise de rendez-vous avec calendrier, créneaux disponibles, confirmation automatique. La table "reservations" stocke les créneaux dans Supabase. Claude Code construit l'interface de sélection de date. En ajoutant N8N, tu automatises les emails de confirmation et les rappels.
Application de suivi (habitudes, fitness, projets)
Un tracker personnel ou professionnel avec historique, graphiques de progression, objectifs. Les données sont stockées dans Supabase avec des timestamps. Claude Code construit l'interface de saisie et les visualisations. Le temps réel de Supabase permet de synchroniser les données entre plusieurs appareils.
Marketplace simple
Une plateforme où des vendeurs publient des offres et des acheteurs les consultent. Deux types d'utilisateurs avec des permissions différentes (RLS). Upload d'images via Supabase Storage. Recherche et filtrage côté client. Claude Code construit les pages produit, le formulaire de publication et la logique de navigation.
Les pièges à éviter
La vitesse de Claude Code + Supabase peut te donner un faux sentiment de sécurité. Construire vite ne veut pas dire construire bien. Voici les erreurs que les débutants font systématiquement.
Oublier le Row Level Security (RLS)
C'est l'erreur numéro 1. Par défaut, quand tu crées une table dans Supabase, le RLS est désactivé. Ça veut dire que n'importe qui avec ta clé anon peut lire et modifier toutes les données de la table. Dis toujours à Claude Code : "Active le RLS et crée des politiques adaptées". Le RLS est le système de permissions de Supabase : il définit qui peut lire, écrire, modifier et supprimer quelles lignes.
Exposer la clé service_role dans le frontend
La clé service_role donne un accès administrateur total à ta base. Elle contourne le RLS. Si tu la mets dans ton code HTML ou JavaScript, n'importe qui peut l'extraire et accéder à toutes tes données. Utilise uniquement la clé anon dans le frontend. La clé service_role reste dans le serveur MCP et les automatisations côté serveur.
Pas de validation côté serveur
Le frontend peut être manipulé. Un utilisateur malveillant peut modifier les requêtes envoyées à Supabase. Utilise les contraintes de base de données (champs requis, types stricts, valeurs uniques) et les Edge Functions de Supabase pour valider les données côté serveur. Demande à Claude Code de créer ces contraintes dès la création des tables.
Trop de requêtes inutiles
Chaque appel à l'API Supabase est une requête réseau. Si ton interface fait 50 requêtes au chargement de la page, c'est lent et ça consomme ton quota. Demande à Claude Code d'optimiser : récupérer les données en une seule requête avec des jointures, utiliser le cache local, ne rafraîchir que ce qui change.
Alternatives à Supabase
Supabase n'est pas la seule option. Voici les alternatives et pourquoi Supabase reste le meilleur choix pour le Vibe Coding avec Claude Code.
Firebase (Google) : Le plus connu. Authentification solide, base NoSQL (Firestore), hosting intégré. Mais propriétaire Google, pas de SQL, vendor lock-in fort. Pas de serveur MCP officiel pour Claude Code. Si tu es déjà dans l'écosystème Google, ça peut fonctionner. Sinon, évite.
Neon : PostgreSQL serverless, comme Supabase mais sans l'authentification ni le stockage intégrés. Plus technique, orienté développeurs. Bon si tu as besoin uniquement d'une base de données et que tu gères le reste toi-même. Pour un vibecoder, il manque trop de briques.
PlanetScale : Base MySQL (pas PostgreSQL) avec branching (créer des copies de ta base pour tester des changements). Technique et orienté équipes de développement. Pas adapté au Vibe Coding. Note : PlanetScale a supprimé son tier gratuit en 2024.
Pour un vibecoder qui utilise Claude Code, Supabase coche toutes les cases : backend complet, serveur MCP officiel, SQL standard que Claude Code maîtrise, open source, tier gratuit. C'est le choix par défaut recommandé.
🎯 Claude Code + Supabase + N8N : le stack complet au Labo IA
On t'accompagne pour maîtriser ce trio et construire des solutions professionnelles complètes. Frontend, backend, automatisation — sans écrire une ligne de code toi-même. De zéro à une app fonctionnelle en une journée.
Découvrir le programme LE LABO IA →Questions fréquentes
claude mcp add --transport stdio supabase avec tes clés API (SUPABASE_URL et SUPABASE_KEY). Une fois connecté, Claude Code peut créer des tables, insérer des données, configurer l'authentification et gérer le RLS directement depuis ton terminal.service_role dans le frontend (utilise uniquement la clé anon), et demande à Claude Code de créer des politiques RLS adaptées à ton cas. Consulte aussi le guide sur la sécurité dans Claude Code.