Metabase a MCP: preguntas guardadas, dashboards, consultas SQL y MBQL y colecciones en cualquier agente de IA

💡 ¿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

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.

Configuración

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.

Requisitos previos: METABASE_URL, METABASE_API_KEY

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige Metabase e introduce las variables listadas en los Requisitos previos.

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

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT