목차
1. MCP란?
MCP(Model Context Protocol)는 AI Agent가 외부 시스템과 통신하기 위한 표준 프로토콜입니다.
쉽게 말하면 AI Agent에 파일 읽기, 데이터베이스 조회, API 호출, GitHub 이슈 확인, 사내 시스템 조회 같은 실행 능력을 붙이는 방식입니다.
AI가 대화만 하면 답변 생성에 머물지만, MCP를 붙이면 DB를 조회하고, GitHub 이슈를 확인하고, 파일을 읽고, API를 호출하는 실행형 작업자로 확장됩니다.
공식 MCP 문서는 MCP를 AI 애플리케이션이 로컬 파일, 데이터베이스, 검색 엔진, 계산기, 특화 프롬프트 같은 외부 시스템과 연결되도록 하는 오픈 표준으로 설명합니다.
2. MCP 핵심 구성요소
MCP 서버는 보통 Tools, Resources, Prompts라는 세 가지 기능을 제공합니다.
| 구성요소 | 설명 | 예시 |
|---|---|---|
| Tools | AI가 호출할 수 있는 실행 함수입니다. | DB 조회, API 호출, 파일 생성 |
| Resources | AI가 읽을 수 있는 데이터입니다. | 문서, 로그, 설정 파일, DB 스키마 |
| Prompts | 재사용 가능한 프롬프트 템플릿입니다. | 보안 분석 보고서, 코드 리뷰 템플릿 |
공식 MCP 개념상 Tool은 모델이 외부 시스템과 상호작용하기 위해 호출하는 기능이며, 각 Tool은 이름과 입력 스키마를 갖습니다. Resource는 모델이 참고할 수 있는 데이터이고, Prompt는 특정 작업을 일관되게 수행하도록 돕는 템플릿입니다.
3. MCP 서버 종류
3.1 파일 시스템 MCP
파일 시스템 MCP는 로컬 파일을 읽고 쓰는 MCP입니다.
- 이 프로젝트 구조 분석해줘
- README.md를 생성해줘
- logs 폴더에서 에러 원인 찾아줘
Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI 같은 개발 도구에서 프로젝트 분석과 문서 생성에 자주 활용됩니다.
3.2 Git / GitHub MCP
Git / GitHub MCP는 Git 저장소, PR, Issue, Commit 정보를 AI가 직접 다룰 수 있게 해줍니다.
- 최근 PR 변경사항 리뷰해줘
- 이 이슈 기준으로 브랜치 작업 계획 세워줘
- 커밋 로그 기반 릴리즈 노트 만들어줘
개발 Agent에서는 이슈 기반 작업 계획, 코드 리뷰, 릴리즈 노트 작성, 변경 이력 분석에 특히 유용합니다.
3.3 Database MCP
Database MCP는 MySQL, PostgreSQL, SQLite, MongoDB 같은 DB에 연결합니다.
- users 테이블 구조 확인해줘
- 최근 7일 주문 데이터를 요약해줘
- 이 쿼리 성능 문제 분석해줘
주의할 점은 읽기 전용 계정부터 시작하는 것입니다. 처음부터 INSERT, UPDATE, DELETE 권한을 주면 AI가 잘못된 도구 호출을 했을 때 데이터 손상이 발생할 수 있습니다.
3.4 Web / Browser MCP
Web / Browser MCP는 웹 검색, 웹 페이지 분석, 브라우저 자동화에 사용합니다. Playwright MCP가 이 영역에 해당합니다.
- 경쟁사 가격 정책 조사해줘
- 관리자 페이지 로그인 후 리포트 다운로드해줘
- 뉴스 사이트에서 최신 보안 이슈 수집해줘
3.5 API 연동 MCP
API 연동 MCP는 사내 API, 외부 SaaS API, 보안 API, IP 평판 API 등을 연결합니다.
- 이 IP의 ASN, Whois, OTX 평판 조회해줘
- Jira 티켓 상태 확인해줘
- Slack 채널의 장애 메시지 요약해줘
IP Intelligence 시스템에는 이 유형이 가장 잘 맞습니다. 조회형 Tool을 먼저 만들고 캐시와 이력 저장을 뒤에 붙이면 운영 위험을 줄일 수 있습니다.
3.6 문서 / RAG MCP
문서 / RAG MCP는 Notion, Google Drive, Confluence, 로컬 문서, Vector DB 등을 연결합니다.
- 사내 보안 정책 문서 기준으로 답변해줘
- 장애 대응 매뉴얼에서 관련 절차 찾아줘
- RAG 문서 검색 후 요약해줘
3.7 업무 자동화 MCP
업무 자동화 MCP는 Slack, Gmail, Calendar, Jira, Linear, Asana, Trello 등을 연결합니다.
- 오늘 회의 일정 요약해줘
- 미처리 Jira 이슈 우선순위 정리해줘
- 고객 메일 초안 작성해줘
4. AI Agent별 MCP 활용방법
4.1 Claude Desktop
Claude Desktop은 MCP 생태계에서 초기에 많이 쓰인 클라이언트입니다. Anthropic은 MCP를 2024년에 공개하며 AI 앱과 외부 데이터 사이의 연결 표준으로 설명했습니다.
활용 방식은 Claude Desktop 설정 파일에 MCP 서버를 등록하는 형태입니다.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/user/project"
]
}
}
}| 용도 | 적합도 |
|---|---|
| 문서 분석 | 매우 좋음 |
| 로컬 파일 작업 | 좋음 |
| 개인 업무 자동화 | 좋음 |
| 개발 프로젝트 분석 | 좋음 |
| 대규모 서버 운영 자동화 | 주의 필요 |
4.2 Claude Code
Claude Code는 터미널 기반 개발 Agent입니다. MCP를 붙이면 로컬 코드뿐 아니라 GitHub, DB, 문서, Jira까지 함께 보면서 작업할 수 있습니다.
- GitHub 이슈 #32를 읽고 현재 코드에서 수정해야 할 파일 찾아줘
- PostgreSQL 스키마를 확인하고 API 코드를 수정해줘
- 테스트 실패 로그를 분석하고 패치해줘
| MCP | 목적 |
|---|---|
| Filesystem | 프로젝트 파일 분석 |
| GitHub | Issue, PR, Repository 연동 |
| PostgreSQL / MySQL | DB 기반 백엔드 개발 |
| Context7 | 최신 라이브러리 문서 참고 |
| Playwright | E2E 테스트 자동화 |
4.3 OpenAI Codex CLI
Codex CLI도 MCP 서버 설정을 지원합니다. OpenAI 공식 Codex 문서는 MCP를 통해 Codex에 추가적인 외부 도구와 컨텍스트를 제공할 수 있다고 안내합니다.
설정 개념은 config.toml에 MCP 서버를 등록하거나 CLI 명령으로 추가하는 방식입니다.
[mcp_servers.sqlite]
command = "npx"
args = ["-y", "sqlite-mcp"]codex mcp add sqlite npx -y sqlite-mcp최근 Codex CLI에서는 서버 이름 뒤에 실행 명령을 바로 붙이는 형태를 사용하는 경우가 많습니다.
- SQLite DB 구조 보고 ERD 초안 만들어줘
- 현재 코드와 DB 스키마가 맞는지 확인해줘
- GitHub 이슈 기준으로 구현 계획 작성해줘
| 용도 | 적합도 |
|---|---|
| CLI 기반 코드 수정 | 매우 좋음 |
| 로컬 프로젝트 분석 | 매우 좋음 |
| DB 연동 개발 | 좋음 |
| 운영 자동화 | 권한 제한 필수 |
4.4 Cursor
Cursor는 IDE 내부에서 MCP를 사용할 수 있는 대표적인 AI 코딩 도구입니다. MCP를 외부 도구와 데이터 소스에 연결하기 위한 방식으로 활용할 수 있습니다.
프로젝트 또는 사용자 설정에 mcp.json을 두고 서버를 등록합니다.
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
}
}
}
}- 현재 코드 기준으로 GitHub 이슈 해결해줘
- Next.js 공식 문서 기준으로 App Router 구조 수정해줘
- 이 에러 로그와 관련된 파일을 찾아줘
| MCP | Cursor 활용 |
|---|---|
| GitHub MCP | 이슈 기반 개발 |
| Context7 MCP | 최신 프레임워크 문서 참조 |
| Filesystem MCP | 프로젝트 탐색 |
| Playwright MCP | 브라우저 테스트 |
| DB MCP | 백엔드 코드와 DB 구조 동시 분석 |
4.5 VS Code / GitHub Copilot
VS Code도 MCP 서버를 직접 추가하고 관리할 수 있습니다. 공식 문서에 따르면 VS Code의 MCP 서버는 파일 작업, 데이터베이스, 외부 API 같은 작업용 Tools를 제공할 수 있고 Resources, Prompts, Interactive Apps도 제공할 수 있습니다.
{
"servers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
}
}
}- 워크스페이스 전체 구조 분석해줘
- 테스트 코드가 부족한 파일 찾아줘
- GitHub 이슈와 코드 변경사항을 비교해줘
4.6 Gemini CLI
Gemini CLI도 MCP 서버를 지원합니다. Gemini CLI 문서는 MCP 서버가 도구와 리소스를 노출하고, Gemini CLI가 이를 통해 데이터베이스, API, 사용자 정의 스크립트, 특화 워크플로와 상호작용할 수 있다고 설명합니다.
- 이 저장소에서 성능 병목 찾아줘
- 테스트 커버리지 높이는 패치 작성해줘
- API 문서와 코드가 일치하는지 확인해줘
| MCP | 활용 |
|---|---|
| Filesystem | 로컬 코드 분석 |
| GitHub | 저장소, PR, Issue 연동 |
| Google Search | 최신 정보 확인 |
| DB MCP | 데이터 기반 코드 분석 |
4.7 OpenWebUI
OpenWebUI는 자체 MCP 지원과 mcpo 방식을 함께 검토할 수 있습니다. mcpo를 이용하면 MCP 서버를 OpenAPI 형태로 노출해 OpenWebUI Tools처럼 사용할 수 있습니다.
- 8.8.8.8 IP 평판 보고서 작성해줘
- OTX pulse 기반 위협 인텔리전스 요약해줘
- 최근 조회한 악성 IP 목록을 표로 정리해줘
5. MCP 도입 시 보안 주의사항
MCP는 강력하지만 AI Agent에 외부 시스템 실행 권한을 부여하는 구조입니다. 따라서 권한 관리, 승인 정책, 감사 로그가 핵심입니다.
| 항목 | 권장 방식 |
|---|---|
| DB 권한 | 처음에는 Read Only |
| 파일 접근 | 프로젝트 폴더로 제한 |
| API Key | 환경변수 또는 Secret Manager 사용 |
| 운영 서버 접근 | 직접 접근 금지, 중간 API 사용 |
| 로그 | Tool 호출 이력 저장 |
| 승인 정책 | 위험 작업은 사용자 승인 필요 |
| 네트워크 | 내부망 MCP는 인증 필수 |
2026년 기준 MCP 관련 보안 연구에서는 권한 오남용, Tool Poisoning, Prompt Injection, 권한 상승, 공급망 공격 같은 위험이 계속 논의되고 있습니다. 특히 stdio, 파일 시스템, Git, Shell 실행형 MCP는 격리와 승인 정책을 먼저 설계해야 합니다.
6. 실무 추천 MCP 조합
개발자용
- Filesystem MCP
- GitHub MCP
- Context7 MCP
- Playwright MCP
- SQLite/PostgreSQL MCP
보안 분석용
- IP Lookup MCP
- Whois MCP
- OTX MCP
- VirusTotal MCP
- Shodan MCP
- ElasticSearch MCP
RAG 시스템용
- Filesystem MCP
- Vector DB MCP
- Document Search MCP
- MySQL/PostgreSQL MCP
- OpenAPI MCP
사내 업무 자동화용
- Slack MCP
- Gmail MCP
- Calendar MCP
- Jira MCP
- Confluence MCP
- Google Drive MCP
결론
MCP는 AI Agent를 단순 챗봇에서 실제 시스템과 함께 일하는 실행형 Agent로 바꾸는 연결 표준입니다.
가장 현실적인 도입 순서는 Filesystem MCP, GitHub MCP, DB MCP, API MCP, 사내 전용 MCP를 차례로 적용한 뒤 OpenWebUI, Codex, Cursor, Claude 같은 클라이언트에 연결하는 방식입니다.
처음부터 운영 시스템에 쓰기 권한을 열기보다 조회형 Tool, 제한된 파일 접근, 읽기 전용 DB 계정, 승인 기반 실행 정책을 먼저 구성하면 실무 적용 위험을 크게 줄일 수 있습니다.
