CLAUDE.md 완전 정복 - MCP 연동 완전가이드

DB·GitHub·Slack·사내 API를 AI에 연결하는 설정과 보안

MCP란 무엇인가

Model Context Protocol(MCP)은 Claude Code가 외부 툴이나 서비스와 연동하기 위한 표준 프로토콜입니다. MCP 서버를 연결함으로써 Claude Code의 능력을 데이터베이스 쿼리, API 호출, 브라우저 조작 등으로 확장할 수 있습니다.

Claude Code에는 기본으로 파일 조작과 Bash 실행 툴이 내장되어 있습니다. MCP는 여기에 추가 툴을 붙이는 확장 메커니즘입니다.

MCP 서버는 독립된 프로세스로 동작하며, Claude Code와 표준 입출력(stdio) 또는 HTTP로 통신합니다.

MCP 서버 설정

MCP 서버는 .claude/settings.json에 설정합니다. CLAUDE.md와는 별도 파일입니다.

{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "${DATABASE_URL}"
}
}
}
}

자주 쓰는 MCP 서버

PostgreSQL / MySQL

데이터베이스에 직접 쿼리를 실행할 수 있습니다.

{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "${DATABASE_URL}"
}
}
}
}

연결 후 "users 테이블의 최근 가입자 수를 알려줘"라고 말하기만 하면, Claude Code가 SQL을 실행하고 결과를 반환합니다. 스키마를 참조하여 타입 정의를 자동 생성하는 용도로도 자주 활용됩니다.

파일 시스템

프로젝트 디렉토리 외부 경로에도 접근이 필요할 때 사용합니다.

{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
}
}
}

GitHub