Cómo conectar Metabase a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Metabase, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Metabase + Cursor

Trabaja con Metabase, autoalojado o Metabase Cloud, desde cualquier agente de IA: busca y ejecuta preguntas guardadas y tarjetas de dashboards, lanza consultas SQL o MBQL, lee metadatos de bases de datos, tablas y campos, explora colecciones y crea o modifica preguntas, dashboards y colecciones. Clave de API con los permisos de un grupo de Metabase.

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:

METABASE_URL, METABASE_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una instancia de Metabase (autoalojada o Metabase Cloud) y un administrador que pueda crear una clave de API.

1. Pon en METABASE_URL la dirección con la que abres Metabase, por ejemplo https://metabase.example.com o https://yourcompany.metabaseapp.com, sin /api y sin barra final.
2. Como administrador abre Admin settings, Settings, Authentication, API keys, haz clic en Create API key y dale un nombre y un grupo. La clave actúa con los permisos de ese grupo: para leer basta con acceso de visualización a las colecciones y acceso de consulta a las bases de datos que quieras; para crear y cambiar contenido hace falta acceso curate. Las lecturas solo para administradores, como metabase_list_users, necesitan el grupo Administrators.
3. Copia la clave (se muestra una sola vez) en METABASE_API_KEY. Se envía en la cabecera x-api-key.
4. Instala el conector y ejecuta metabase_get_current_user: muestra la cuenta con la que actúa la clave y confirma dirección y clave.

Qué lee: contenido mediante metabase_search (preguntas, modelos, métricas, dashboards, colecciones, tablas, bases de datos, segmentos y, si quieres, el texto SQL de las preguntas nativas o la papelera), las colecciones y su contenido, preguntas guardadas, modelos y métricas con la consulta que hay detrás, dashboards con pestañas, filtros y tarjetas, y los elementos recientes y más populares. Las bases de datos conectadas a Metabase con esquemas, tablas y campos (los datos de conexión quedan fuera) y los valores en caché de los campos de categoría para los filtros. Personas y grupos de permisos.

Qué ejecuta: metabase_run_card ejecuta una pregunta guardada o un modelo, con parameters para sus filtros; metabase_run_dashboard_card ejecuta una tarjeta de un dashboard con los valores de filtro del dashboard. metabase_run_native_query ejecuta SQL en el dialecto de la base de datos, con variables {{name}} mediante template_tags y parameters; metabase_run_query ejecuta una consulta MBQL construida con ids de tablas y campos. No se guarda nada. La IA responde primero con preguntas guardadas y escribe consultas ad hoc solo cuando ninguna encaja.

Qué escribe: metabase_create_card guarda una nueva pregunta, modelo o métrica en una colección o dentro de un dashboard, metabase_update_card la modifica, metabase_create_dashboard crea un dashboard vacío y metabase_update_dashboard cambia nombre, filtros, pestañas o tarjetas. Su lista dashcards reemplaza todas las tarjetas, así que la IA lee antes el dashboard, conserva las tarjetas existentes con sus ids y añade las nuevas con un id negativo en la cuadrícula de 24 columnas. metabase_create_collection y metabase_update_collection crean, renombran y mueven colecciones.

Desactivadas al instalar: ninguna, todas las herramientas están activas. No hay herramientas de borrado: archivar una pregunta, un dashboard o una colección con las herramientas de actualización la mueve a la papelera, desde donde se restaura con archived false.

Formatos de datos: los resultados de las consultas llegan como data.cols (name, display_name, base_type como type/Integer o type/DateTime) y data.rows (arrays en el orden de las columnas), con row_count. Las fechas son ISO 8601 en la zona horaria de informes de la instancia. Los ids de bases de datos, tablas, campos, preguntas y dashboards son enteros; la colección superior es root. El type de una tarjeta es question, model o metric; en la búsqueda y en el contenido de las colecciones un modelo aparece como dataset.

Paginación: metabase_search, metabase_list_collection_items y metabase_list_users aceptan limit y offset y devuelven total. Las demás listas lo devuelven todo de una vez. metabase_get_database_metadata puede ser muy grande en bases de datos extensas; metabase_list_schema_tables y metabase_get_table_metadata son más ligeras.

Límites: las herramientas de consulta devuelven como máximo 2.000 filas, el límite de la API para resultados ad hoc, así que la IA agrega o filtra en la consulta en lugar de recorrer filas en bruto. Una consulta nativa usa la conexión a la base de datos de Metabase: para bases de datos que nunca deben cambiar, configura en Metabase un usuario de base de datos de solo lectura.

Errores comunes: una consulta fallida vuelve con status: failed y el mensaje de la base de datos en error, y se notifica como llamada fallida. 401 significa una clave errónea o eliminada. 403 significa que al grupo de la clave le falta el permiso (acceso a datos, curate o admin). 404 es un id erróneo o una dirección sin rutas /api: revisa METABASE_URL.

El conector no borra contenido de forma definitiva, no cambia usuarios, grupos ni permisos y no crea ni edita conexiones a bases de datos.

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 Cursor

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 muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 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.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Metabase.

Herramientas disponibles

Ejemplos de prompts

• "Busca la pregunta guardada sobre los ingresos mensuales y ejecútala para los últimos 12 meses."
• "¿Qué dashboards son los más vistos en nuestro Metabase? Enuméralos con su colección."
• "Ejecuta las tarjetas del dashboard Sales overview con el filtro de región en EMEA y resume las cifras."
• "Escribe una consulta SQL sobre la tabla orders que cuente los pedidos por país de este año y enséñame el resultado."
• "Guarda la consulta que acabas de ejecutar como pregunta con gráfico de barras en la colección Marketing."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot