Claude Code MCP & 자동화 구성 가이드

1. 개요

MCP(Model Context Protocol)란?

MCP는 Anthropic이 제안한 오픈 프로토콜로, AI 모델(Claude 등)이 외부 도구 및 데이터 소스와 표준화된 방식으로 통신할 수 있게 해주는 규격입니다. Claude Code에서 MCP 서버를 연결하면, AI가 직접 Jira 이슈를 조회하거나, DB 쿼리를 실행하거나, 모니터링 데이터를 분석하는 등의 작업을 수행할 수 있습니다.

Claude Code에서 MCP 활용 방식

Claude Code 설정 파일(.mcp.json)에 MCP 서버를 등록
Claude Code 실행 시 등록된 MCP 서버에 자동 연결
대화 중 필요 시 해당 도구를 호출하여 외부 시스템과 상호작용

2. MCP 서버 현황

확인일: 2026-02-09

#	서버	버전	도구 수	비고
1	Atlassian (Confluence + Jira)	2.14.5	40+	Confluence & Jira 통합
2	Datadog	1.0.0	18+	모니터링/APM/로그
3	MySQL	0.1.0	4	41개 DB 접근 가능
4	Bitbucket	-	REST API	MCP 미사용, REST API 직접 호출

3. 사전 요구사항

아래 도구들이 먼저 설치되어 있어야 합니다.

도구	설치 방법	용도
Node.js + npm	`brew install node`	npx 기반 MCP 서버 실행
Python + uv	`pip install uv`	uvx 기반 MCP 서버 (Atlassian)
Claude Code CLI	`npm install -g @anthropic/claude-code`	Claude Code 자체

4. MCP 서버별 상세

4-1. Atlassian (Confluence + Jira)

연결 정보

항목	값
타입	Stdio (FastMCP)
GitHub	sooperset/mcp-atlassian
Confluence 인스턴스	https://midastech.atlassian.net/
Jira 인스턴스	https://midasitweb-jira.atlassian.net/
인증 방식	API Token (Atlassian Account)

주요 도구 목록

Jira (27개)

분류	도구	설명
조회	jira_get_issue	이슈 상세 조회
조회	jira_search	JQL로 이슈 검색
조회	jira_get_project_issues	프로젝트 이슈 목록
조회	jira_get_transitions	상태 전환 목록
조회	jira_get_agile_boards	애자일 보드 조회
조회	jira_get_sprints_from_board	보드 스프린트 조회
조회	jira_get_sprint_issues	스프린트 이슈 조회
조회	jira_get_all_projects	전체 프로젝트 목록
생성/수정	jira_create_issue	이슈 생성
생성/수정	jira_update_issue	이슈 수정
생성/수정	jira_transition_issue	이슈 상태 전환
생성/수정	jira_add_comment	이슈 코멘트 추가
생성/수정	jira_create_issue_link	이슈 간 링크 생성
생성/수정	jira_link_to_epic	에픽 연결

Confluence (11개)

분류	도구	설명
조회	confluence_search	컨텐츠 검색 (CQL 지원)
조회	confluence_get_page	페이지 조회 (ID/제목)
조회	confluence_get_page_children	하위 페이지 조회
조회	confluence_get_comments	페이지 코멘트 조회
조회	confluence_get_labels	라벨 조회
생성/수정	confluence_create_page	페이지 생성
생성/수정	confluence_update_page	페이지 수정
생성/수정	confluence_delete_page	페이지 삭제
생성/수정	confluence_add_comment	코멘트 추가
생성/수정	confluence_add_label	라벨 추가
조회	confluence_search_user	사용자 검색

셋팅 방법

1) Atlassian API Token 생성

https://id.atlassian.com/manage-profile/security/api-tokens 접속
"Create API token" 클릭 → 토큰 이름 입력 → 생성된 토큰 복사

2) MCP 설정 파일 작성

~/.claude/.mcp.json 또는 프로젝트 루트의 .mcp.json에 추가:

{
  "atlassian": {
    "command": "uvx",
    "args": ["mcp-atlassian"],
    "env": {
      "CONFLUENCE_URL": "https://midastech.atlassian.net/",
      "CONFLUENCE_USERNAME": "your-email@example.com",
      "CONFLUENCE_API_TOKEN": "your-api-token",
      "JIRA_URL": "https://midasitweb-jira.atlassian.net/",
      "JIRA_USERNAME": "your-email@example.com",
      "JIRA_API_TOKEN": "your-api-token"
    }
  }
}

Confluence와 Jira가 별도 인스턴스이므로 URL을 각각 지정해야 함

uvx는 Python uv 패키지 매니저의 실행 도구 (사전 설치 필요: pip install uv)

무제한 JQL 쿼리는 차단됨 → 반드시 프로젝트 등 필터 조건 포함 필요

상세 설정은 GitHub README 참고

4-2. Datadog

연결 정보

항목	값
타입	Stdio (HTTP/Remote)
공식 문서	Datadog MCP Server Docs
인증 방식	OAuth (자동 콜백 포트)

주요 도구 목록

분류	도구	설명
로그	search_datadog_logs	로그 검색
로그	analyze_datadog_logs	SQL로 로그 분석
메트릭	search_datadog_metrics	메트릭 목록 조회
메트릭	get_datadog_metric	메트릭 타임시리즈 쿼리
메트릭	get_datadog_metric_context	메트릭 메타데이터/태그
APM	search_datadog_spans	APM 스팬 검색
APM	get_datadog_trace	트레이스 조회
APM	search_datadog_services	서비스 검색
APM	search_datadog_service_dependencies	서비스 의존성
모니터링	search_datadog_monitors	모니터 검색
모니터링	search_datadog_incidents	인시던트 검색
모니터링	get_datadog_incident	인시던트 상세
인프라	search_datadog_hosts	호스트 인벤토리
인프라	search_datadog_events	이벤트 검색
대시보드	search_datadog_dashboards	대시보드 검색
노트북	search_datadog_notebooks	노트북 검색
노트북	get_datadog_notebook	노트북 상세
RUM	search_datadog_rum_events	RUM 이벤트 검색

셋팅 방법

1) Datadog MCP 서버 설정

{
  "datadog": {
    "command": "npx",
    "args": ["-y", "@anthropic/datadog-mcp-server@latest"],
    "env": {
      "DD_API_KEY": "your-datadog-api-key",
      "DD_APP_KEY": "your-datadog-app-key",
      "DD_SITE": "datadoghq.com"
    }
  }
}

Datadog API Key / App Key는 Datadog > Organization Settings > API Keys / Application Keys에서 생성

OAuth 기반 인증도 지원 (자동 브라우저 콜백 방식)

상세 설정은 공식 문서 참고

4-3. MySQL

연결 정보

항목	값
타입	Stdio
GitHub	cano721/mysql-mcp-server
접근 가능 DB	41개 (mrs, agent, builder, erp 등)
모드	Read-only SQL 실행

도구 목록

도구	설명
list_databases	접근 가능한 데이터베이스 목록 조회
list_tables	특정 DB의 테이블 목록 조회
describe_table	테이블 스키마(컬럼, 타입 등) 조회
execute_query	Read-only SQL 쿼리 실행

셋팅 방법

1) 환경변수

변수	필수	설명
MYSQL_HOST	O	데이터베이스 서버 호스트
MYSQL_USER	O	데이터베이스 사용자명
MYSQL_PASSWORD		인증 비밀번호
MYSQL_PORT		서버 포트 (기본값: 3306)
MYSQL_DATABASE		기본 데이터베이스
MYSQL_QUERY_TIMEOUT		쿼리 타임아웃 ms (기본값: 60000)
MYSQL_ALLOW_EXPLAIN		EXPLAIN 쿼리 허용 (기본값: true)
MYSQL_ALLOW_ANALYZE		ANALYZE 쿼리 허용 (기본값: true)

2) MCP 설정

{
  "mysql": {
    "command": "npx",
    "args": ["-y", "@cano721/mysql-mcp-server@latest"],
    "env": {
      "MYSQL_HOST": "your-db-host",
      "MYSQL_PORT": "3306",
      "MYSQL_USER": "your-username",
      "MYSQL_PASSWORD": "your-password",
      "MYSQL_DATABASE": "your-default-database"
    }
  }
}

보안을 위해 Read-only 계정 사용 권장

운영 DB 직접 연결 시 주의 필요 → 개발/스테이징 DB 권장

비밀번호는 환경변수로 관리하고, .mcp.json을 .gitignore에 추가할 것

상세 설정은 GitHub README 참고

4-4. Bitbucket (REST API)

Bitbucket은 MCP 서버 대신 REST API를 직접 호출하는 방식으로 사용합니다. Claude Code의 Bash 도구를 통해 curl 명령으로 Bitbucket API를 호출할 수 있습니다.

연결 정보

항목	값
Workspace	midasitweb
Repository	ats-retention
API Base URL	https://api.bitbucket.org/2.0
API 문서	Bitbucket Cloud REST API
인증 방식	Basic Auth (Atlassian 이메일 + API Token)

인증 셋팅

1) API Token 생성

https://id.atlassian.com/manage-profile/security/api-tokens 접속
"Create API token" 클릭 → 토큰 이름 입력 → 생성된 토큰 복사

Bitbucket REST API는 Atlassian 계정의 이메일 + API Token 조합으로 Basic Auth 인증을 사용합니다.

2) 환경변수 설정 (권장)

쉘 프로파일(~/.zshrc 또는 ~/.bashrc)에 추가:

export BITBUCKET_USERNAME="your-email@example.com"
export BITBUCKET_TOKEN="your-api-token"

주요 API 사용 예시

리포지토리 정보 조회

curl -s -u "$BITBUCKET_USERNAME:$BITBUCKET_TOKEN" \
  "https://api.bitbucket.org/2.0/repositories/midasitweb/ats-retention"

PR 목록 조회

curl -s -u "$BITBUCKET_USERNAME:$BITBUCKET_TOKEN" \
  "https://api.bitbucket.org/2.0/repositories/midasitweb/ats-retention/pullrequests?state=OPEN"

특정 PR 상세 조회

curl -s -u "$BITBUCKET_USERNAME:$BITBUCKET_TOKEN" \
  "https://api.bitbucket.org/2.0/repositories/midasitweb/ats-retention/pullrequests/{pr_id}"

PR diff 조회

curl -s -u "$BITBUCKET_USERNAME:$BITBUCKET_TOKEN" \
  "https://api.bitbucket.org/2.0/repositories/midasitweb/ats-retention/pullrequests/{pr_id}/diff"

파이프라인 실행 목록

curl -s -u "$BITBUCKET_USERNAME:$BITBUCKET_TOKEN" \
  "https://api.bitbucket.org/2.0/repositories/midasitweb/ats-retention/pipelines/?sort=-created_on&pagelen=5"

PR 코멘트 추가

curl -s -u "$BITBUCKET_USERNAME:$BITBUCKET_TOKEN" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"content": {"raw": "코멘트 내용"}}' \
  "https://api.bitbucket.org/2.0/repositories/midasitweb/ats-retention/pullrequests/{pr_id}/comments"

Claude Code에서 Bash 도구를 통해 위 curl 명령을 직접 실행할 수 있습니다

환경변수로 credential을 관리하면 대화 중 노출되지 않아 안전합니다

전체 API 문서: https://developer.atlassian.com/cloud/bitbucket/rest/intro/

5. 전체 설정 파일 예시

설정 파일 위치

위치	적용 범위	설명
`~/.claude/.mcp.json`	전역 (모든 프로젝트)	사용자 전체에 적용되는 MCP 설정
`<project-root>/.mcp.json`	프로젝트 단위	특정 프로젝트에만 적용되는 MCP 설정

통합 설정 파일

여러 MCP 서버를 하나의 파일에 함께 설정할 수 있습니다:

{
  "atlassian": {
    "command": "uvx",
    "args": ["mcp-atlassian"],
    "env": {
      "CONFLUENCE_URL": "https://midastech.atlassian.net/",
      "CONFLUENCE_USERNAME": "your-email@example.com",
      "CONFLUENCE_API_TOKEN": "your-api-token",
      "JIRA_URL": "https://midasitweb-jira.atlassian.net/",
      "JIRA_USERNAME": "your-email@example.com",
      "JIRA_API_TOKEN": "your-api-token"
    }
  },
  "datadog": {
    "command": "npx",
    "args": ["-y", "@anthropic/datadog-mcp-server@latest"],
    "env": {
      "DD_API_KEY": "your-datadog-api-key",
      "DD_APP_KEY": "your-datadog-app-key",
      "DD_SITE": "datadoghq.com"
    }
  },
  "mysql": {
    "command": "npx",
    "args": ["-y", "@cano721/mysql-mcp-server@latest"],
    "env": {
      "MYSQL_HOST": "your-db-host",
      "MYSQL_PORT": "3306",
      "MYSQL_USER": "your-username",
      "MYSQL_PASSWORD": "your-password",
      "MYSQL_DATABASE": "your-default-database"
    }
  }
}

6. 트러블슈팅

증상	원인	해결
401 Unauthorized	API 토큰/비밀번호 누락 또는 만료	환경변수 확인 및 토큰 재발급
MCP 서버 미연결	`.mcp.json` 파일 위치 오류	파일 경로 확인 (홈 디렉토리 또는 프로젝트 루트)
npx/uvx 실행 실패	Node.js / Python 미설치	사전 요구사항 설치 확인
도구 호출 시 타임아웃	네트워크 문제 또는 서버 다운	VPN 연결 확인, 서버 상태 확인

저작자표시 비영리 변경금지 (새창열림)

계범 개발일지

Claude Code MCP & 자동화 구성 가이드

1. 개요

MCP(Model Context Protocol)란?

Claude Code에서 MCP 활용 방식

2. MCP 서버 현황

3. 사전 요구사항

4. MCP 서버별 상세

4-1. Atlassian (Confluence + Jira)

연결 정보

주요 도구 목록

셋팅 방법

4-2. Datadog

연결 정보

주요 도구 목록

셋팅 방법

4-3. MySQL

연결 정보

도구 목록

셋팅 방법

4-4. Bitbucket (REST API)

연결 정보

인증 셋팅

주요 API 사용 예시

5. 전체 설정 파일 예시

설정 파일 위치

통합 설정 파일

6. 트러블슈팅

댓글

티스토리툴바