Troubleshooting

"uvx not found" or "spawn uvx ENOENT"

Find full path and use it in config:

# macOS/Linux
which uvx
# Use output like: /opt/homebrew/bin/uvx

# Windows
where uvx

Update config:

{
  "command": "/opt/homebrew/bin/uvx",
  "args": ["dbt-mcp"]
}

"Could not connect to MCP server"

1. Check uvx is installed: uvx --version
2. Verify paths exist: ls $DBT_PROJECT_DIR/dbt_project.yml
3. Check dbt works: $DBT_PATH --version

OAuth Not Working

Only accounts with static subdomains (e.g., abc123.us1.dbt.com) support OAuth. Check your Access URLs in dbt platform settings.

Remote Server Returns 401/403

• Verify token has Semantic Layer and Developer permissions
• For execute_sql: Use personal access token, not service token
• Check environment ID is correct (from Orchestration page)

Common Mistakes