Tableau Cloud

Servidor MCP Tableau Cloud 2.0

Um servidor MCP (Model Context Protocol) abrangente para administração do Tableau Cloud, construído com TypeScript. Este servidor fornece ferramentas de nível empresarial com cobertura completa da API do Tableau Cloud, registro estruturado e arquitetura pronta para produção.

Recursos

• Cobertura Completa da API: Mais de 50 ferramentas cobrindo todos os aspectos da administração do Tableau Cloud
• Arquitetura Empresarial: TypeScript com segurança total de tipos, registro estruturado e tratamento de erros
• Pronto para Produção: Suporte a Docker, configuração abrangente e opções de implantação profissionais
• Padrões Oficiais do MCP: Construído seguindo os padrões oficiais de implementação do MCP da Tableau
• Administração Abrangente: Usuários, grupos, pastas de trabalho, fontes de dados, projetos, permissões e muito mais

Início Rápido

Pré-requisitos

• Node.js 20 ou superior
• Site do Tableau Cloud com acesso à API
• Token de Acesso Pessoal com permissões de Administrador do Site

Instalação

# Install dependencies
npm install

# Build the project
npm run build

Configuração

1. Copie o modelo de ambiente:

cp .env.example .env

2. Edite .env com suas credenciais do Tableau Cloud:

SERVER=https://your-site.online.tableau.com
PAT_NAME=your-personal-access-token-name  
PAT_VALUE=your-personal-access-token-value
SITE_NAME=your-site-name

3. Atualize config.json para o Claude Desktop:

{
  "mcpServers": {
    "tableau-cloud": {
      "command": "node",
      "args": ["./build/index.js"],
      "env": {
        "SERVER": "https://your-site.online.tableau.com",
        "PAT_NAME": "your-pat-name",
        "PAT_VALUE": "your-pat-value",
        "SITE_NAME": "your-site-name"
      }
    }
  }
}

Uso

Execute o servidor:

node build/index.js

Ou use com o MCP Inspector:

npm run inspect

Ferramentas Disponíveis

Gerenciamento de Usuários

• create-user - Criar novos usuários com funções especificadas
• search-users - Listar e filtrar usuários por vários critérios

Gerenciamento de Conteúdo

• list-workbooks - Listar e filtrar pastas de trabalho publicadas
• list-datasources - Listar e filtrar fontes de dados publicadas
• create-project - Criar novos projetos com configurações de permissão

Em Breve

• Ferramentas adicionais de usuário (atualizar, excluir, obter por nome)
• Ferramentas de gerenciamento de grupos
• Ferramentas de gerenciamento de permissões
• Ferramentas operacionais (trabalhos, agendamentos)
• Ferramentas de administração do site
• Ferramentas avançadas de acesso a dados

Arquitetura

Esta implementação segue os padrões oficiais do MCP da Tableau com:

• Fundação TypeScript: Segurança total de tipos com validação Zod
• Design Modular: Separação clara entre a camada MCP, abstração do SDK e implementações de ferramentas
• Registro Empresarial: Registro estruturado com correlação de solicitações e mascaramento de segredos
• Tipos de Resultado: Tratamento funcional de erros com ts-results-es
• Gerenciamento de Configuração: Configuração baseada em ambiente com validação
• Testes Profissionais: Framework Vitest com relatórios de cobertura

Desenvolvimento

# Install dependencies
npm install

# Start development build with watch
npm run build:watch

# Run tests
npm test

# Run tests with coverage
npm run coverage

# Lint code
npm run lint

# Build and inspect
npm run build:inspect

Implantação

Docker

Construa e execute com Docker:

npm run build:docker
docker run -e SERVER=... -e PAT_NAME=... -e PAT_VALUE=... -e SITE_NAME=... tableau-cloud-mcp

Produção

O servidor é projetado para implantação em produção com:

• Registro estruturado com níveis configuráveis
• Correlação de solicitações para depuração
• Tratamento seguro de credenciais
• Recursos de monitoramento de desempenho
• Mecanismos de recuperação de erros e novas tentativas

Opções de Configuração

Variável de Ambiente	Descrição	Padrão
SERVER	URL do servidor do Tableau Cloud	Obrigatório
PAT_NAME	Nome do Token de Acesso Pessoal	Obrigatório
PAT_VALUE	Valor do Token de Acesso Pessoal	Obrigatório
SITE_NAME	Nome do site do Tableau	Obrigatório
DEFAULT_LOG_LEVEL	Nível de registro	debug
DISABLE_LOG_MASKING	Desativar mascaramento de dados sensíveis	false
INCLUDE_TOOLS	Lista separada por vírgulas de ferramentas a incluir	Todas as ferramentas
EXCLUDE_TOOLS	Lista separada por vírgulas de ferramentas a excluir	Nenhuma

Contribuindo

1. Faça um fork do repositório
2. Crie um branch de recurso
3. Faça suas alterações com tipos TypeScript adequados
4. Adicione testes para novas funcionalidades
5. Execute linting e testes
6. Envie um pull request

Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes.

Suporte

Para perguntas, problemas ou solicitações de recursos:

• Abra uma issue no GitHub
• Consulte a documentação abrangente das ferramentas
• Revise os exemplos de configuração

Construído com ❤️ para a Comunidade Tableau