자료실
데이터베이스MCP 서버official

dbt MCP

dbt 프로젝트·Semantic Layer·Discovery 메타데이터를 연결하는 dbt Labs 공식 MCP 서버

자료 등록 2026년 3월 30일

한눈에 보기

공식 검증 2026년 8월 29일

프로토콜
MCP · 로컬 stdio 또는 원격
인증
dbt Cloud token 또는 로컬 프로젝트·웨어하우스 자격
비용
서버 오픈소스 · dbt Cloud·웨어하우스 비용
제공 상태
공식 오픈소스 제공
공식 빠른 시작공식 빠른 시작 · https://github.com/dbt-labs/dbt-mcp

Use cases

이럴 때 이렇게 연결합니다

먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.

추천 구성 · Situation 01

지표 이름은 같아도 모델·컬럼·계보가 달라 신뢰할 수 있는 정의를 찾기 어려운 업무

어떤 어려움인가
dbt 모델과 지표 정의를 운영하는 분석팀이 자주 마주치는 문제입니다. 구체적으로는 '지표 이름은 같아도 모델·컬럼·계보가 달라 신뢰할 수 있는 정의를 찾기 어려운 업무' 상황입니다.
이렇게 해결합니다
dbt MCP 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '프로젝트, 모델·지표 이름, 환경과 기간'입니다. 필요한 필드만 골라 '정의·계보·최근 실행 상태가 연결된 지표 브리프' 형태로 정리합니다.
왜 연결하는가
처음에는 dbt MCP 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
마지막 확인
검토 대상은 '정의·계보·최근 실행 상태가 연결된 지표 브리프'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
Sequence입력부터 검토 결과까지
  1. 01 · 입력작은 입력 범위프로젝트, 모델·지표 이름, 환경과 기간
    업무 조건
  2. 02 · 현재 자료dbt MCPMCP 도구 호출: 입력 범위는 '프로젝트, 모델·지표 이름, 환경과 기간'입니다. 필요한 필드만 골라 '정의·계보·최근 실행 상태가 연결된 지표 브리프' 형태로 정리합니다.
    처리 결과
  3. 03 · 사람 확인담당자 검토검토 대상은 '정의·계보·최근 실행 상태가 연결된 지표 브리프'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.
    확인 완료
  4. 04 · 결과검토용 결과정의·계보·최근 실행 상태가 연결된 지표 브리프

Result

이 흐름으로 남는 값

연결

uvx dbt-mcp

무엇이고 왜 필요한가

dbt MCP는 dbt 프로젝트의 모델·문서·계보와 Semantic Layer·Discovery 메타데이터를 에이전트에 연결하는 dbt Labs 공식 서버입니다. 지표 정의와 변환 SQL이 어디에서 만들어지는지 실제 분석 자산에서 찾게 합니다.

할 수 있는 일

  • dbt 프로젝트 메타데이터와 모델·문서를 조회합니다.
  • Semantic Layer와 Discovery API를 에이전트 도구로 연결합니다.

시작 전 확인

  • dbt Core·Fusion·Cloud 중 사용할 기능과 자격증명을 구분합니다.
  • 인증·비용 조건은 dbt Cloud token 또는 로컬 프로젝트·웨어하우스 자격, 서버 오픈소스 · dbt Cloud·웨어하우스 비용이며 제공 상태는 공식 오픈소스 제공입니다.
  • 첫 연결은 테스트 공간에서 조회 도구 하나만 실행해 실제로 노출되는 데이터와 권한 범위를 확인합니다.

잘 맞는 경우

  • dbt를 분석 변환과 메트릭 정의의 기준으로 쓰는 데이터팀.

주의점

  • 실행 권한과 운영 자격증명을 분리하고 모델 생성 SQL은 별도 검토합니다.
  • 운영 연결 전에는 노출되는 도구와 읽기·쓰기 권한을 목록으로 남기고, 변경 작업은 대상과 내용을 확인한 뒤 실행합니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.

문의하기