MCP de Supabase: conecta tu base de datos con IA

Conecta tu base de datos de Supabase con asistentes de IA y tu IDE de forma segura usando el Model Context Protocol (MCP). Esta integración te permite obtener datos, ejecutar consultas y acceder a funciones sin escribir código manual, ampliando tu backend con una capa universal para datos, lógica y herramientas externas.

¿Qué es el MCP de Supabase y para qué sirve?

El MCP es un estándar que conecta herramientas de inteligencia artificial con tu backend de Supabase: base de datos, storage y funciones, con reglas claras y seguras. No reemplaza tu backend, lo expande con acceso estructurado a datos y operaciones. Así, puedes consultar documentación, listar proyectos y organizaciones, gestionar costos o operar tablas directamente desde el IDE o asistentes de IA, sin entrar a la interfaz gráfica.

¿Cómo se integra con tu IDE y asistentes de IA?

• Está disponible como MCP oficial para varios IDE.
• Puedes instalarlo desde el marketplace de MCP y usarlo también vía CLI.
• En Windsurf, la conexión es directa: instalas el MCP, añades tu access token y listo.
• Tras la instalación, tu IDE y agentes de IA quedan conectados a tu proyecto para ejecutar herramientas predefinidas.

¿Qué herramientas expone el MCP en Supabase?

• search docs: consulta directa a la documentación de Supabase.
• Organizaciones: listar y obtener detalles.
• Proyectos: listar, obtener, crear, pausar y restaurar.
• Costos: estimar costo de nuevo proyecto o branch y confirmar costos.
• Tablas: acceso directo a tablas de la base de datos y sus columnas.
• Edge Functions: listar funciones.
• Branches: consultar las branches disponibles.
• En el ejemplo mostrado, el entorno expone 29 herramientas disponibles desde el agente del IDE.

¿Cómo instalar y autenticar el mcp paso a paso?

Para usarlo en Windsurf, el flujo es simple y seguro.

• Abrir el marketplace de MCP e instalar el conector oficial de Supabase.
• El sistema solicita un access token de Supabase.
• Ir al dashboard de Supabase: generar un nuevo token, nombrarlo, por ejemplo, suplatseigram MCP.
• Configurar caducidad: treinta días.
• Copiar el token de una sola vista y guardarlo en un lugar seguro.
• Volver al IDE: pegar el token y guardar.
• Confirmar conexión: el agente reporta el MCP de Supabase activo con 29 herramientas.

¿Qué puedes consultar después de conectar?

• Pedir: lista los proyectos que tengo en Supabase.
• Respuesta típica con datos clave del proyecto: nombre suplatseigram, id, región, estado, versión de PostgreSQL, fecha de creación y dirección de la base.
• Pedir: lista las tablas del proyecto suplatseigram.
• Muestra tablas como posts, post_new, profile, likes y comments, con sus columnas.
• Estado de seguridad: solo comments tiene RLS habilitado, las demás sin políticas de seguridad a nivel de fila.
• También puedes consultar Edge Functions y branches sin salir del IDE.

Habilidades desarrolladas en este flujo: - Generar y gestionar un access token con caducidad. - Conectar un MCP desde el marketplace del IDE. - Listar proyectos y tablas y leer metadatos clave. - Interpretar RLS: detectar qué tablas exponen datos sin políticas de seguridad a nivel de fila.

¿Qué buenas prácticas y precauciones debes aplicar?

Aunque el MCP aporta flexibilidad y velocidad, es clave usarlo con responsabilidad.

• Definir permisos claros antes de exponer herramientas.
• Activar y revisar RLS donde corresponda: evita exponer tablas sin políticas.
• Controlar el alcance y la caducidad del access token: si necesitas verlo de nuevo, genera uno nuevo y revoca el anterior.
• Mantener separadas las operaciones críticas y validar costos antes de confirmar acciones sobre proyectos o branches.

¿Tienes dudas sobre cómo integrarlo en tu flujo o qué herramientas habilitar primero? Comparte tus preguntas y experiencias.