Datadog MCP 설치 및 운영 환경에서 사용하기

Datadog MCP 설치 및 사용법 (Claude Code + OAuth)

Claude Code에서 Datadog MCP(Model Context Protocol) 를 연결하면 Claude가 Datadog의 메트릭, 로그, 모니터 상태 등을 직접 조회할 수 있다.

Claude는 Datadog MCP 서버를 통해 Datadog 데이터를 조회하고 결과를 정리해준다.

공식 문서  https://docs.datadoghq.com/ko/bits_ai/mcp_server/setup/?tab=claudecode

Set Up the Datadog MCP Server

 

 

1. Datadog Site 확인

Datadog MCP는 Datadog Site(region)에 따라 접속 URL이 다르다.

본인이 사용하는 리전에 맞춰서 설정하면 된다. 

https://mcp.datadoghq.com/api/unstable/mcp-server/mcp

 

2. Claude에 Datadog MCP 서버 등록

Claude CLI에서 MCP 서버를 등록한다.

claude mcp add --transport http datadog-mcp https://mcp.datadoghq.com/api/unstable/mcp-server/mcp

 

3. Datadog OAuth 인증

Datadog MCP는 API Key 방식이 아니라 OAuth 인증을 사용한다.

처음 MCP 서버를 호출하면 Datadog 로그인 페이지가 열린다.

인증 과정

1. Claude가 MCP 서버 호출
2. Datadog OAuth 로그인 페이지 이동
3. Datadog 계정 로그인
4. Claude Code 접근 승인

인증이 완료되면 OAuth 토큰이 저장되어 이후 재인증 없이 사용할 수 있다.

 

4. Datadog MCP 구조

Datadog MCP는 Claude가 Datadog 데이터를 직접 이해할 수 있도록 중간에서 연결해주는 인터페이스 역할을 한다.

구조는 다음과 같다.

Claude Code
      │
      │ 자연어 요청
      ▼
Datadog MCP Server
      │
      │ Datadog API 호출
      ▼
Datadog Platform
(Metrics / Logs / Monitors / APM)

 

동작 흐름

1️⃣ 사용자가 Claude에게 질문 

• 최근 1시간 에러율 높은 서비스 찾아줘

2️⃣ Claude가 MCP 서버에 요청 전달

3️⃣ MCP 서버가 Datadog API 호출

4️⃣ Datadog 데이터 조회

5️⃣ Claude가 결과를 분석해 자연어로 요약

 

5. Datadog MCP 사용 예시

연결 후 Claude에게 Datadog 데이터를 직접 질의할 수 있다.

최근 1시간 서비스 에러율 높은 모니터 찾아줘
현재 CPU 사용률 높은 서비스 알려줘
Datadog에서 CRITICAL 상태 모니터 뭐 있어?

 

6. 운영 장애 분석 예시

운영 중 장애가 발생했을 때 Datadog MCP를 활용하면 원인 파악을 빠르게 진행할 수 있다.

예시 상황 : 서비스 응답 속도가 갑자기 느려짐

기존 방식

1️⃣ Datadog Dashboard 이동
2️⃣ Metrics 확인
3️⃣ Logs 확인
4️⃣ Monitor 확인

여러 화면을 이동하면서 확인해야 한다.

 

MCP 사용 방식

Claude에게 질문

지난 30분 동안 에러율 증가한 서비스 찾아줘
최근 CPU 사용률 급증한 Kubernetes pod 분석해줘

 

Claude는 다음 데이터를 종합해서 분석한다.

• Metrics
• Logs
• Monitor 상태
• 서비스 상태

결과 예시

payment-service 에서 CPU 사용률이 90% 이상으로 증가
동시에 error rate 증가
관련 로그에서 timeout 발생

즉 여러 Datadog 데이터를 종합해서 요약된 분석을 받을 수 있다.

 

정리

Datadog MCP를 연결하면 아래 내용들을 Claude에게 자연어로 물어볼 수 있다.

• Datadog 메트릭 조회
• 로그 분석
• 모니터 상태 확인
• 장애 원인 탐색

특히 운영 환경에서 아래 상태 같은 작업을 빠르게 수행할 때 유용하다.

• 장애 원인 분석
• 서비스 상태 확인
• 모니터 상태 점검