Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas
☰ MenúEspañol Ajustes
Modo principiante Activado
ColoresSistemaClaroBlancoOscuro
IdiomaไทยEnglish中文日本語한국어EspañolDeutsch

Dbt

de us-allversión 1.0.7i★ 0iSe ejecuta en tu computadora
Nombre en el registroio.github.us-all/dbt

Cómo instalar

What it does

dbt MCP — manifest/run_results/sources/catalog parsing + DQ result tables (BigQuery/Postgres)

  • Connects Se ejecuta en tu computadora
  • Account or key Needs GOOGLE_APPLICATION_CREDENTIALS, PG_CONNECTION_STRING · 1 setting to fill in (DBT_PROJECT_DIR)
  • Category Bases de datos y conjuntos de datos

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de Dbt (créala en el sitio del autor) · 1 ajuste(s) que rellenar (DBT_PROJECT_DIR) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Dbt para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "dbt": { "command": "npx", "args": [ "-y", "@us-all/dbt-mcp" ], "env": { "DBT_PROJECT_DIR": "your-value", "GOOGLE_APPLICATION_CREDENTIALS": "your-value", "PG_CONNECTION_STRING": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOGLE_APPLICATION_CREDENTIALS, PG_CONNECTION_STRING, DBT_PROJECT_DIR deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Dbt aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Regístrate y crea una clave de Dbt

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • DBT_PROJECT_DIR Path to dbt project root (where dbt_project.yml lives).

    Las descripciones siguen en el inglés original.

  4. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  5. Pega esta configuración y guarda el archivo

    {
  "mcpServers": {
    "dbt": {
      "command": "npx",
      "args": [
        "-y",
        "@us-all/dbt-mcp"
      ],
      "env": {
        "DBT_PROJECT_DIR": "your-value",
        "GOOGLE_APPLICATION_CREDENTIALS": "your-value",
        "PG_CONNECTION_STRING": "your-value"
      }
    }
  }
}

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Cierra Claude y vuelve a abrirlo

  7. Pruébalo

    Usa Dbt y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Dbt o muestra una herramienta de Dbt en la respuesta, ya está conectado

24 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • DBT_TARGET_DIR dbt target dir for manifest.json/run_results.json (default: $DBT_PROJECT_DIR/target).
  • DBT_RUN_HISTORY_DIR Optional dir for archived run_results.json history (glob-scanned).
  • DQ_BACKEND DQ result table backend: 'bigquery' (default) or 'postgres'.
  • DQ_RESULTS_TABLE Fully qualified DQ checks table, e.g. 'project.data_ops.quality_checks'.
  • DQ_SCORE_TABLE Fully qualified DQ score-daily table, e.g. 'project.data_ops.quality_score_daily'.
  • BQ_PROJECT_ID Explicit BigQuery project ID for DQ queries.
  • DBT_ALLOW_WRITE Reserved for future write tools. Default read-only. · valor por defecto false
  • DQ_SCHEMA DQ result-table schema preset: 'generic' (default) or 'us-all'. Use DQ_COL_* env vars to override individual columns on top of the preset. · valor por defecto generic
  • DQ_COL_RUN_AT Override for the timestamp/date column on the DQ checks table. Default depends on DQ_SCHEMA preset.
  • DQ_COL_CHECK_TYPE Override for the check-type column on the DQ checks table. Default 'check_type'.
  • DQ_COL_STATUS Override for the status column on the DQ checks table. Default 'status'.
  • DQ_COL_DATASET Override for the dataset/source column on the DQ checks table. Default depends on preset.
  • DQ_COL_TABLE_NAME Override for the table/target-name column on the DQ checks table. Default depends on preset.
  • DQ_COL_SEVERITY Override for the severity/dimension column on the DQ checks table. Default depends on preset.
  • DQ_COL_FAILURE_COUNT Override for the numeric failure-count column on the DQ checks table. Default depends on preset.
  • DQ_COL_MESSAGE Override for the message column on the DQ checks table. Default depends on preset.
  • DQ_COL_CHECK_NAME Override for the check_name column on the DQ checks table. Set to 'none'/'null'/'-' to synthesize check_name from check_type and table_name.
  • DQ_COL_SCORE_DATE Override for the date column on the DQ score-daily table. Default depends on preset.
  • DQ_COL_SCOPE Override for the scope column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no per-scope rollup.
  • DQ_COL_TIER Override for the tier column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no tier dimension.
  • DQ_TIER1_TARGET_PCT When no tier column is configured (us-all preset or DQ_COL_TIER=none), the overall_score threshold dq-tier-status compares against (default 99.5). Superseded by DBT_SLA_CONFIG_PATH tier_sla.1 if both…
  • DBT_SLA_CONFIG_PATH Optional path to a YAML file that defines tier_sla (per-tier overall_score targets) and dbt_sla (test/freshness pass rates). When set, dq-tier-status and dq-tier-by-source read tier targets from this…
  • DBT_TOOLS Comma-separated category allowlist (dbt,quality,meta).
  • DBT_DISABLE Lista de exclusión de categorías separadas por comas.
    Ver original en inglésComma-separated category disablelist.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Dbt

Dbt se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Dbt

  • Necesitas una clave de Dbt (créala en el sitio del autor) · 1 ajuste(s) que rellenar (DBT_PROJECT_DIR) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de Dbt (créala en el sitio del autor) · 1 ajuste(s) que rellenar (DBT_PROJECT_DIR) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Dbt (créala en el sitio del autor) · 1 ajuste(s) que rellenar (DBT_PROJECT_DIR) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Dbt (créala en el sitio del autor) · 1 ajuste(s) que rellenar (DBT_PROJECT_DIR) · Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Bases de datos y conjuntos de datos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de Dbt (créala en el sitio del autor) · 1 ajuste(s) que rellenar (DBT_PROJECT_DIR) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Dbt para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user dbt --env DBT_PROJECT_DIR=your-value --env GOOGLE_APPLICATION_CREDENTIALS=your-value --env PG_CONNECTION_STRING=your-value -- npx -y @us-all/dbt-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOGLE_APPLICATION_CREDENTIALS, PG_CONNECTION_STRING, DBT_PROJECT_DIR deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Dbt aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Regístrate y crea una clave de Dbt

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • DBT_PROJECT_DIR Path to dbt project root (where dbt_project.yml lives).

    Las descripciones siguen en el inglés original.

  4. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  5. Pega este comando y pulsa Enter

    claude mcp add --scope user dbt --env DBT_PROJECT_DIR=your-value --env GOOGLE_APPLICATION_CREDENTIALS=your-value --env PG_CONNECTION_STRING=your-value -- npx -y @us-all/dbt-mcp

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Escribe /mcp en Claude Code

    Deberías ver Dbt en la lista como conectado

  7. Pruébalo

    Usa Dbt y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Dbt o muestra una herramienta de Dbt en la respuesta, ya está conectado

24 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • DBT_TARGET_DIR dbt target dir for manifest.json/run_results.json (default: $DBT_PROJECT_DIR/target).
  • DBT_RUN_HISTORY_DIR Optional dir for archived run_results.json history (glob-scanned).
  • DQ_BACKEND DQ result table backend: 'bigquery' (default) or 'postgres'.
  • DQ_RESULTS_TABLE Fully qualified DQ checks table, e.g. 'project.data_ops.quality_checks'.
  • DQ_SCORE_TABLE Fully qualified DQ score-daily table, e.g. 'project.data_ops.quality_score_daily'.
  • BQ_PROJECT_ID Explicit BigQuery project ID for DQ queries.
  • DBT_ALLOW_WRITE Reserved for future write tools. Default read-only. · valor por defecto false
  • DQ_SCHEMA DQ result-table schema preset: 'generic' (default) or 'us-all'. Use DQ_COL_* env vars to override individual columns on top of the preset. · valor por defecto generic
  • DQ_COL_RUN_AT Override for the timestamp/date column on the DQ checks table. Default depends on DQ_SCHEMA preset.
  • DQ_COL_CHECK_TYPE Override for the check-type column on the DQ checks table. Default 'check_type'.
  • DQ_COL_STATUS Override for the status column on the DQ checks table. Default 'status'.
  • DQ_COL_DATASET Override for the dataset/source column on the DQ checks table. Default depends on preset.
  • DQ_COL_TABLE_NAME Override for the table/target-name column on the DQ checks table. Default depends on preset.
  • DQ_COL_SEVERITY Override for the severity/dimension column on the DQ checks table. Default depends on preset.
  • DQ_COL_FAILURE_COUNT Override for the numeric failure-count column on the DQ checks table. Default depends on preset.
  • DQ_COL_MESSAGE Override for the message column on the DQ checks table. Default depends on preset.
  • DQ_COL_CHECK_NAME Override for the check_name column on the DQ checks table. Set to 'none'/'null'/'-' to synthesize check_name from check_type and table_name.
  • DQ_COL_SCORE_DATE Override for the date column on the DQ score-daily table. Default depends on preset.
  • DQ_COL_SCOPE Override for the scope column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no per-scope rollup.
  • DQ_COL_TIER Override for the tier column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no tier dimension.
  • DQ_TIER1_TARGET_PCT When no tier column is configured (us-all preset or DQ_COL_TIER=none), the overall_score threshold dq-tier-status compares against (default 99.5). Superseded by DBT_SLA_CONFIG_PATH tier_sla.1 if both…
  • DBT_SLA_CONFIG_PATH Optional path to a YAML file that defines tier_sla (per-tier overall_score targets) and dbt_sla (test/freshness pass rates). When set, dq-tier-status and dq-tier-by-source read tier targets from this…
  • DBT_TOOLS Comma-separated category allowlist (dbt,quality,meta).
  • DBT_DISABLE Lista de exclusión de categorías separadas por comas.
    Ver original en inglésComma-separated category disablelist.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de Dbt (créala en el sitio del autor) · 1 ajuste(s) que rellenar (DBT_PROJECT_DIR) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Dbt para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "dbt": { "command": "npx", "args": [ "-y", "@us-all/dbt-mcp" ], "env": { "DBT_PROJECT_DIR": "your-value", "GOOGLE_APPLICATION_CREDENTIALS": "your-value", "PG_CONNECTION_STRING": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOGLE_APPLICATION_CREDENTIALS, PG_CONNECTION_STRING, DBT_PROJECT_DIR deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Dbt aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Regístrate y crea una clave de Dbt

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • DBT_PROJECT_DIR Path to dbt project root (where dbt_project.yml lives).

    Las descripciones siguen en el inglés original.

  4. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de Dbt, GOOGLE_APPLICATION_CREDENTIALS, PG_CONNECTION_STRING, DBT_PROJECT_DIR está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de Cursor en modo Agent

  7. Pruébalo

    Usa Dbt y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Dbt o muestra una herramienta de Dbt en la respuesta, ya está conectado

24 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • DBT_TARGET_DIR dbt target dir for manifest.json/run_results.json (default: $DBT_PROJECT_DIR/target).
  • DBT_RUN_HISTORY_DIR Optional dir for archived run_results.json history (glob-scanned).
  • DQ_BACKEND DQ result table backend: 'bigquery' (default) or 'postgres'.
  • DQ_RESULTS_TABLE Fully qualified DQ checks table, e.g. 'project.data_ops.quality_checks'.
  • DQ_SCORE_TABLE Fully qualified DQ score-daily table, e.g. 'project.data_ops.quality_score_daily'.
  • BQ_PROJECT_ID Explicit BigQuery project ID for DQ queries.
  • DBT_ALLOW_WRITE Reserved for future write tools. Default read-only. · valor por defecto false
  • DQ_SCHEMA DQ result-table schema preset: 'generic' (default) or 'us-all'. Use DQ_COL_* env vars to override individual columns on top of the preset. · valor por defecto generic
  • DQ_COL_RUN_AT Override for the timestamp/date column on the DQ checks table. Default depends on DQ_SCHEMA preset.
  • DQ_COL_CHECK_TYPE Override for the check-type column on the DQ checks table. Default 'check_type'.
  • DQ_COL_STATUS Override for the status column on the DQ checks table. Default 'status'.
  • DQ_COL_DATASET Override for the dataset/source column on the DQ checks table. Default depends on preset.
  • DQ_COL_TABLE_NAME Override for the table/target-name column on the DQ checks table. Default depends on preset.
  • DQ_COL_SEVERITY Override for the severity/dimension column on the DQ checks table. Default depends on preset.
  • DQ_COL_FAILURE_COUNT Override for the numeric failure-count column on the DQ checks table. Default depends on preset.
  • DQ_COL_MESSAGE Override for the message column on the DQ checks table. Default depends on preset.
  • DQ_COL_CHECK_NAME Override for the check_name column on the DQ checks table. Set to 'none'/'null'/'-' to synthesize check_name from check_type and table_name.
  • DQ_COL_SCORE_DATE Override for the date column on the DQ score-daily table. Default depends on preset.
  • DQ_COL_SCOPE Override for the scope column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no per-scope rollup.
  • DQ_COL_TIER Override for the tier column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no tier dimension.
  • DQ_TIER1_TARGET_PCT When no tier column is configured (us-all preset or DQ_COL_TIER=none), the overall_score threshold dq-tier-status compares against (default 99.5). Superseded by DBT_SLA_CONFIG_PATH tier_sla.1 if both…
  • DBT_SLA_CONFIG_PATH Optional path to a YAML file that defines tier_sla (per-tier overall_score targets) and dbt_sla (test/freshness pass rates). When set, dq-tier-status and dq-tier-by-source read tier targets from this…
  • DBT_TOOLS Comma-separated category allowlist (dbt,quality,meta).
  • DBT_DISABLE Lista de exclusión de categorías separadas por comas.
    Ver original en inglésComma-separated category disablelist.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de Dbt (créala en el sitio del autor) · 1 ajuste(s) que rellenar (DBT_PROJECT_DIR) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Dbt para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "dbt": { "type": "stdio", "command": "npx", "args": [ "-y", "@us-all/dbt-mcp" ], "env": { "DBT_PROJECT_DIR": "your-value", "GOOGLE_APPLICATION_CREDENTIALS": "your-value", "PG_CONNECTION_STRING": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GOOGLE_APPLICATION_CREDENTIALS, PG_CONNECTION_STRING, DBT_PROJECT_DIR deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Dbt aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Regístrate y crea una clave de Dbt

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • DBT_PROJECT_DIR Path to dbt project root (where dbt_project.yml lives).

    Las descripciones siguen en el inglés original.

  4. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de Dbt, GOOGLE_APPLICATION_CREDENTIALS, PG_CONNECTION_STRING, DBT_PROJECT_DIR está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de VS Code en modo Agent

  7. Pruébalo

    Usa Dbt y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Dbt o muestra una herramienta de Dbt en la respuesta, ya está conectado

24 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • DBT_TARGET_DIR dbt target dir for manifest.json/run_results.json (default: $DBT_PROJECT_DIR/target).
  • DBT_RUN_HISTORY_DIR Optional dir for archived run_results.json history (glob-scanned).
  • DQ_BACKEND DQ result table backend: 'bigquery' (default) or 'postgres'.
  • DQ_RESULTS_TABLE Fully qualified DQ checks table, e.g. 'project.data_ops.quality_checks'.
  • DQ_SCORE_TABLE Fully qualified DQ score-daily table, e.g. 'project.data_ops.quality_score_daily'.
  • BQ_PROJECT_ID Explicit BigQuery project ID for DQ queries.
  • DBT_ALLOW_WRITE Reserved for future write tools. Default read-only. · valor por defecto false
  • DQ_SCHEMA DQ result-table schema preset: 'generic' (default) or 'us-all'. Use DQ_COL_* env vars to override individual columns on top of the preset. · valor por defecto generic
  • DQ_COL_RUN_AT Override for the timestamp/date column on the DQ checks table. Default depends on DQ_SCHEMA preset.
  • DQ_COL_CHECK_TYPE Override for the check-type column on the DQ checks table. Default 'check_type'.
  • DQ_COL_STATUS Override for the status column on the DQ checks table. Default 'status'.
  • DQ_COL_DATASET Override for the dataset/source column on the DQ checks table. Default depends on preset.
  • DQ_COL_TABLE_NAME Override for the table/target-name column on the DQ checks table. Default depends on preset.
  • DQ_COL_SEVERITY Override for the severity/dimension column on the DQ checks table. Default depends on preset.
  • DQ_COL_FAILURE_COUNT Override for the numeric failure-count column on the DQ checks table. Default depends on preset.
  • DQ_COL_MESSAGE Override for the message column on the DQ checks table. Default depends on preset.
  • DQ_COL_CHECK_NAME Override for the check_name column on the DQ checks table. Set to 'none'/'null'/'-' to synthesize check_name from check_type and table_name.
  • DQ_COL_SCORE_DATE Override for the date column on the DQ score-daily table. Default depends on preset.
  • DQ_COL_SCOPE Override for the scope column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no per-scope rollup.
  • DQ_COL_TIER Override for the tier column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no tier dimension.
  • DQ_TIER1_TARGET_PCT When no tier column is configured (us-all preset or DQ_COL_TIER=none), the overall_score threshold dq-tier-status compares against (default 99.5). Superseded by DBT_SLA_CONFIG_PATH tier_sla.1 if both…
  • DBT_SLA_CONFIG_PATH Optional path to a YAML file that defines tier_sla (per-tier overall_score targets) and dbt_sla (test/freshness pass rates). When set, dq-tier-status and dq-tier-by-source read tier targets from this…
  • DBT_TOOLS Comma-separated category allowlist (dbt,quality,meta).
  • DBT_DISABLE Lista de exclusión de categorías separadas por comas.
    Ver original en inglésComma-separated category disablelist.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Dbt💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user dbt --env DBT_PROJECT_DIR=your-value --env GOOGLE_APPLICATION_CREDENTIALS=your-value --env PG_CONNECTION_STRING=your-value -- npx -y @us-all/dbt-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "dbt": {
      "command": "npx",
      "args": [
        "-y",
        "@us-all/dbt-mcp"
      ],
      "env": {
        "DBT_PROJECT_DIR": "your-value",
        "GOOGLE_APPLICATION_CREDENTIALS": "your-value",
        "PG_CONNECTION_STRING": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "dbt": {
      "command": "npx",
      "args": [
        "-y",
        "@us-all/dbt-mcp"
      ],
      "env": {
        "DBT_PROJECT_DIR": "your-value",
        "GOOGLE_APPLICATION_CREDENTIALS": "your-value",
        "PG_CONNECTION_STRING": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "dbt": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@us-all/dbt-mcp"
      ],
      "env": {
        "DBT_PROJECT_DIR": "your-value",
        "GOOGLE_APPLICATION_CREDENTIALS": "your-value",
        "PG_CONNECTION_STRING": "your-value"
      }
    }
  }
}

Valores que debes completar

  • DBT_PROJECT_DIR obligatorio env
    Path to dbt project root (where dbt_project.yml lives).
  • DBT_TARGET_DIR env
    dbt target dir for manifest.json/run_results.json (default: $DBT_PROJECT_DIR/target).
  • DBT_RUN_HISTORY_DIR env
    Optional dir for archived run_results.json history (glob-scanned).
  • DQ_BACKEND env
    DQ result table backend: 'bigquery' (default) or 'postgres'.
  • DQ_RESULTS_TABLE env
    Fully qualified DQ checks table, e.g. 'project.data_ops.quality_checks'.
  • DQ_SCORE_TABLE env
    Fully qualified DQ score-daily table, e.g. 'project.data_ops.quality_score_daily'.
  • GOOGLE_APPLICATION_CREDENTIALS secreto obligatorio env
    Service account key path for BigQuery (ADC fallback supported).
  • BQ_PROJECT_ID env
    Explicit BigQuery project ID for DQ queries.
  • PG_CONNECTION_STRING secreto obligatorio env
    Postgres connection string when DQ_BACKEND=postgres.
  • DBT_ALLOW_WRITE env
    Reserved for future write tools. Default read-only.
  • DQ_SCHEMA env
    DQ result-table schema preset: 'generic' (default) or 'us-all'. Use DQ_COL_* env vars to override individual columns on top of the preset.
  • DQ_COL_RUN_AT env
    Override for the timestamp/date column on the DQ checks table. Default depends on DQ_SCHEMA preset.
  • DQ_COL_CHECK_TYPE env
    Override for the check-type column on the DQ checks table. Default 'check_type'.
  • DQ_COL_STATUS env
    Override for the status column on the DQ checks table. Default 'status'.
  • DQ_COL_DATASET env
    Override for the dataset/source column on the DQ checks table. Default depends on preset.
  • DQ_COL_TABLE_NAME env
    Override for the table/target-name column on the DQ checks table. Default depends on preset.
  • DQ_COL_SEVERITY env
    Override for the severity/dimension column on the DQ checks table. Default depends on preset.
  • DQ_COL_FAILURE_COUNT env
    Override for the numeric failure-count column on the DQ checks table. Default depends on preset.
  • DQ_COL_MESSAGE env
    Override for the message column on the DQ checks table. Default depends on preset.
  • DQ_COL_CHECK_NAME env
    Override for the check_name column on the DQ checks table. Set to 'none'/'null'/'-' to synthesize check_name from check_type and table_name.
  • DQ_COL_SCORE_DATE env
    Override for the date column on the DQ score-daily table. Default depends on preset.
  • DQ_COL_SCOPE env
    Override for the scope column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no per-scope rollup.
  • DQ_COL_TIER env
    Override for the tier column on the DQ score-daily table. Set to 'none'/'null'/'-' if the table has no tier dimension.
  • DQ_TIER1_TARGET_PCT env
    When no tier column is configured (us-all preset or DQ_COL_TIER=none), the overall_score threshold dq-tier-status compares against (default 99.5). Superseded by DBT_SLA_CONFIG_PATH tier_sla.1 if both…
  • DBT_SLA_CONFIG_PATH env
    Optional path to a YAML file that defines tier_sla (per-tier overall_score targets) and dbt_sla (test/freshness pass rates). When set, dq-tier-status and dq-tier-by-source read tier targets from this…
  • DBT_TOOLS env
    Comma-separated category allowlist (dbt,quality,meta).
  • DBT_DISABLE env
    Lista de exclusión de categorías separadas por comas.
    Ver original en inglésComma-separated category disablelist.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
71/sem
Conexión
Se ejecuta en tu computadora
Última versióni
1.0.7
Publicado en el registroi
19 jun 2026
Último cambio de códigoi
10 jul 2026
Creador
us-all
Paquetes
npm: @us-all/dbt-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub us-all, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 4 meses

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo

Inicia sesión para pedir otra revisión

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Bases de datos y conjuntos de datosi

  • Más estrellas que el 0% de los otros 1197 servidores de esta categoría
  • Publicado en el registro más recientemente que el 14% de los otros 1197 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 1197 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Dbt?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: GOOGLE_APPLICATION_CREDENTIALS, PG_CONNECTION_STRING

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 4 meses, y la última versión (1.0.7) llegó al registro hace 5 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: QueryWeaver, Supabase, Neon, DBCode, Keboola MCP

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

QueryWeaver

An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.

de FalkorDBEn crecimiento★ 1,1 milActualizado hace 14 meses

Se ejecuta en tu computadora✓ falkordb.com
Instalar

Supabase

MCP server for interacting with the Supabase platform

de supabaseMuy usado↓ 245,5 mil/sem★ 3 mil Estrellas de todo el repositorioActualizado anteayer

Computadora o nube✓ del servicio · supabase.com
Instalar

Neon

Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.

de neondatabaseEn crecimiento★ 663Actualizado hace 9 días

Se ejecuta en la nube✓ del servicio · neon.com
Cómo conectar

DBCode

Query and explore 100+ databases through your DBCode connections.

de dbcodeioInicial↓ 80/sem★ 366 Estrellas de todo el repositorioActualizado hace 43 días

Se ejecuta en tu computadora✓ del servicio · dbcode.io
Instalar

Keboola MCP

Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...

de keboolaEn crecimiento↓ 1,4 mil/sem★ 85Actualizado hace 4 días

Computadora o nube✓ del servicio · keboola.com
Instalar
  • QueryWeaver — Se instala en tu equipo · Sin clave
  • Supabase — En la nube o instalado en tu equipo · Necesita clave · En el directorio de Claude
  • Neon — Funciona en la nube, sin instalar nada · Sin clave
  • DBCode — Se instala en tu equipo · Sin clave
  • Keboola MCP — En la nube o instalado en tu equipo · Sin clave

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

@us-all/dbt-mcp

dbt MCP server — manifest.json, run_results.json, sources.json, catalog.json, plus DQ result tables (BigQuery / Postgres) behind one stdio MCP. Built on @us-all/mcp-toolkit.

A read-only window into your dbt project for LLM clients. No dbt run triggering — just deep introspection, run-history analysis, source freshness, per-column test coverage, lineage walks, and (if you have a custom DQ result table) historical check trends and Tier SLA status.

For DAG triggering / run history / log tails, install the companion [@us-all/airflow-mcp](https://www.npmjs.com/package/@us-all/airflow-mcp) alongside.

  • 27 tools across 3 categories (dbt, quality, meta) — 21 primitive tools + 5 aggregations + 1 meta
  • 4 MCP Prompts for triage workflows
  • 5 aggregation tools that replace 3-5 round-trips of "list / get / list"
  • extractFields response projection on high-volume reads
  • Read-only by default
  • Hybrid backend: BigQuery (default) or Postgres for DQ result tables — both peer-imported lazily

Install

# 1. add the MCP server

pnpm add -D @us-all/dbt-mcp

2. add the DQ backend you actually use (only if you query custom DQ tables):

pnpm add -D @google-cloud/bigquery # OR pnpm add -D pg

Run

DBT_PROJECT_DIR=/path/to/dbt-project \

DQ_RESULTS_TABLE=my-project.data_ops.quality_checks \ npx @us-all/dbt-mcp

The server speaks MCP stdio; wire it into Claude Desktop / Cursor / any MCP client. Set MCP_TRANSPORT=http to opt in to Streamable HTTP transport (Bearer auth, /health endpoint).

Categories

CategoryToolsPurpose
dbt15 + 3 aggregationsParse manifest.json / run_results.json / sources.json / catalog.json
quality6 + 2 aggregationsQuery quality_checks and quality_score_daily (BQ or PG); per-tier rollup via dq-tier-by-source
meta1 (always on)search-tools for natural-language tool discovery

Toggle with DBT_TOOLS=dbt (allowlist) or DBT_DISABLE=quality (denylist).

Tools at a glance

dbt (15 + 3)

dbt-list-models, dbt-get-model, dbt-list-tests, dbt-get-test, dbt-list-sources, dbt-get-source, dbt-list-exposures, dbt-list-macros, dbt-get-macro, dbt-list-runs, dbt-get-run-results, dbt-failed-tests, dbt-slow-models, dbt-coverage, dbt-graph, freshness-status, incident-context, dbt-sla-status

quality (6 + 2)

dq-list-checks, dq-get-check-history, dq-failed-checks-by-dataset, dq-score-trend, dq-tier-status, dq-tier-by-source, failed-tests-summary, dq-score-snapshot

Prompts
PromptUse when
investigate-failed-tests"What's broken in the last 24h?"
freshness-degradation-triage"Are any sources stale?" (Tier 1 focus optional)
dq-trend-report"Give me a stakeholder-friendly DQ trend report"
incident-triage"Triage " — bundles all signals

Environment variables

EnvRequiredNotes
DBT_PROJECT_DIRyesdbt project root (where dbt_project.yml lives)
DBT_TARGET_DIRnoDefaults to $DBT_PROJECT_DIR/target
DBT_RUN_HISTORY_DIRnoOptional dir for archived run_results.json history
DQ_BACKENDnobigquery (default) or postgres
DQ_RESULTS_TABLEnoFQN of the checks table; required only for checks-based quality tools
DQ_SCORE_TABLEnoFQN of the score-daily table; required for score-only tools
GOOGLE_APPLICATION_CREDENTIALSnoFor BigQuery backend (ADC fallback supported)
BQ_PROJECT_IDnoExplicit BQ project (otherwise inferred from ADC)
PG_CONNECTION_STRINGnoWhen DQ_BACKEND=postgres (secret)
DQ_SCHEMAnogeneric (default) or us-all — base schema preset for the quality category
DQ_COL_*noPer-column overrides on top of DQ_SCHEMA (see below). Overrides must be simple SQL identifiers.
DQ_TIER1_TARGET_PCTnoTier 1 SLA threshold for dq-tier-status when no tier column is configured (default 99.5). Superseded by DBT_SLA_CONFIG_PATH tier_sla.1 if both are set.
DBT_SLA_CONFIG_PATHnoOptional YAML path with tier_sla and dbt_sla blocks. Drives dq-tier-status thresholds and dq-tier-by-source per-tier targets. Mtime cached.
DBT_ALLOW_WRITEnoReserved for future write tools (none currently)
DBT_TOOLS / DBT_DISABLEnoCategory toggles

DQ result-table schema flavors

The quality category supports two schema presets via DQ_SCHEMA:

DQ_SCHEMA=generic (default)

Columns assumed on DQ_RESULTS_TABLE: run_at, check_name, check_type, dataset, table_name, status, severity, failure_count, message.

Columns assumed on DQ_SCORE_TABLE: score_date, scope, tier, completeness_pct, freshness_pct, validity_pct, anomaly_free_pct, overall_score.

dq-tier-status rolls up by Tier 1/2/3 against the per-scope rows.

DQ_SCHEMA=us-all

Real schema used at us-all (Postgres data_ops database):

quality_checks: run_date, check_type, dimension, source, target_name, status, metric_value, threshold, details (JSONB).

quality_score_daily: run_date, completeness_pct, freshness_pct, validity_pct, anomaly_free_pct, overall_score, total_checks, failed_checks.

In this flavor quality_score_daily is one row per day (no per-scope rollup, no tier column). dq-tier-status falls back to comparing the day's overall_score against DQ_TIER1_TARGET_PCT (default 99.5).

dq-get-check-history requires checkName formatted as ' : ' since us-all has no native check_name column.

Per-column overrides — DQ_COL_*

If your DQ tables don't match either preset, layer per-column overrides on top of DQ_SCHEMA. Any DQ_COL_* env var, when set, replaces the preset value for that single column. Unset vars keep the preset default.

Overrides are validated as simple SQL identifiers to avoid injecting raw SQL through environment variables. Table names in DQ_RESULTS_TABLE / DQ_SCORE_TABLE are also validated and quoted for the configured backend.

Env varLogical conceptGeneric presetus-all preset
DQ_COL_RUN_ATtimestamp/date on the checks tablerun_atrun_date
DQ_COL_CHECK_TYPEcheck type / dimension familycheck_typecheck_type
DQ_COL_STATUSpass/fail/warn/errorstatusstatus
DQ_COL_DATASETdataset / source / schemadatasetsource
DQ_COL_TABLE_NAMEtable or target nametable_nametarget_name
DQ_COL_SEVERITYseverity / dimensionseveritydimension
DQ_COL_FAILURE_COUNTnumeric failure count / metricfailure_countmetric_value
DQ_COL_MESSAGEfree-text or JSON messagemessagedetails::text
DQ_COL_CHECK_NAMEnatural identifier of the checkcheck_name_(none)_
DQ_COL_SCORE_DATEdate column on the score tablescore_daterun_date
DQ_COL_SCOPEscope/tenant column on score tablescope_(none)_
DQ_COL_TIERtier column on score tabletier_(none)_

For the three nullable columns (DQ_COL_CHECK_NAME, DQ_COL_SCOPE, DQ_COL_TIER), set the value to none / null / - to declare "no native column":

  • Without check_name → the tools synthesize one from check_type || ':' || table_name. dq-get-check-history then expects checkName formatted as ' : '.
  • Without scope → dq-score-trend's scope filter is ignored (with a caveat) and dq-tier-status switches to the single-overall_score path that compares against DQ_TIER1_TARGET_PCT.
  • Without tier → same single-overall_score fallback.

Example — generic preset against a Postgres schema where columns happen to be named differently:

DQ_SCHEMA=generic

DQ_COL_RUN_AT=checked_at DQ_COL_DATASET=schema_name DQ_COL_TABLE_NAME=tbl DQ_COL_FAILURE_COUNT=fail_n DQ_COL_CHECK_NAME=none # synthesize from check_type+tbl DQ_COL_SCOPE=none # no per-team rollup DQ_COL_TIER=none # use DQ_TIER1_TARGET_PCT instead

SLA config (optional) — DBT_SLA_CONFIG_PATH

Set DBT_SLA_CONFIG_PATH to a YAML file to surface project-defined tier targets and DBT SLAs to the quality tools. Schema (extra keys ignored):

dbt_sla:

test_pass_pct: 99.0 # consumed by dbt-sla-status (test pass rate threshold) freshness_pass_pct: 99.5 # consumed by dbt-sla-status (source freshness pass rate threshold)

tier_sla: 1: 99.5 # tier-1 overall_score / per-source pass-rate target 2: 99.0 3: 95.0

When set, the tier_sla map drives:

  • dq-tier-status — per-tier rollup compares each row's overall_score against the matching target. Without this file, hardcoded {1: 99.5, 2: 99.0, 3: 95.0} is used.
  • dq-tier-by-source — per-source pass-rate is compared to the target for that source's tier (resolved from dbt sources.yml meta.tier).
  • dq-tier-status no-tier-column path (us-all preset / DQ_COL_TIER=none) — uses tier_sla.1 as the single target. DQ_TIER1_TARGET_PCT env still works as a fallback when no SLA file is set.

The dbt_sla block drives:

  • dbt-sla-status — computes test pass rate from latest run_results.json and freshness pass rate from sources.json, then compares each axis against dbt_sla.test_pass_pct / dbt_sla.freshness_pass_pct. Returns passPct, target, meeting per axis plus caveats when fields or artifacts are missing.

The file is mtime-cached; edits between tool calls are picked up automatically.

Per-tier rollup from quality_checks — dq-tier-by-source

For schemas where quality_score_daily has only one row per day (no per-scope/tier breakdown), dq-tier-by-source reconstructs a per-tier picture from the raw quality_checks rows. Two modes:

mode: "source" (default) — group by source/dataset column

Use when each row of quality_checks represents a check on a *source group* and the dataset/source column carries the dbt source-group name directly.

  1. Builds a source_name -> tier map from the dbt manifest's sources. . .meta.tier (first table's tier per source group).
  2. Groups quality_checks rows by the dataset/source column and computes pass rate per source over a date or sinceHours window.
  3. Looks up each source's tier and target (from SLA config or defaults), reports meeting / missing per tier.
mode: "table" — group by table_name column

Use when the dataset/source column is a category (bq / dbt / airflow) and the actual dbt source-table identifier lives in the table_name / target_name column as . . Common in checks tables that consolidate signals from heterogeneous backends.

  1. Builds a . -> tier map from the manifest using each source entry's source_name + name + meta.tier — picks up *table-level* tier overrides naturally.
  2. Groups quality_checks rows by the table_name column. Pre-filter via sourceFilter (e.g. sourceFilter: "bq") when only some categories produce parseable target names.
  3. Each rollup key is parsed as . ; rows without a . or whose key is not in the manifest land in caveats[].

Untiered rows (no manifest meta.tier) and unparseable rows always appear in caveats[] so you can tier them or accept the gap.

Tested-against schemas

  • dbt manifest schema v11 / v12 — the current top version. dbt 1.7 emits v11; dbt 1.8 through 1.12 all emit v12 (the schema evolves additively in-place). Newer/unknown versions still parse, but a caveats line will flag them.

Companio

Solo se muestra el principio; lee el resto en el repo