Supabase MCP: migraciones y base de datos
Cuándo usar esta skill
- El usuario pide aplicar migraciones (con MCP o "con tools mcp").
- Pide gestionar la base de datos usando el MCP de Supabase.
- Necesitas listar migraciones aplicadas, ejecutar SQL o consultar esquema sin usar la CLI local.
Servidor MCP: user-supabase-SantiagoXOR. Usar call_mcp_tool con este server.
Aplicar una migración
- Leer el SQL del archivo en
supabase/migrations/*.sql. - Nombre en snake_case: usar el nombre del archivo sin fecha ni extensión (ej.
20260224100000_create_push_subscriptions.sql→create_push_subscriptions). - Llamar al MCP:
call_mcp_tool server: user-supabase-SantiagoXOR toolName: apply_migration arguments: {"name": "<snake_case_name>", "query": "<contenido SQL completo>"} - Si falla por tipos en RLS (ej.
operator does not exist: text = uuid): en las políticas que usenauth.uid()o FKs, usar casts explícitos (auth.uid()::text,user_id::text IN (SELECT id::text FROM...)). Corregir el archivo de migración en el repo y volver a aplicar.
Importante: Para DDL (CREATE TABLE, ALTER, políticas RLS, etc.) usar siempre apply_migration, no execute_sql.
Otras herramientas útiles del MCP
| Herramienta | Uso |
|---|---|
list_migrations | Ver migraciones ya aplicadas en la DB (sin argumentos). |
execute_sql | Ejecutar SELECT o DML (INSERT/UPDATE/DELETE). No usar para DDL; para eso usar apply_migration. |
list_tables | Listar tablas del esquema (consultar descriptor en mcps/user-supabase-SantiagoXOR/tools/list_tables.json si hace falta). |
get_advisors | Recomendaciones del proyecto Supabase. |
get_logs | Logs del proyecto. |
Todas con call_mcp_tool, server: user-supabase-SantiagoXOR, toolName: <nombre>, arguments: {...} según el descriptor en mcps/user-supabase-SantiagoXOR/tools/<nombre>.json.
Orden al aplicar varias migraciones
Aplicar en orden cronológico (por prefijo de fecha en el nombre del archivo). Si una falla, corregir y reaplicar solo esa antes de seguir.
Referencia
- Listado de herramientas y parámetros: reference.md.
- Antes de llamar una herramienta, leer el descriptor en
mcps/user-supabase-SantiagoXOR/tools/<toolName>.jsonpara argumentos requeridos.