Que Cursor gestione tu proyecto de Supabase
Saltar del editor al panel para revisar tablas, logs y migraciones rompe la concentración.
4 pasosSencilla
CursorClaude CodeSupabaseGitHub
Cómo se conecta
Tu IA llega a tus apps mediante pequeños conectores llamados servidores MCP.
Tu IA
CursorClaude Code
Conectores
SupabaseGitHub
Tus apps
SupabaseGitHub
Esta configuración es para desarrolladores que trabajan con Supabase y cambian al panel a cada rato para revisar tablas, logs y migraciones. El servidor MCP de Supabase permite a Cursor o Claude Code listar tablas, ejecutar SQL, leer logs y redactar migraciones, y GitHub guarda esas migraciones en una rama revisada. Al final haces preguntas sobre la base de datos desde el editor.
Configúralo
4 pasos. Abre uno para ver los detalles.
1Añade Supabase
En Cursor, abre Settings > MCP y añade el servidor remoto de Supabase en https://mcp.supabase.com/mcp, o ejecuta claude mcp add con la misma URL en Claude Code. Inicia sesión en Supabase en la ventana que se abre y elige tu organización. Comprueba que aparecen herramientas como list_tables y execute_sql.
Consejo: La primera vez, conecta un proyecto de desarrollo, no el de producción.
2Empieza en solo lectura
Añade read_only=true y project_ref=tu-project-ref como parámetros en la URL del servidor. El modo de solo lectura ejecuta el SQL con un usuario de Postgres de solo lectura y project_ref impide que el agente toque otros proyectos. Pide al agente que liste las tablas para confirmar el alcance.
Consejo: El project ref está en la URL del proyecto o en Project Settings.
3Pregunta con contexto
Pide al agente que describa una tabla, explique una consulta lenta, revise errores en los logs o redacte una migración para una columna nueva. Ejecuta consultas de lectura y te devuelve el SQL que propone para cualquier cambio. Lee ese SQL antes de aplicar nada.
Consejo: Pide la revisión de advisors para detectar políticas RLS e índices que falten.
4Haz commit de migraciones
Guarda las migraciones nuevas como archivos en supabase/migrations y pide al agente que las suba a una rama nueva con el servidor MCP de GitHub o con tu git local. Abre una pull request para que alguien revise el SQL antes de producción. Aplica las migraciones con tu proceso de despliegue habitual.
Consejo: Mantén al agente lejos de las escrituras en producción; deja que CI o la CLI de Supabase apliquen las migraciones.
Luego solo pide
Qué decir cuando esté conectado. Haz clic para copiar.
Pregunta a Cursor…Cursor
Conviene saber
Qué necesitas, qué no hace y cómo mantenerlo seguro.
Qué necesitas
- Una cuenta de Supabase y un proyecto de desarrollo
- Cursor o Claude Code
- Un repositorio de GitHub con la carpeta supabase/migrations
- La CLI de Supabase si aplicas migraciones en local
Límites
- El modo de solo lectura bloquea escrituras, así que el agente no puede probar la migración en la base de datos por ti.
- El contenido de las tablas puede incluir texto de inyección de prompts; revisa lo que hace el agente tras leer datos de usuarios.
- El agente solo ve el proyecto indicado, no tus otros entornos.
Mantenlo seguro
- Mantén el modo de solo lectura en proyectos de producción.
- Limita primero el servidor a un proyecto de desarrollo.
Preguntas frecuentes
Respuestas claras antes de empezar
¿Es seguro conectar el agente a mi base de datos?
Supabase recomienda conectar el servidor MCP a proyectos de desarrollo y usar el modo de solo lectura. Limítalo a un proyecto con project_ref y mantén la aprobación de herramientas en Cursor.
¿Qué plan de Supabase necesito?
El servidor MCP funciona con proyectos gratuitos y de pago. Funciones como branching dependen de tu plan.
¿Puede el agente aplicar migraciones?
Sin el modo de solo lectura dispone de la herramienta apply_migration. Esta configuración lo deja en solo lectura y envía las migraciones a revisión en GitHub.
¿Qué pasa con los datos de mis tablas?
Los resultados de las consultas entran en la conversación y llegan al proveedor del modelo. Usa un proyecto con datos de prueba o evita seleccionar columnas con datos personales.
Productos implicados
Los productos que intervienen
