---
title: "dbt MCP server configuration: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/dbt-labs-configuring-dbt-mcp-server/
description: "Pins dbt Labs' MCP setup skill, which keeps tokens out of committed config and leaves SQL and codegen off until their flags are changed."
---

# dbt MCP server configuration: review, setup & limitations · Undominated.ai

> Pins dbt Labs' MCP setup skill, which keeps tokens out of committed config and leaves SQL and codegen off until their flags are changed.

[← Explore all skills](/skills/)

MCP CONFIGURATION / dbt Labs

# dbt MCP server configuration

Pins dbt Labs' MCP setup skill, which keeps tokens out of committed config and leaves SQL and codegen off until their flags are changed.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/dbt-labs/dbt-agent-skills/tree/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt/skills/configuring-dbt-mcp-server)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 5 linked sources
 Publisher dbt Labs
 Licence [Apache-2.0 ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/LICENSE)
 Revision 7c7b5fa39e61
 [Read what was—and wasn’t—checked ↓](#review)

“Generates MCP server configuration JSON, resolves authentication setup, and validates server connectivity for dbt. Use when setting up, configuring, or troubleshooting the dbt MCP server for AI tools like Claude Desktop, Claude Code, Cursor, or VS Code.”

 [dbt Labs · upstream description ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Configuration that may be committed must use environment-variable references, and the file says never to log, display, or echo token values.
- SQL and codegen stay disabled unless DISABLE_SQL or DISABLE_DBT_CODEGEN is set to false, and a .env file is supposed to be gitignored.

### A good fit for

 - Writing a dbt MCP client config that keeps tokens in environment variables and leaves SQL disabled until it is turned on

### Weigh up before choosing

 - This review did not execute the resource.
- `/plugin install dbt@dbt-agent-marketplace` installs the dbt plugin group, not this file alone. `npx skills add dbt-labs/dbt-agent-skills/skills/dbt` installs the skills/dbt directory. `npx skills add dbt-labs/dbt-agent-skills` installs every skill in the repository.
- references/finding-credentials.md, references/troubleshooting.md, and references/environment-variables.md were not opened.
- The OAuth host example includes a scheme and a regional subdomain. The token-auth host example is cloud.getdbt.com without a scheme. The file does not say those forms are interchangeable.
- The frontmatter says user-invocable is false.
- The local-server row says there is no credit consumption. The remote-server row says it consumes dbt Copilot credits. Those are different server types.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md
- README.md
- LICENSE

### Our findings

 - Committed configuration uses environment-variable references. A project .mcp.json may be committed only that way, never with literal tokens.
- Token values are not logged, displayed, or echoed, and .env files are added to .gitignore.
- SQL and codegen start disabled. CLI tools start enabled and are turned off with DISABLE_DBT_CLI=true.
- The remote server is HTTP, requires a dbt platform account and a personal or service token, and the file says it consumes dbt Copilot credits.
- The local server row says it consumes no credits. The remote server does not expose CLI run, build, or test. The local server does.
- The file says to rotate tokens and to use the minimum required permission set.

### Not established by this review

 - The resource was not executed. No MCP server was started and no token was set.
- uvx, claude mcp add, and the client config editors were not run.
- The credential, troubleshooting, and environment-variable references were not opened.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md)

DOCUMENTED COMMAND

 /plugin install dbt@dbt-agent-marketplace Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - The repository README shows `/plugin marketplace add dbt-labs/dbt-agent-skills`, then `/plugin install dbt@dbt-agent-marketplace`. That installs the dbt plugin group, which lists this skill. It does not install this file alone.
- The same README shows `npx skills add dbt-labs/dbt-agent-skills/skills/dbt` for the skills/dbt directory, and `npx skills add dbt-labs/dbt-agent-skills` for every skill in the repository.
- This review did not install the skill.

### Before you start

 - uv, for the local server path the skill links
- A dbt project and dbt executable when CLI tools are used
- A dbt platform account and a personal or service token for the remote server

### Compatibility

Claude Desktop · Claude Code · Cursor · VS Code

### Implementation

JSON

### Transports

HTTP

### Local skill text; tokens stay in environment variables and SQL starts disabled

 - Read the skill text
- Write client config with environment-variable token references rather than literal tokens
- Leave SQL and codegen disabled unless those flags are changed

### Cost model

Apache-2.0; no MCP server was started and no token was set

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [configuring-dbt-mcp-server SKILL.md ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md) Checked 2026-10-14 https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md Supports: token handling, default-off SQL and codegen, and local versus remote server boundaries
- [Repository README ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md) Checked 2026-10-14 https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md Supports: the dbt plugin install line and the skills/dbt directory install line
- [Repository LICENSE ↗](https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/LICENSE) Checked 2026-10-14 https://github.com/dbt-labs/dbt-agent-skills/blob/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/LICENSE Supports: Apache License 2.0
- [2026-10-15 C2-W08 source re-review at the existing pin ↗](https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/skills/dbt/skills/configuring-dbt-mcp-server/SKILL.md Supports: upstreamDescription, review.notTested, review.reviewedAt
- [2026-10-15 C2-W08 source re-review at the existing pin ↗](https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md) Checked 2026-10-15 https://raw.githubusercontent.com/dbt-labs/dbt-agent-skills/7c7b5fa39e61694f1ae2b8ea1b8065e195c814ce/README.md Supports: install.command

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Build an MCP Server ↗ Interviews the developer about an MCP server before any code, recommends one deployment model and a tool-design pattern, then scaffolds a remote or local stdio server or hands off to the MCP app or MCPB skill.](/skills/anthropic-build-mcp-server/)[### dbt Documentation Maintenance ↗ Audits descriptions in a dbt manifest and drafts missing model or column documentation in the project’s existing style.](/skills/dbt-labs-maintaining-dbt-documentation/)[### MCP Integration for Claude Code Plugins ↗ Explains how a Claude Code plugin bundles MCP servers, through .mcp.json or plugin.json, for stdio, SSE, HTTP and WebSocket servers, and how plugin commands pre-allow the resulting MCP tools.](/skills/anthropic-mcp-integration/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
