Supabase Codex local manual Migration

Étape 1 — Connecter MCP au projet local

Supabase expose aussi un MCP local :

1http://localhost:54321/mcp

Tu peux connecter Codex directement au local.

Dans :

1~/.codex/config.toml
2[mcp_servers.supabase_local]
3url = "http://localhost:54321/mcp"
4
5[features]
6rmcp_client = true

Puis :

1codex

Et dans Codex :

1/mcp

Étape 2 — Utiliser Codex comme auditeur de drift

Le workflow le plus utile :

1Compare mon projet local et mon projet cloud Supabase.
2Détecte :
3- policies manquantes
4- fonctions absentes
5- extensions différentes
6- buckets storage manquants
7- edge functions absentes
8- secrets référencés mais non définis

Le MCP peut :

• lire le schéma
• inspecter les fonctions
• lire les logs
• inspecter les migrations
• générer du SQL
• Synchroniser les Edge Functions

Codex peut :

• lister les fonctions distantes
• récupérer leur contenu
• générer les dossiers locaux
• générer les commandes deploy

Exemple :

1Utilise Supabase MCP pour :
2- lister toutes les edge functions cloud
3- créer leur structure locale
4- générer les commandes de déploiement

Le MCP expose :

• list_edge_functions
• get_edge_function
• deploy_edge_function
• Synchroniser les secrets

Le MCP ne donne pas accès aux valeurs des secrets (heureusement).

Mais Codex peut détecter :

• quels secrets sont utilisés
• lesquels manquent
• lesquels doivent être créés

Exemple :

1Analyse mes edge functions et détecte tous les secrets requis.
2Génère ensuite les commandes supabase secrets set.

Puis Codex produit :

• supabase secrets set OPENAI_API_KEY=…
• supabase secrets set STRIPE_SECRET_KEY=…

Très utile pour éviter les oublis.

3. Synchroniser le Storage

Le MCP peut lister les buckets si la feature storage est activée.

Configurer :

1[mcp_servers.supabase]
2url = "https://mcp.supabase.com/mcp?features=storage,database"

Puis demander :

1Liste les buckets storage et génère un script de synchronisation cloud vers local.

Codex peut alors générer :

• supabase storage ls avatars –linked –experimental
• supabase storage cp …

ou un script Node.js utilisant :

• @supabase/storage-js
• Synchroniser Auth

Codex peut auditer :

• providers OAuth manquants
• redirect URLs
• templates email
• RLS liées à auth.users

Exemple :

1Inspecte mon auth Supabase et détecte les différences entre local et cloud.
2Générer automatiquement les types TS

Très utile après migration :

4. Génère les types TypeScript à partir du schéma local.

Le MCP possède :

• generate_typescript_types

Codex peut ensuite :

• écrire database.types.ts
• mettre à jour ton SDK