Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Supabase con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Deja que tu IA se ocupe de tus proyectos de Supabase: lista los proyectos y comprueba su estado, explora esquemas y tablas, ejecuta SQL de solo lectura, lee logs, asesores de seguridad y rendimiento, Edge Functions, migraciones, ramas y buckets de Storage. A través de la Management API con un token de acceso personal.
Prueba a pedir
Prompts de ejemplo para Supabase
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Supabase, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Supabase + Gemini
Deja que tu IA se ocupe de tus proyectos de Supabase: lista los proyectos y comprueba su estado, explora esquemas y tablas, ejecuta SQL de solo lectura, lee logs, asesores de seguridad y rendimiento, Edge Functions, migraciones, ramas y buckets de Storage. A través de la Management API con un token de acceso personal.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
SUPABASE_ACCESS_TOKEN
Paso 1 — Obtener credenciales
- En el panel de Supabase, abre el menú de la cuenta → Account preferences → Access Tokens (o ve directamente a https://supabase.com/dashboard/account/tokens) y haz clic en Generate new token.
- Mejor un scoped token: elige la organización y los proyectos que la IA puede ver y da a cada capacidad Read (o Read-write solo donde deba cambiar algo). Las herramientas de aquí usan Projects, Project Settings, Database, Migrations, Backups, Edge Functions, API Keys (no API Key Secrets), Logs, Usage Analytics, Advisors, Storage, Development Branches y Organizations.
- Fija una caducidad (como máximo un año) y copia el token. Empieza por
sbp_y Supabase lo muestra una sola vez. - Pega el token en
SUPABASE_ACCESS_TOKEN, sin la palabra Bearer, e instala el conector. - Empieza con
supabase_list_projects: lista cada proyecto al que llega el token, con su estado y su ref. El ref (las 20 letras minúsculas dehttps://<ref>.supabase.co) es lo que piden todas las demás herramientas.
Cambiar el acceso más adelante: los permisos de un token no se pueden cambiar después de crearlo. Para ampliarlos o reducirlos, crea un token nuevo y borra el antiguo. Un token heredado (sin scopes) tiene en cambio todo tu acceso a todas las organizaciones.
Solo lectura: da a un scoped token solo Read en cada capacidad. Con Database en Read, incluso supabase_execute_sql ejecuta su SQL en modo de solo lectura. Ninguna otra herramienta cambia datos: las preguntas del día a día pasan por supabase_run_read_only_sql, que ejecuta una sentencia como usuario de base de datos de solo lectura y recorta los resultados de más de 200 KB.
Desactivadas al instalar: supabase_execute_sql. Ejecuta SQL como postgres con todos los permisos, así que DDL, escrituras y grants se aplican al instante y no se pueden deshacer. Actívala solo si la IA debe cambiar la base de datos; te muestra cada sentencia y espera tu confirmación. Para cambios de esquema que deben quedar en el control de versiones, tu propio flujo de migraciones es el mejor sitio.
La vista del propietario del proyecto: el conector trabaja con la Management API de Supabase, no como usuario de la app, así que no pasa por la REST API del proyecto ni por la row level security. supabase_list_api_keys nombra cada clave pero solo muestra el valor de las públicas; las secret keys y la antigua clave service_role se listan sin valor a propósito, y ninguna herramienta las revela. Tampoco se descarga el código de las Edge Functions.
Proyectos en pausa: los proyectos Free se pausan tras una semana sin actividad y muestran el estado INACTIVE. Las herramientas de base de datos fallan hasta que restauras el proyecto en el panel. Cuando una app dé errores, ejecuta primero supabase_get_project_health.
Logs y asesores: sin un intervalo de tiempo, supabase_query_logs solo busca en el último minuto; un intervalo puede abarcar como máximo 24 horas y debe estar dentro de la retención de logs de tu plan (1 día en Free, 7 en Pro, 28 en Team). supabase_get_security_advisors y supabase_get_performance_advisors ejecutan las mismas comprobaciones que la página Advisors del panel; corrige primero los hallazgos ERROR, sobre todo las tablas expuestas sin row level security. Las ramas de vista previa (supabase_list_branches) necesitan un plan de pago.
Límites: Supabase permite 120 solicitudes a la Management API por minuto por usuario y endpoint (todos los tokens de un usuario comparten el límite) y 30 por minuto para logs y datos de uso. Por encima responde 429 durante el resto del minuto: espera un minuto y vuelve a intentarlo.
Errores frecuentes: 401 "Invalid access token" significa que el token es incorrecto, caducó o se borró: crea uno nuevo en Access Tokens. 403 significa que el token no puede hacer eso: un scoped token indica en missing_permissions lo que le falta, así que crea un token nuevo que lo incluya. 404 es un ref de proyecto desconocido, o un proyecto fuera de las organizaciones del token. 402 en los logs significa que se agotó la cuota de uso de la organización. Una sentencia SQL que falla vuelve con el mensaje de Postgres, por ejemplo "relation "orders" does not exist" cuando una tabla no lleva su esquema (public.orders).
El conector no crea, pausa, restaura ni borra proyectos, no despliega Edge Functions, no gestiona secretos, configuración de autenticación, dominios personalizados, restricciones de red ni facturación, y no lee las tablas de tu app a través de PostgREST.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en Gemini
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
Supabase.
Herramientas disponibles
| Tool | What it does |
|---|---|
supabase_list_projects | List every project the token can reach: ref, name, organization_slug, region, status (ACTIVE_HEALTHY, INACTIVE when paused, COMING_UP… |
supabase_list_organizations | List the organizations the token can reach, with their slug and name |
supabase_get_organization | Get one organization by slug, including its plan (free, pro, team, enterprise) |
supabase_get_project | Get one project: name, ref, organization, region, status, created_at and database host and Postgres version |
supabase_get_project_health | Check the health of a project's services: for each one name, status (ACTIVE_HEALTHY, COMING_UP, UNHEALTHY) and error or info |
supabase_run_read_only_sql | Run one SQL statement as the read-only database user and return the rows as JSON objects |
supabase_execute_sql | Run SQL with full rights (as postgres): DDL, inserts, updates, deletes, grants |
supabase_list_schemas | List the database's schemas with their owner and number of tables, leaving out Postgres' own (pg_*, information_schema) |
supabase_list_tables | List the tables, views and materialized views of one or more schemas: schema, name, kind, whether row level security is on, estimated row… |
supabase_describe_table | Describe one table or view: columns (name, type, nullable, default, comment), constraints (primary key, foreign keys, unique, check, with… |
supabase_list_extensions | List the Postgres extensions installed in the database: name, version and schema (on Supabase usually extensions) |
supabase_list_migrations | List the migrations recorded for the database (by the Supabase CLI or the dashboard): version (timestamp) and name, oldest first |
supabase_list_backups | List the project's database backups: whether point-in-time recovery is on, and each backup's status and time |
supabase_generate_typescript_types | Generate TypeScript types for the database schema, as the Supabase CLI does: one string with a Database type covering tables, views… |
supabase_list_edge_functions | List the project's Edge Functions: slug, name, status, version, verify_jwt, entrypoint path and when they were created and updated (epoch… |
supabase_get_edge_function | Get one Edge Function by slug: status, version, verify_jwt, entrypoint and import map paths, created and updated times |
supabase_list_api_keys | List the project's API keys: id, name, type (publishable, secret or legacy), prefix and description |
supabase_query_logs | Query the project's logs with SQL (ClickHouse dialect) over one unified logs table: filter on source (edge_logs, postgres_logs, auth_logs… |
supabase_get_api_usage | Get request counts per time bucket for the project's REST, Auth, Storage and Realtime APIs over a recent interval |
supabase_get_security_advisors | Run the security advisor (database linter) on the project: findings such as tables without row level security, exposed auth.users, mutable… |
supabase_get_performance_advisors | Run the performance advisor on the project: findings such as unindexed foreign keys, unused or duplicate indexes, RLS policies that… |
supabase_list_branches | List the project's preview branches (branching, a paid feature): id, name, project_ref of the branch, git_branch, pr_number, is_default… |
supabase_get_branch | Get one preview branch of a project by its name: its own project ref, git branch, pull request number, status and whether it is persistent |
supabase_list_storage_buckets | List the project's Storage buckets: id, name, owner, whether public, and created and updated times |
Ejemplos de prompts
- "¿Cuáles de mis proyectos de Supabase no están sanos ahora mismo y qué les pasa?"
- "Ejecuta el asesor de seguridad en el proyecto Acme Shop y dime qué tablas están expuestas sin row level security."
- "¿Cuántos pedidos se crearon cada día la semana pasada en public.orders del proyecto Acme Shop?"
- "Muéstrame los errores de Postgres de la última hora en los logs de Acme Shop y explícame qué los causó."
FAQ
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Siguientes pasos
¿Te ha sido útil esta guía?
