Cómo conectar Tableau a Gemini vía MCP

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

Tableau + Gemini

Trabaja con Tableau Cloud y Tableau Server desde cualquier agente de IA: encuentra libros de trabajo, vistas y orígenes de datos, lee los datos de las vistas como CSV, imágenes, PDF y tablas cruzadas de Excel, consulta orígenes de datos publicados con el VizQL Data Service, sigue el linaje con la Metadata API y gestiona proyectos, etiquetas, miembros de grupos y actualizaciones de extracciones. Inicio de sesión 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:

TABLEAU_SERVER_URL, TABLEAU_PAT_NAME, TABLEAU_PAT_SECRET (opcional: TABLEAU_SITE)

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas un sitio de Tableau Cloud o Tableau Server 2024.2 o posterior, y un usuario de Tableau que pueda ver el contenido con el que debe trabajar la IA.

1. En Tableau abre tu Account Settings, sección Personal Access Tokens, escribe un nombre para el token y haz clic en Create Token. En Tableau Server puede que un administrador tenga que permitir antes los tokens de acceso personal.
2. Copia el nombre del token en TABLEAU_PAT_NAME y el secreto, que solo se muestra una vez, en TABLEAU_PAT_SECRET. Ambos distinguen mayúsculas y minúsculas.
3. Pon en TABLEAU_SERVER_URL la dirección sin ruta: en Tableau Cloud el host del pod que ves en el navegador, por ejemplo https://prod-useast-a.online.tableau.com, en Tableau Server su propia dirección, por ejemplo https://tableau.example.com.
4. Pon en TABLEAU_SITE la URL de contenido del sitio: la parte tras /site/ en la dirección del navegador (#/site/acme/home da acme). Para el sitio Default de un Tableau Server déjalo vacío.
5. Instala el conector y ejecuta tableau_get_current_session: muestra el sitio y el usuario y confirma el inicio de sesión. Su site.id es el site_id que necesita cada herramienta del sitio.

El conector inicia sesión con el token, reutiliza la sesión y vuelve a iniciarla cuando caduca. Tableau permite una sola sesión a la vez por token, así que no uses el mismo token en otra herramienta. Tableau Cloud revoca un token que no se ha usado durante 15 días; en ese caso crea uno nuevo.

De quién es el acceso: la IA solo ve y cambia lo que el usuario del token puede ver y hacer, con su rol en el sitio y sus permisos.

Qué lee: la versión del servidor y la versión más reciente de la REST API, los sitios y su configuración. Una búsqueda por palabras en libros de trabajo, vistas, orígenes de datos, proyectos, flujos, métricas, tablas y bases de datos. Proyectos, libros de trabajo con sus vistas y conexiones de datos, y vistas con su número de visitas. Lo que muestra un dashboard: los datos detrás de una vista como CSV, una imagen PNG que el modelo puede mirar, un PDF de una vista o de un libro de trabajo entero y la tabla cruzada como archivo de Excel, cada uno acotado con filtros de vista si hace falta. Orígenes de datos publicados con conexiones, certificación e información de la extracción, sus campos (tableau_read_datasource_metadata) y consultas sobre ellos con dimensiones, medidas agregadas, filtros y orden (tableau_query_datasource). El linaje mediante GraphQL en la Metadata API (tableau_metadata_query): qué libros de trabajo usan un origen de datos, bases de datos, tablas y columnas de origen, campos calculados, propietarios y avisos de calidad de datos. Usuarios, grupos y miembros de grupos, trabajos en segundo plano y tareas programadas de actualización de extracciones.

Qué escribe: actualiza ya las extracciones de un libro de trabajo o de un origen de datos publicado, ejecuta una tarea de actualización programada fuera de su horario, crea y modifica proyectos, cambia el nombre de un libro de trabajo o activa y desactiva sus pestañas, mueve un libro de trabajo a otro proyecto (sus permisos pueden seguir la configuración del proyecto de destino), añade etiquetas a libros de trabajo y orígenes de datos, y añade un usuario del sitio a un grupo local (los grupos de Active Directory se sincronizan desde el directorio). Una actualización devuelve un trabajo que la IA sigue con tableau_get_job.

Desactivadas al instalar: tableau_cancel_job, porque un trabajo cancelado no se puede reanudar y hay que iniciarlo de nuevo. Un administrador la activa cuando el equipo la necesita.

Formatos de datos: los id son LUID (UUID). Las listas llegan como {"pagination": {"pageNumber", "pageSize", "totalAvailable"}, "workbooks": {"workbook": [...]}}, y lo mismo para proyectos, vistas, orígenes de datos, usuarios, grupos y trabajos. Las horas son ISO 8601 en UTC. tableau_get_view_data devuelve texto CSV con una fila de cabecera y los números formateados como en la vista. tableau_query_datasource devuelve data como una lista de objetos cuya clave es el título del campo con la función, por ejemplo SUM(Sales). Los filtros de vista llevan el prefijo vf_ y el nombre del campo tal como aparece en la vista, por ejemplo {"vf_Region": "West"}, con varios valores separados por comas. El finishCode de un trabajo es 0 si tuvo éxito, 1 si falló y 2 si se canceló.

Paginación, filtros y orden: las herramientas de listado aceptan page_size (hasta 1000) y page_number; la IA sigue mientras pageNumber * pageSize sea menor que totalAvailable. tableau_search_content pagina con limit y page, y la respuesta incluye el total. filter tiene la forma field:operator:value, varias condiciones unidas por comas, por ejemplo projectName:eq:Finance,updatedAt:gt:2026-01-01T00:00:00Z; in acepta [a,b]. sort es field:asc o field:desc.

Requisitos: tableau_read_datasource_metadata y tableau_query_datasource necesitan Tableau Cloud o Tableau Server 2025.1 con el VizQL Data Service activado, y la capacidad API Access en el origen de datos. tableau_metadata_query necesita la Metadata API, activada por defecto en Tableau Cloud y habilitada por un administrador en Tableau Server. tableau_search_content necesita Tableau Cloud o Tableau Server 2022.3 o posterior.

Errores comunes: Tableau responde con {"error": {"code", "summary", "detail"}}. 401 (códigos 401001 y 401002) indica un token erróneo o caducado o una URL de contenido del sitio incorrecta. 403 indica que el usuario del token no tiene el permiso. 404 es un id erróneo o un site_id de otro sitio; al iniciar sesión significa que TABLEAU_SERVER_URL es incorrecta (solo esquema y host) o que el servidor es anterior a 2024.2. 400 es un filtro o parámetro no válido, y 409 un nombre duplicado o una actualización que ya está en cola.

El conector no publica, descarga ni elimina libros de trabajo ni orígenes de datos, no elimina proyectos, no añade usuarios al sitio ni cambia roles del sitio, y no quita etiquetas ni miembros de grupos.

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 muestra YOUR_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" }
    }
  }
}

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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Tableau.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué libros de trabajo del proyecto Finance se modificaron en los últimos 30 días y quién es su propietario?"
• "Muéstrame las cifras detrás del dashboard Sales Overview, filtradas por la región West."
• "En el origen de datos Superstore, ¿cuáles fueron las ventas totales por región en el primer semestre de 2026?"
• "¿Qué libros de trabajo usan el origen de datos publicado Orders? Quiero saber qué se rompe si lo cambiamos."
• "¿Salieron bien las actualizaciones de extracciones de anoche? Muéstrame las que fallaron con el texto del error."

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

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