🔌 dbt MCP Server: conecte seus projetos dbt a assistentes de IA

📌 Pra que serve

O dbt MCP Server expõe metadados, modelos, métricas e comandos do dbt (CLI, Semantic Layer, Discovery API) para clientes MCP como Claude, Cursor e VS Code. Assim, um assistente de IA consegue rodar dbt build, consultar linhagem de dados ou responder perguntas sobre métricas do seu projeto de forma governada, sem você copiar e colar contexto manualmente.

🛠️ Passo a passo

1. Pré-requisito: tenha um projeto dbt (Core ou plataforma) já configurado localmente. 2. Instale o uv/uvx (gerenciador de pacotes Python):

curl -LsSf https://astral.sh/uv/install.sh | sh

3. Rode o servidor MCP self-hosted diretamente (não precisa clonar repositório):

uvx dbt-mcp

4. Configure as variáveis de ambiente necessárias (token do dbt platform, caminho do projeto, etc.) seguindo a referência oficial de variáveis (link abaixo). 5. Conecte um cliente MCP compatível — Claude Desktop, Cursor ou a extensão VS Code do dbt — apontando para o servidor local. 6. Teste pedindo ao assistente algo simples, como "liste os modelos do meu projeto dbt" ou "rode o dbt test no modelo X". 7. Se preferir zero instalação, use o Remote MCP Server (hospedado pela dbt Labs) para consultas de dados via HTTP, sem rodar nada localmente — só funciona para consumo, não para comandos CLI.

💡 Dica: só a ferramenta text_to_sql consome sua cota de ações do dbt Copilot; as demais ferramentas MCP são "de graça" dentro do seu plano dbt platform.

🔗 Links e instalação

Fonte oficial: https://docs.getdbt.com/docs/d