# Que Cursor gestione tu proyecto de Supabase

> Saltar del editor al panel para revisar tablas, logs y migraciones rompe la concentración.

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.

## Pasos

1. **Añ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.
2. **Empieza 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.
3. **Pregunta 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.
4. **Haz 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.

## Prompts para probar

- Enumera las tablas del esquema public con su número de filas y si tienen RLS activado.
- ¿Por qué es lenta esta consulta sobre orders? Ejecuta EXPLAIN y sugiere un índice.
- Muéstrame los últimos 50 logs de error del servicio de API.
- Escribe una migración que añada a projects una columna archived_at de tipo timestamp que admita nulos y guárdala en supabase/migrations.
- Revisa los advisors de seguridad y enumera las tablas sin RLS.

## 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.

## Notas de seguridad

- Mantén el modo de solo lectura en proyectos de producción.
- Limita primero el servidor a un proyecto de desarrollo.

## Servidores MCP

- [Supabase MCP Server](https://github.com/supabase-community/supabase-mcp): database-read, database-write, project-admin
- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write

## Preguntas frecuentes

**¿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.

## Herramientas

- **[Supabase](https://suiteintent.com/t/supabase?m=ES)**: Postgres alojado con autenticación y almacenamiento. · Ideal para: Un backend para una app hecha con IA · Plan gratis
- **[GitHub](https://suiteintent.com/t/github?m=ES)**: Alojamiento de código, incidencias y pull requests. · Ideal para: Equipos que revisan código con pull requests · Plan gratis · 10000