Servidor MCP de Supabase: conéctalo de forma segura en cinco minutos

Servidor MCP de Supabase

Servidor MCP de Supabase: configuración, solo lectura y seguridad | We.Inc

Conecta una herramienta de programación con IA a Supabase con el servidor MCP oficial: la URL del servidor, las opciones read_only y project_ref, los grupos de funciones, las herramientas y los consejos de seguridad.

El servidor MCP de Supabase permite que un asistente de programación con IA lea tus tablas, ejecute SQL, revise logs y despliegue funciones a través de un único enlace: https://mcp.supabase.com/mcp. Añade ?read_only=true para que las consultas no puedan cambiar datos y ?project_ref= para que solo pueda acceder a un proyecto, y sigue aprobando cada llamada a herramienta a mano.

Opciones de URL documentadas por Supabase

Opción
Qué hace

read_only=true
Ejecuta cada consulta como un usuario de Postgres de solo lectura

project_ref=<id>
Limita el acceso a un proyecto y desactiva las herramientas de cuenta

features=database,docs
Activa solo los grupos de herramientas indicados; storage está desactivado por defecto

URL local

MCP, el Model Context Protocol, es una forma estándar de que una app de IA use herramientas externas. Crea abajo tu enlace de conexión: elige un proyecto, el modo de solo lectura y los grupos de herramientas, y copia la configuración. Nada sale de tu navegador.

Busca el ID de referencia de tu proyecto en los ajustes del proyecto en el panel de Supabase.
Crea el enlace con las opciones que quieras y pega el JSON en el archivo de ajustes de tu cliente MCP.
La primera vez, el cliente abre una ventana del navegador: inicia sesión en Supabase, elige la organización y permite el acceso.
Para CI o una máquina sin navegador, crea un token de acceso personal con alcance limitado y envíalo como cabecera Authorization: Bearer.

Apúntalo a un proyecto de desarrollo, no a tu tienda en producción. Supabase recomienda conectar a producción solo cuando la tarea realmente lo necesite.
Cuidado con la inyección de prompts: el texto guardado en tus tablas, como un ticket de soporte, puede llevar instrucciones que engañen al asistente para que ejecute una consulta dañina.
Úsalo como herramienta para tus propios desarrolladores. Supabase dice que lleva tus permisos y no debe darse a los clientes.
Para tareas desatendidas, permite solo herramientas de solo lectura limitadas a un proyecto y haz que la tarea informe en lugar de escribir.
Usa branching para probar cambios de esquema lejos de producción. Supabase marca las herramientas de branching como experimentales y solo para planes de pago.

Preguntas frecuentes

¿Qué puede hacer el servidor MCP de Supabase?

Sus herramientas documentadas listan tablas y migraciones, aplican migraciones, ejecutan SQL, consultan logs, leen los asesores de seguridad y rendimiento, generan tipos de TypeScript, gestionan Edge Functions, buscan en la documentación y, si no está limitado, gestionan proyectos.

¿El modo de solo lectura es lo bastante seguro?

Impide escrituras porque las consultas se ejecutan como un usuario de base de datos de solo lectura, pero el asistente puede seguir leyendo todo lo que ese usuario puede leer. Combínalo con project_ref y deja los datos personales fuera de lo que preguntes.

¿Necesito un token de acceso?

No con el inicio de sesión predeterminado del servidor alojado, que usa un login en el navegador. Un token de acceso personal solo hace falta para CI o configuraciones sin interfaz, y no todos los clientes admiten cabeceras personalizadas.

¿Qué grupos de funciones existen?

El código del servidor enumera docs, account, database, debugging, development, functions, branching, storage y notebooks. La documentación de Supabase dice que todos los grupos salvo storage están activados por defecto.

¿Pueden usarlo los visitantes de mi web?

No. Funciona con tus permisos de desarrollador, así que Supabase recomienda mantenerlo como herramienta interna y no como algo a lo que accedan los usuarios finales.

Qué cubre cada grupo de herramientas

database: list_tables, list_extensions, list_migrations, apply_migration y execute_sql. debugging: query_logs y get_advisors. development: get_project_url, get_publishable_keys y generate_typescript_types.
functions cubre listar, leer y desplegar Edge Functions, además de definir sus secretos. docs tiene search_docs. account contiene herramientas de proyecto y organización, como create_project y pause_project, y se desactiva cuando limitas el acceso a un proyecto.

Una configuración inicial segura

Limitada a un proyecto, de solo lectura y solo con las herramientas database y docs. Pon tu propio ID de referencia.

Conexión limitada y de solo lectura

La mayoría de los clientes leen un objeto mcpServers como este; el nombre del archivo depende del cliente.

Generador de conexión

ID de referencia del proyecto (opcional, pero recomendado)

la ref de tu proyecto

Modo de solo lectura

Grupos de herramientas

Enlace del servidor

JSON de configuración (por ejemplo .cursor/mcp.json)

Copiar

Copiado

Elige al menos un grupo de herramientas.

El grupo account se ignora cuando defines una referencia de proyecto.

Empieza gratis · Sin tarjeta de crédito

Servidor MCP de Supabase: conéctalo de forma segura en cinco minutos