Tableau MCP MCP — Casos de uso, Instalar & Demo ao vivo

Name: Tableau MCP MCP Server
Author: tableau

Por que usar

Principais recursos

Editor oficial do Tableau — rastreia as APIs REST e VizQL do Tableau
Autenticação baseada em PAT com escopo de site + servidor
Consultar fontes de dados publicadas por meio do VizQL gerado pelo agente
Procure projetos, pastas de trabalho e visualizações programaticamente
Renderizar imagens de visualização para inclusão direta em bate-papo ou documentos

Demo ao vivo

Como fica na prática

tableau-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tableau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ],
      "env": {
        "SERVER": "https://your-server.tableau.com",
        "SITE_NAME": "your-site",
        "PAT_NAME": "claude-agent",
        "PAT_VALUE": "<personal-access-token>"
      }
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "tableau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ],
      "env": {
        "SERVER": "https://your-server.tableau.com",
        "SITE_NAME": "your-site",
        "PAT_NAME": "claude-agent",
        "PAT_VALUE": "<personal-access-token>"
      }
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "tableau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ],
      "env": {
        "SERVER": "https://your-server.tableau.com",
        "SITE_NAME": "your-site",
        "PAT_NAME": "claude-agent",
        "PAT_VALUE": "<personal-access-token>"
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tableau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ],
      "env": {
        "SERVER": "https://your-server.tableau.com",
        "SITE_NAME": "your-site",
        "PAT_NAME": "claude-agent",
        "PAT_VALUE": "<personal-access-token>"
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "tableau-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@tableau/mcp-server@latest"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "tableau-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@tableau/mcp-server@latest"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add tableau-mcp -- npx -y @tableau/mcp-server@latest

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Tableau MCP

Responder a uma pergunta comercial em uma fonte de dados publicada

👤 Analistas e pessoal de operações que vivem no chat ⏱ ~10 min beginner

Quando usar: Você tem uma pergunta que um painel do Tableau poderia responder, mas não deseja abrir o Tableau Desktop.

Pré-requisitos

Conta do Tableau Cloud ou Server — Peça acesso ao seu administrador, caso ainda não o tenha
Token de acesso pessoal — Configurações da minha conta → Tokens de acesso pessoal → Criar token

Fluxo

Encontre a fonte de dados

Liste as fontes de dados publicadas nas 'operações' do site.✓ Copiado

→ Matriz de fontes de dados com nomes e IDs
Faça a pergunta

Na fonte de dados 'orders_fact', quais foram os 10 principais produtos por receita no último trimestre?✓ Copiado

→ Campos de referência de resposta numérica que existem na fonte de dados

Resultado: Uma resposta concreta baseada em seus dados gerenciados do Tableau.

Armadilhas

Perguntando sobre campos que não estão na fonte de dados publicada — Deixe o agente listar os metadados primeiro e depois pergunte

Combine com: bigquery-server · postgres

Incorporar uma imagem de exibição do Tableau em um documento de relatório

👤 PMs e analistas escrevendo relatórios semanais ⏱ ~5 min beginner

Quando usar: Você deseja a visualização mais recente de um gráfico do Tableau dentro de um Notion ou Google Doc.

Pré-requisitos

O URL de visualização ou seu site/pasta de trabalho/caminho de visualização — Copiar da interface do Tableau

Fluxo

Busque a imagem

Obtenha um PNG da visualização 'Receita Semanal' da pasta de trabalho 'Exec Scorecard'.✓ Copiado

→ Imagem retornada in-line
Cole

Anexe-o ao relatório no Notion com uma legenda curta.✓ Copiado

→ A imagem aparece onde você deseja

Resultado: Visualize imagens sempre atualizadas, sem etapa de captura de tela.

Armadilhas

Filtros no URL se perdendo — Passe parâmetros de filtro explicitamente na chamada da ferramenta

Combine com: notion

Auditar pastas de trabalho para propriedade e desatualização

👤 Equipes de governança de plataforma/dados ⏱ ~25 min intermediate

Quando usar: Você está limpando um site barulhento antes de uma revisão de acesso.

Fluxo

Listar todas as pastas de trabalho com proprietário + data da última visualização

Enumere pastas de trabalho nas 'operações' do site com proprietário, last_viewed e projeto.✓ Copiado

→ Tabela de pastas de trabalho classificáveis por tempo recente
Sinalize os mortos

Marque pastas de trabalho não visualizadas há mais de 180 dias como candidatas a arquivamento.✓ Copiado

→ Lista filtrada que você pode entregar aos proprietários

Resultado: Uma lista concreta para arquivar, apoiada por dados reais de uso.

Combine com: linear

Comparar um número do Tableau com o do warehouse diretamente

👤 Engenheiros de dados depurando discrepâncias ⏱ ~20 min intermediate

Quando usar: Seu painel discorda da planilha da equipe financeira e você deseja descobrir onde.

Fluxo

Leia a resposta do Tableau

Qual foi a receita do mês passado, segundo o Tableau?✓ Copiado

→ Número único + fonte de dados + extração/informações ao vivo
Execute a mesma agregação no warehouse

Execute o SQL equivalente no BigQuery e no diff.✓ Copiado

→ Ambos os números lado a lado + explicação delta

Resultado: Você encontra o desvio (extrair obsolescência? filtrar? juntar?) rapidamente.

Armadilhas

Comparando com extrato ao vivo e extrato sem notar — O agente deve imprimir o tipo de fonte de dados antes do número

Combine com: bigquery-server

Combinações

Combine com outros MCPs para 10× de alavancagem

tableau-mcp + bigquery-server

Reconciliar uma métrica do Tableau com o SQL do warehouse

Extraia o valor do Tableau e a resposta SQL do warehouse e compare-os.✓ Copiado

tableau-mcp + postgres

Mesmo fluxo de trabalho em um banco de dados operacional

Verifique por que o extrato requests_fact discorda da tabela de pedidos ativos hoje.✓ Copiado

tableau-mcp + notion

Incorporar imagens de visualização ao vivo em relatórios semanais

Coloque o PNG de receita semanal mais recente no topo do relatório Notion.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_datasources	site?: str	Descubra quais dados são publicados antes de fazer perguntas	1 API call
query_datasource	datasource_id: str, question: str	Responda a uma pergunta sobre dados em linguagem natural	1 API call + VizQL
list_workbooks	site?: str, project?: str	Procure ou audite o inventário da pasta de trabalho	1 API call
get_view_image	view_id: str, filters?: map	Incluir a imagem do gráfico em um documento ou resposta	1 API call
list_views	workbook_id: str	Enumerar gráficos dentro de uma pasta de trabalho	1 API call

Custo e limites

O que custa rodar

Cota de API: Limitado aos limites da API REST do Tableau Cloud/Server
Tokens por chamada: Pequeno para metadados; visualizar imagens são bytes, não tokens
Monetário: Gratuito — sua licença do Tableau já cobre isso
Dica: Resultados de list_workbooks / list_datasources em cache para auditorias; o inventário não muda a cada minuto.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: PAT_VALUE pertence a env vars; nunca cometa isso. Gire na UI do Tableau se houver vazamento.

Saída de dados: Todo o tráfego vai para o URL configurado do Tableau SERVER. Nenhuma chamada de terceiros.

Um PAT com permissões amplas dá aos agentes acesso a tudo o que o proprietário do token vê – fornecendo um usuário dedicado e com menos privilégios para uso do agente.
As imagens de visualização podem conter dados confidenciais. Trate a saída da ferramenta como qualquer outra saída de dados do Tableau.

Solução de problemas

Erros comuns e correções

401/Falha no login

PAT expirou ou incompatibilidade de site. Gere novamente o PAT e confirme se SITE_NAME corresponde ao segmento de URL do site.

Verificar: Log into Tableau and look at the URL: /site/<SITE_NAME>/...

Fonte de dados não encontrada

Pode ser inédito ou estar em um projeto diferente. Chame list_datasources para ver o que está visível para o token.

Verificar: list_datasources with no filter

Ver devoluções de imagens proibidas

O proprietário do PAT não tem permissões de visualização nessa pasta de trabalho. Faça com que o administrador conceda leitura.

Verificar: Open the view URL in a browser with the same user

Alternativas

Tableau MCP vs. outros

Alternativa	Quando usar	Troca
bigquery-server	Você deseja SQL de armazém bruto, não fontes de dados semânticas governadas	Mais poder, sem métricas de propriedade do Tableau
postgres	Sua fonte de verdade é o Postgres operacional, não uma ferramenta de BI	Sem camada VizQL

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills