Claude Code 가이드

Claude Code 가이드 #4 — MCP 서버 연결하기

Model Context Protocol로 외부 도구를 Claude Code에 연결하는 방법을 설명한다. MCP 서버 설치, 설정 파일 작성, GitHub·Slack·DB 연동 예시와 트러블슈팅을 포함한다.

2026-01-23

한 줄 요약: MCP 서버를 Claude Code에 연결하면 데이터베이스 조회, GitHub API 호출, 파일 시스템 접근 등을 AI가 직접 수행할 수 있어 작업 범위가 크게 확장된다.

MCP(Model Context Protocol)는 Claude Code가 외부 도구와 통신하는 표준 프로토콜이다. 이 가이드는 MCP 서버 연결 방법, 주요 서버 목록, 보안 설정을 정리한다.

MCP란?

MCP는 Claude Code와 외부 서비스를 연결하는 다리입니다. 별도의 API 코드를 작성할 필요 없이, MCP 서버를 설정하면 Claude Code가 해당 서비스의 데이터에 접근할 수 있습니다.

Google Drive: 디자인 문서, 스프레드시트 읽기
Jira/Asana: 티켓 생성, 상태 업데이트
Slack: 채널 메시지 검색, 알림 전송
커스텀 도구: 자신만의 MCP 서버 구축 가능

MCP란? — CLI 실행 화면과 출력 결과 — Claude Code 가이드 #4 — MCP 서버 연결하기 — CLI 실행 화면과 출력 결과 (출처: 공식 문서 및 벤치마크 데이터 기반)

MCP 서버 연결은 .claude/settings.json 또는 claude_desktop_config.json에서 설정한다. 각 MCP 서버는 command(실행 명령)와 args(인수)로 정의하며, 필요한 경우 env로 환경 변수(API 키 등)를 전달한다.

MCP 서버 설정 예시
// .claude/settings.json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres",
               "postgresql://user:pass@localhost/mydb"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxxx" }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem",
               "/Users/me/projects"]
    }
  }
}

주요 공식 MCP 서버: server-postgres(PostgreSQL 쿼리), server-github(이슈/PR 관리), server-filesystem(파일 접근), server-brave-search(웹 검색), server-puppeteer(웹 스크래핑/테스트). 커뮤니티 서버로 Slack, Notion, Jira 연동도 가능하다.

MCP 서버 설정 방법

Claude Code 설정 파일에 MCP 서버를 추가합니다.

MCP 서버 등록 (설정 파일)
{
  "mcpServers": {
    "google-drive": {
      "type": "url",
      "url": "https://gdrive.mcp.claude.com/mcp"
    },
    "custom-tool": {
      "type": "stdio",
      "command": "node",
      "args": ["./my-mcp-server.js"]
    }
  }
}

커스텀 MCP 서버 만들기

팀 내부 도구나 데이터베이스에 Claude Code를 연결하려면 커스텀 MCP 서버를 만들 수 있습니다. Node.js 기반으로 간단하게 구현 가능합니다.

💡 팁: MCP 서버는 uvx를 사용해 배포하면 팀원들과 쉽게 공유할 수 있습니다.

다음 편에서는 에이전트 & 서브에이전트를 다룹니다. Multi-Agent 시스템으로 코드 리뷰를 자동화하는 방법을 알아봅니다.

📘 Claude Code 공식 문서 보기

MCP 보안 설정

최소 권한 원칙: DB 서버는 읽기 전용 사용자로 연결, 파일 시스템은 특정 디렉토리만 허용, GitHub 토큰은 필요한 scope만 부여. 환경 분리: 프로덕션 DB에 직접 연결하지 말 것 — 개발/스테이징 환경만 사용. API 키 관리: 환경 변수나 시스템 키체인을 사용하고, 설정 파일에 직접 기재하지 말 것.

시작 추천: 처음 MCP를 사용한다면 server-filesystem부터 시작하라. 가장 단순하고 안전하며, AI가 프로젝트 외부 파일(문서, 스펙)을 참조할 수 있게 해준다.

claude-code클로드 코드mcp통합google-drivejira

← 이전
Claude Code 가이드 #3 — CLI 명령어 총정리 다음 →
Claude Code 가이드 #5 — 에이전트 & 서브에이전트

Claude Code 가이드 #4 — MCP 서버 연결하기

MCP란?

MCP 서버 설정 방법

커스텀 MCP 서버 만들기

MCP 보안 설정

관련 도구

관련 포스트