- Published on
MCP로 AI 생산성 올리기
- Authors
- Name
- Geurim
AI를 사용할 때 오래된 정보나 제한된 기능 때문에 불편함을 느낄 수 있습니다. MCP(Model Context Protocol) 는 이러한 한계를 해소해 AI가 외부 도구와 안전하게 연동하도록 돕는 표준 프로토콜입니다.
이 문서에서는 MCP 개념과 Cursor, Claude Desktop에서의 활용 방법을 단계별로 정리합니다.
MCP란?
MCP(Model Context Protocol) 는 AI 모델이 외부 애플리케이션, 도구, 데이터 소스와 표준화된 방식으로 상호작용하도록 지원하는 오픈 프로토콜입니다.
이를 통해 AI는 텍스트 생성뿐 아니라 다양한 리소스와 연결된 실제 작업을 수행할 수 있습니다.
MCP의 핵심 개념
1. 확장성 (Extensibility)
- 파일 시스템, 데이터베이스, API 등 다양한 리소스에 접근 가능
- 필요한 도구를 자유롭게 추가 가능
2. 표준화 (Standardization)
- 공통 프로토콜 기반으로 일관된 방식의 연동 제공
- 하나의 패턴만 익히면 다양한 MCP 서버를 활용 가능
3. 보안성 (Security)
- 샌드박스와 권한 관리 기반으로 안전한 접근 보장
- 사용자가 허용한 범위 내에서만 작업 수행
주요 구성 요소
MCP Host (호스트)
- AI 모델을 실행하는 애플리케이션 (예: Cursor, Claude Desktop)
MCP Server (서버)
- 파일 시스템·DB·API 등 특정 기능을 제공하는 프로그램
MCP Client (클라이언트)
- 호스트 내에서 MCP 서버와 통신하는 구성 요소
MCP 활용 사례
파일 시스템 작업
- 파일 읽기·쓰기·삭제
- 디렉토리 탐색 및 검색
- 코드 분석 및 리팩토링
데이터베이스 작업
- SQL 쿼리 실행
- 데이터 분석 및 보고서 생성
- 스키마 점검
웹 서비스 연동
- REST API 호출
- 정보 수집 및 처리
- 외부 서비스 자동화
개발 도구 통합
- Git 저장소 관리
- CI/CD 파이프라인 제어
- 테스트 자동화
사전 준비
- Node.js 18 이상
- Cursor IDE 또는 Claude Desktop 최신 버전
- 인터넷 연결
Node.js 버전 확인:
node --version
Cursor에서 MCP 사용하기
1단계: MCP 설정 파일 생성
전역 설정
mkdir -p ~/.cursor
touch ~/.cursor/mcp.json
프로젝트별 설정
mkdir -p .cursor
touch .cursor/mcp.json
2단계: Context7 MCP 서버 추가
mcp.json 파일에 다음 내용을 추가합니다.
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
3단계: Cursor에서 서버 활성화
- Cursor 설정 열기 (Cmd + , 또는 Ctrl + ,)
- "MCP" 검색
- "Add new global MCP server" 선택
- JSON 설정 입력 후 저장
- 서버 상태가 "Connected"로 표시되면 완료
Claude Desktop에서 MCP 사용하기
1단계: 설치
공식 페이지에서 OS에 맞는 설치 파일을 다운로드합니다.
2단계: 설정 파일 위치
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
Windows
%APPDATA%\Claude\claude_desktop_config.json
Linux
~/.config/Claude/claude_desktop_config.json
3단계: MCP 서버 추가
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
},
"sqlite": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlite", "--db-path", "/path/to/database.db"]
}
}
}
4단계: 앱 재시작
Claude Desktop을 완전히 종료한 후 다시 실행합니다.
활용 예시
1. Context7 MCP — 최신 문서 활용
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
사용 예시
JWT 토큰을 확인해 인증되지 않은 사용자를 /login으로 리다이렉트하는 Next.js 미들웨어를 만들어줘. use context7
2. 파일 시스템 MCP
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/projects"]
}
}
}
사용 예시
- 프로젝트의 TypeScript 파일에서 사용되지 않는 import 찾기
- README.md 파일 업데이트
3. SQLite MCP
{
"mcpServers": {
"sqlite": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlite", "--db-path", "./database.db"]
}
}
}
사용 예시
- 최근 30일 가입자 수 조회
- 월별 매출 분석
4. GitHub MCP
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}
사용 예시
- 최근 이슈 우선순위 분석
- PR 리뷰 보조
문제 해결
Node.js 버전 오류
nvm install 18
nvm use 18
MCP 서버 연결 실패
- 설정 경로 확인
- JSON 문법 점검
- 애플리케이션 재시작
권한 오류
chmod 755 /path/to/directory
환경 변수 누락
- 키 이름 확인
- 서버 요구사항 재확인
팁
여러 MCP 서버 조합
{
"mcpServers": {
"filesystem": { ... },
"context7": { ... },
"sqlite": { ... }
}
}
보안
- 파일 시스템 접근 경로 최소화
- API 키는 환경 변수로 관리
- 민감한 폴더는 제외
성능
- 필요 없는 서버는 비활성화
- 대규모 작업에는 제한 설정
- MCP 로그로 상태 확인
프롬프트 작성
- 사용할 MCP 서버 지정
- 파일 경로·테이블 이름 명시
- 출력 형식 지정
정리
MCP는 AI가 실제 작업 환경과 연결되어 생산성을 크게 높일 수 있도록 지원합니다.
- 반복 작업 자동화
- 외부 데이터 실시간 접근
- 파일 시스템·DB·API 등 다양한 도구와 연동
- 안전하고 표준화된 확장 구조 제공
Cursor나 Claude Desktop에 MCP를 연결해 더 강력한 AI 워크플로우를 구축해보세요.