MCP통합 - 외부 서비스 연결
목차
Claude Code가 외부 서비스와 대화할 수 있다면 어떨까요?
Slack 메시지 전송, GitHub 이슈 생성, 데이터베이스 조회... 이 모든 것이 MCP(Model Context Protocol)로 가능합니다.
이 글에서는 MCP의 개념과 설정 방법을 알아봅니다.
MCP란?
MCP가 뭔가요? 이름만 들으면 무슨 프로토콜 같은데...
맞아, 프로토콜이야! 쉽게 말하면 Claude Code가 외부 도구와 소통하는 표준 방식이지. USB가 다양한 기기를 컴퓨터에 연결하듯, MCP는 다양한 서비스를 Claude에 연결해.
그럼 아무 서비스나 연결할 수 있어요?
MCP 서버가 있는 서비스만 가능해. GitHub, Slack, 데이터베이스 등 주요 서비스들은 이미 MCP 서버가 있어서 바로 연결할 수 있어!
MCP = Model Context Protocol
역할 = Claude와 외부 서비스 연결
구성 = MCP 서버 (제공자) ↔ Claude (소비자)
결과: 외부 도구/데이터를 Claude가 직접 사용
MCP로 할 수 있는 것
💡 MCP 활용 예시
- GitHub MCP - 이슈 생성, PR 리뷰, 코드 검색
- Slack MCP - 메시지 전송, 채널 조회
- Database MCP - SQL 쿼리 실행, 데이터 조회
- File System MCP - 파일 읽기/쓰기 (Read/Write 확장)
- Browser MCP - 웹 페이지 자동화
MCP의 강점
기존: 스킬에서 Bash로 curl 명령 실행
MCP: 전용 도구로 직접 호출
→ 더 안전하고, 더 편리하고, 더 강력!
MCP 서버 설정
MCP 서버는 settings.json에 설정합니다.
위치: ~/.claude/settings.json
기본 구조
{
"mcpServers": {
"서버이름": {
"command": "실행 명령",
"args": ["인자1", "인자2"],
"env": {
"API_KEY": "your-api-key"
}
}
}
}실전 예제: GitHub MCP 연결
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
}
}
}
}env에 API 키를 직접 넣어도 되나요?
settings.json은 Git에 올리면 안 되는 파일이야. 전역 설정(~/.claude/)은 개인 폴더라 괜찮고, 프로젝트 설정(.claude/)은 .gitignore에 추가해야 해!
MCP 도구 사용하기
MCP 서버가 연결되면 새로운 도구가 추가됩니다.
💡 MCP 도구 명명 규칙
mcp__서버이름__도구이름 예시: - mcp__github__create_issue - mcp__slack__post_message - mcp__database__query
스킬에서 MCP 활용
---
name: issue-creator
description: GitHub 이슈 자동 생성
---
# 이슈 생성 스킬
## 규칙
1. 사용자 요청을 분석하여 이슈 제목과 본문 작성
2. mcp__github__create_issue 도구로 이슈 생성
3. 생성된 이슈 URL을 사용자에게 알림
## 형식
- 이슈 제목: [카테고리] 요약
- 본문: 배경, 상세 내용, 기대 결과
MCP 도구가 제대로 연결됐는지 확인하려면 Claude에게 "사용 가능한 MCP 도구 알려줘"라고 물어보세요!
주요 MCP 서버 목록
| MCP 서버 | 기능 | 패키지 |
|---|---|---|
| GitHub | 이슈, PR, 코드 | @modelcontextprotocol/server-github |
| Slack | 메시지, 채널 | @modelcontextprotocol/server-slack |
| Filesystem | 파일 작업 확장 | @modelcontextprotocol/server-filesystem |
| PostgreSQL | 데이터베이스 쿼리 | @modelcontextprotocol/server-postgres |
더 많은 MCP 서버: https://github.com/modelcontextprotocol/servers
MCP = 외부 서비스 연결 프로토콜
설정 위치 = settings.json의 mcpServers
도구 이름 = mcp__서버__도구
주의 = API 키는 Git에 올리지 않기!
👉 통합 아키텍처 : CLAUDE.md, 스킬, MCP를 조합하는 법
MCP로 Claude의 능력을 무한 확장하세요!
외부 세계와 연결된 AI는 더욱 강력합니다! 🔌
댓글
댓글 쓰기