configuring-dbt-mcp-server

Generate dbt MCP server configuration JSON and validate connectivity.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/shapris/svarus-darbas --skill configuring-dbt-mcp-server-shapris
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-dbt-mcp-server
Source: https://github.com/shapris/svarus-darbas/tree/main/.kilocode/skills/dbt/skills/configuring-dbt-mcp-server
Command: npx skills add https://github.com/shapris/svarus-darbas --skill configuring-dbt-mcp-server-shapris

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enables reliable connection between AI clients and dbt by generating proper MCP server configuration, resolving authentication methods, and validating server accessibility to prevent misconfiguration and broken integrations.

Core Features & Use Cases

  • Configuration Generation: Provides JSON templates for local uvx-based servers and remote HTTP endpoints tailored to different clients (Claude Desktop, Claude Code, Cursor, VS Code).
  • Authentication Guidance: Details when to use personal access tokens, service tokens, or OAuth, and how to securely reference credentials via environment variables.
  • Verification & Troubleshooting: Includes verification steps and common fixes for path, uvx, and token errors to confirm connectivity and client integration.
  • Use Case: Set up a local dbt development environment that exposes the dbt CLI and Semantic Layer to an AI tool, or configure a remote production connection to dbt Cloud for metric discovery and job administration.

Quick Start

Configure a local or remote dbt MCP server using the provided JSON templates, set required environment variables such as DBT_PROJECT_DIR and DBT_TOKEN, and run the verification steps to confirm the client can list models and metrics.

Frequently Asked Questions about configuring-dbt-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure the dbt MCP server for Claude Desktop or Cursor?

Configure dbt MCP connectivity by generating client-specific JSON templates for local uvx or remote dbt Cloud endpoints, setting environment variables like DBT_PROJECT_DIR, and running verification steps.

What authentication methods are supported for dbt Cloud MCP connections?

dbt Cloud MCP connections support personal access tokens, service tokens, or OAuth, which you securely reference via environment variables to establish valid remote HTTP endpoint authentication.

How do I verify dbt MCP server connectivity after setting up the JSON configuration?

Verify dbt MCP server connectivity by running included verification steps to confirm the AI client can successfully list models and metrics, applying common fixes for path or token errors if needed.

Does the dbt MCP server configuration support both local development and remote production environments?

Yes, dbt MCP server configuration supports local uvx-based servers for CLI exposure and remote HTTP endpoints to dbt Cloud for production metric discovery and job administration.

Why does my dbt MCP connection fail when using environment variables for credentials?

dbt MCP connection failures often stem from misconfigured environment variables, invalid tokens, or incorrect uvx paths; use troubleshooting steps to resolve these common connectivity errors.