들어가며: AI가 내 파일을 못 읽는다고?
2025년 12월 3일, 저는 Cursor에게 이렇게 물었습니다.
나: "내 Github 레포에서 가장 많이 수정한 파일 3개 알려줘"
AI: "죄송하지만 Github에 접근할 수 없습니다."
“뭐야, AI가 이것도 못해?”
분명 유튜브에서는 AI가 파일 시스템을 읽고, 캘린더를 확인하고, 심지어 Slack 메시지까지 보낸다고 했는데요.
알고 보니 제가 ‘안경’을 안 씌워준 거였습니다.
그 안경의 이름이 바로 **MCP (Model Context Protocol)**입니다.
MCP가 뭐길래? (초보자도 이해하는 비유)
AI는 원래 ‘장님’입니다
충격적인 사실:
- ChatGPT는 여러분의 컴퓨터 파일을 못 봅니다
- Cursor AI도 기본적으로 프로젝트 폴더 밖은 모릅니다
- Claude도 여러분의 Google Calendar를 모릅니다
왜? 보안 때문입니다. AI가 마음대로 파일을 읽으면 위험하니까요.
MCP = AI에게 씌워주는 안경
**MCP (Model Context Protocol)**는 Anthropic(Claude 만든 회사)이 만든 표준 프로토콜입니다.
쉽게 말하면:
AI: "저 장님이에요. 아무것도 안 보여요."
MCP: "이 안경 쓰세요. 이제 Github도 보이고, 파일도 보이고, 캘린더도 보입니다."
AI: "오! 이제 보이네요!"
기술적으로 말하면:
- AI와 외부 데이터 소스를 안전하게 연결하는 표준
- Github, Google Calendar, Notion, Slack 등 모든 서비스 연결 가능
- 보안 권한을 사용자가 직접 제어
Table of contents
Open Table of contents
1. MCP의 작동 원리 (비유로 이해하기)
1.1 전통적인 AI의 한계
Before MCP:
나: "내 Github 레포 분석해줘"
AI: "Github API 토큰을 주세요"
나: (토큰 복사 → 붙여넣기)
AI: "레포 이름을 주세요"
나: "mj-oneinamillion/fast-trend"
AI: "분석 완료!"
[다음날]
나: "어제 분석한 레포 업데이트 있어?"
AI: "무슨 레포요? 다시 토큰 주세요"
문제점:
- 매번 토큰을 수동으로 입력
- AI가 컨텍스트를 기억 못함
- 여러 서비스 연결 시 복잡도 폭발
1.2 MCP의 혁신
After MCP:
나: "내 Github 레포 분석해줘"
AI: [MCP를 통해 자동으로 Github 연결] "fast-trend 레포 분석 완료!"
[다음날]
나: "어제 분석한 레포 업데이트 있어?"
AI: [MCP로 자동 확인] "3개 파일이 수정되었습니다."
장점:
- ✅ 한 번 설정하면 영구적
- ✅ AI가 자동으로 데이터 접근
- ✅ 여러 서비스 동시 연결 가능
1.3 MCP 아키텍처 (간단 버전)
┌─────────────┐
│ Cursor │ ← 여러분이 사용하는 AI 에디터
└──────┬──────┘
│
▼
┌─────────────┐
│ MCP Server │ ← 중간 다리 역할
└──────┬──────┘
│
├─────→ Github API
├─────→ Google Calendar API
├─────→ Notion API
└─────→ 파일 시스템
핵심: MCP Server가 AI와 외부 세계를 안전하게 연결합니다.
2. Cursor에서 MCP 설정하기 (실전 가이드)
2.1 사전 준비물
필수:
- ✅ Cursor 에디터 (최신 버전)
- ✅ Node.js 18 이상
- ✅ Github 계정
선택:
- Google Calendar API 키 (일정 연동 시)
- Notion API 키 (노션 연동 시)
설치 확인:
# Node.js 버전 확인
node --version
# v18.0.0 이상이어야 함
# Cursor 버전 확인
# Cursor → About Cursor → Version 0.40.0 이상
2.2 MCP 서버 설치 (3분 완성)
Step 1: MCP 설정 파일 생성
Cursor는 ~/.cursor/mcp.json 파일로 MCP를 관리합니다.
# 설정 폴더 생성
mkdir -p ~/.cursor
# 설정 파일 생성
touch ~/.cursor/mcp.json
Step 2: 기본 설정 작성
~/.cursor/mcp.json 파일을 열고 아래 내용 입력:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/YOUR_USERNAME/workspace"
]
}
}
}
⚠️ 주의: YOUR_USERNAME을 실제 사용자명으로 변경하세요!
확인 방법:
# macOS/Linux
echo $HOME
# 출력: /Users/minjeongkim
# Windows
echo %USERPROFILE%
# 출력: C:\Users\minjeongkim
Step 3: Cursor 재시작
Cursor 완전 종료 (Cmd+Q) → 다시 실행
2.3 MCP 작동 확인
Cursor Chat (Cmd+L)에서 테스트:
나: "내 workspace 폴더에 있는 프로젝트 목록 알려줘"
성공 시:
AI: "workspace 폴더에 다음 프로젝트가 있습니다:
1. fast-trend (블로그 프로젝트)
2. my-app (Next.js 앱)
3. python-scripts (자동화 스크립트)"
실패 시:
AI: "파일 시스템에 접근할 수 없습니다."
→ 2.2 단계 다시 확인 (경로 오타, Cursor 재시작 여부)
3. Github 연동하기 (핵심 기능)
3.1 Github MCP 서버 설정
Step 1: Github Personal Access Token 생성
- Github 로그인 → Settings 클릭
- 왼쪽 메뉴 맨 아래 Developer settings 클릭
- Personal access tokens → Tokens (classic) 클릭
- Generate new token (classic) 클릭
- 권한 선택:
- ✅
repo(전체 선택) - ✅
read:org - ✅
read:user
- ✅
- Generate token 클릭
- 토큰 복사 (⚠️ 다시 볼 수 없으니 안전한 곳에 저장!)
Step 2: 환경 변수 설정
# macOS/Linux
echo 'export GITHUB_TOKEN="ghp_your_token_here"' >> ~/.zshrc
source ~/.zshrc
# Windows (PowerShell)
[System.Environment]::SetEnvironmentVariable('GITHUB_TOKEN', 'ghp_your_token_here', 'User')
Step 3: MCP 설정 파일 업데이트
~/.cursor/mcp.json 파일 수정:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/YOUR_USERNAME/workspace"
]
},
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}
⚠️ 보안 주의:
- 토큰을 직접 파일에 넣는 대신 환경 변수 사용 권장:
"env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
Step 4: Cursor 재시작
Cmd+Q → Cursor 다시 실행
3.2 Github 연동 테스트
Cursor Chat에서:
나: "내 Github 레포 목록 보여줘"
성공 시:
AI: "다음 레포지토리가 있습니다:
1. mj-oneinamillion/fast-trend (블로그)
2. mj-oneinamillion/my-app (Next.js 앱)
3. mj-oneinamillion/python-scripts (자동화)"
고급 테스트:
나: "fast-trend 레포에서 최근 1주일간 수정된 파일 분석해줘"
AI: "최근 1주일간 수정된 파일:
1. src/data/blog/cursor-vibe-coding-settings-guide.md (15회 수정)
2. src/components/Header.tsx (3회 수정)
3. package.json (2회 수정)
가장 활발한 작업: 블로그 포스트 작성"
실전 활용:
나: "fast-trend 레포의 미해결 이슈 요약해줘"
AI: "미해결 이슈 3개:
1. #12: 다크모드 토글 버그 (라벨: bug)
2. #10: SEO 메타태그 추가 (라벨: enhancement)
3. #8: 댓글 기능 구현 (라벨: feature)
우선순위: #12 (버그) → #10 (SEO) → #8 (기능)"
4. Google Calendar 연동하기 (일정 브리핑)
4.1 Google Calendar API 설정
Step 1: Google Cloud Console 설정
- Google Cloud Console 접속
- 새 프로젝트 생성 → 이름: “Cursor MCP”
- API 및 서비스 → 라이브러리 클릭
- “Google Calendar API” 검색 → 사용 설정 클릭
- 사용자 인증 정보 → 사용자 인증 정보 만들기 → OAuth 클라이언트 ID
- 애플리케이션 유형: 데스크톱 앱
- 만들기 → JSON 다운로드
Step 2: 인증 파일 저장
# 다운로드한 JSON 파일을 안전한 위치로 이동
mkdir -p ~/.cursor/credentials
mv ~/Downloads/client_secret_*.json ~/.cursor/credentials/google_calendar.json
Step 3: MCP 설정 업데이트
~/.cursor/mcp.json:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/YOUR_USERNAME/workspace"
]
},
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
},
"google-calendar": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-google-calendar"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/Users/YOUR_USERNAME/.cursor/credentials/google_calendar.json"
}
}
}
}
4.2 일정 브리핑 실전 활용
Cursor 재시작 후 테스트:
나: "오늘 내 일정 브리핑해 줘"
AI 응답:
오늘 일정 (2026년 1월 10일 금요일):
🌅 오전
- 09:00-10:00: 팀 스탠드업 미팅 (Zoom)
- 10:30-12:00: 블로그 포스트 작성 (집중 시간)
🌆 오후
- 14:00-15:30: 클라이언트 미팅 (강남역 스타벅스)
- 16:00-17:00: 코드 리뷰
📌 중요 알림:
- 클라이언트 미팅 30분 전 출발 권장 (교통 혼잡 예상)
- 코드 리뷰 전 PR #15 확인 필요
고급 활용:
나: "이번 주 남은 일정 중 개발 관련 일정만 추출해줘"
AI: "이번 주 개발 관련 일정:
1월 10일 (금):
- 16:00-17:00: 코드 리뷰
1월 11일 (토):
- 10:00-12:00: 개인 프로젝트 (Next.js 앱 배포)
1월 12일 (일):
- 14:00-16:00: 알고리즘 스터디
총 6시간 확보됨. 우선순위: 코드 리뷰 > 앱 배포 > 스터디"
5. 실전 시나리오: MCP로 생산성 10배 올리기
5.1 아침 루틴 자동화
매일 아침 Cursor에서:
나: "오늘 브리핑"
AI가 자동으로:
- Google Calendar에서 오늘 일정 확인
- Github에서 어제 커밋 내역 요약
- 미해결 이슈 우선순위 정렬
- 오늘 집중할 작업 추천
실제 응답 예시:
📅 오늘 일정: 3개 미팅, 4시간 개발 시간 확보
💻 어제 작업:
- fast-trend 레포: 블로그 포스트 2개 추가
- my-app 레포: 로그인 기능 구현 (커밋 3개)
🐛 미해결 이슈:
1. fast-trend #12 (버그): 다크모드 토글 - 30분 예상
2. my-app #5 (기능): 댓글 기능 - 2시간 예상
✅ 오늘 추천 작업:
1. 오전: fast-trend #12 버그 수정 (미팅 전 완료 가능)
2. 오후: my-app #5 댓글 기능 시작 (4시간 집중 시간 활용)
5.2 프로젝트 상태 점검
나: "fast-trend 프로젝트 건강 체크"
AI 분석:
🏥 프로젝트 건강 진단: fast-trend
📊 코드 활동:
- 최근 7일: 커밋 15개, 파일 수정 23개
- 가장 활발한 파일: src/data/blog/*.md (블로그 포스트)
- 코드 변경률: +1,234 / -456 줄
🐛 이슈 현황:
- 열린 이슈: 3개 (버그 1, 기능 2)
- 평균 해결 시간: 2.5일
- 오래된 이슈: #8 (14일 경과) ⚠️
📦 의존성:
- 업데이트 필요: next (14.0.4 → 14.1.0)
- 보안 취약점: 0개 ✅
💡 권장 사항:
1. 이슈 #8 우선 처리 (2주 경과)
2. Next.js 업데이트 (마이너 버전)
3. 블로그 포스트 작성 속도 유지 (좋은 흐름!)
5.3 코드 리뷰 자동화
나: "PR #15 리뷰해줘"
AI가 Github에서 PR 가져와서 분석:
🔍 PR #15 리뷰: "댓글 기능 추가"
📝 변경 사항:
- 파일 수정: 5개 (components/Comment.tsx, api/comments.ts 등)
- 추가: +234 줄
- 삭제: -12 줄
✅ 좋은 점:
1. TypeScript 타입 정의 완벽
2. 에러 핸들링 포함
3. 낙관적 업데이트 구현
⚠️ 개선 필요:
1. Comment.tsx 라인 45: 하드코딩된 API URL
→ 환경 변수로 이동 권장
2. api/comments.ts 라인 23: SQL Injection 취약점 가능성
→ Prisma Prepared Statement 사용 권장
3. 테스트 코드 누락
→ 최소한 댓글 작성/삭제 테스트 추가 필요
📊 복잡도: 중간 (7/10)
🎯 머지 권장: 위 3가지 수정 후 승인
5.4 일정 기반 작업 추천
나: "이번 주 일정 보고 개발 계획 세워줘"
AI가 Calendar + Github 통합 분석:
📅 이번 주 개발 계획 (1월 10일 - 1월 16일)
🕐 가용 시간 분석:
- 총 개발 가능 시간: 18시간
- 집중 시간 (2시간 이상 연속): 4블록
📋 우선순위 작업:
1. fast-trend #12 (버그 수정) - 30분
→ 금요일 오전 (미팅 전)
2. my-app #5 (댓글 기능) - 4시간
→ 금요일 오후 (4시간 집중 블록)
3. fast-trend #10 (SEO 개선) - 2시간
→ 토요일 오전 (개인 프로젝트 시간)
4. 알고리즘 스터디 준비 - 2시간
→ 일요일 오전
⚡ 효율 팁:
- 금요일 오후 4시간 블록이 이번 주 최대 집중 시간
→ 가장 복잡한 작업(댓글 기능)에 할당
- 토요일/일요일 오전은 짧은 작업에 적합
→ 버그 수정, SEO 개선 등
6. 고급 활용: 나만의 MCP 서버 만들기
6.1 Custom MCP 서버 개념
기본 MCP 서버로 부족할 때:
- Notion 데이터베이스 연동
- Slack 메시지 자동 전송
- 회사 내부 API 연동
해결책: 직접 MCP 서버 만들기!
6.2 간단한 MCP 서버 예제 (Notion 연동)
Step 1: 프로젝트 생성
mkdir my-notion-mcp
cd my-notion-mcp
npm init -y
npm install @modelcontextprotocol/sdk notion-client
Step 2: 서버 코드 작성
index.js:
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { Client } from '@notionhq/client';
// Notion 클라이언트 초기화
const notion = new Client({ auth: process.env.NOTION_TOKEN });
// MCP 서버 생성
const server = new Server({
name: 'notion-mcp',
version: '1.0.0',
}, {
capabilities: {
resources: {},
tools: {},
},
});
// 도구 정의: Notion 페이지 목록 가져오기
server.setRequestHandler('tools/list', async () => {
return {
tools: [
{
name: 'list_notion_pages',
description: 'Notion 데이터베이스의 페이지 목록 가져오기',
inputSchema: {
type: 'object',
properties: {
database_id: {
type: 'string',
description: 'Notion 데이터베이스 ID',
},
},
required: ['database_id'],
},
},
],
};
});
// 도구 실행: Notion 페이지 목록
server.setRequestHandler('tools/call', async (request) => {
if (request.params.name === 'list_notion_pages') {
const { database_id } = request.params.arguments;
const response = await notion.databases.query({
database_id: database_id,
});
const pages = response.results.map(page => ({
id: page.id,
title: page.properties.Name?.title[0]?.plain_text || '제목 없음',
created: page.created_time,
}));
return {
content: [
{
type: 'text',
text: JSON.stringify(pages, null, 2),
},
],
};
}
});
// 서버 시작
async function main() {
const transport = new StdioServerTransport();
await server.connect(transport);
}
main().catch(console.error);
Step 3: MCP 설정에 추가
~/.cursor/mcp.json:
{
"mcpServers": {
"notion": {
"command": "node",
"args": [
"/Users/YOUR_USERNAME/my-notion-mcp/index.js"
],
"env": {
"NOTION_TOKEN": "secret_your_notion_token"
}
}
}
}
Step 4: Cursor에서 테스트
나: "내 Notion 데이터베이스 (ID: abc123) 페이지 목록 보여줘"
AI 응답:
Notion 페이지 목록:
1. "블로그 아이디어" (2026-01-05 생성)
2. "프로젝트 로드맵" (2026-01-03 생성)
3. "학습 자료" (2026-01-01 생성)
7. 주의사항 및 트러블슈팅
7.1 보안 체크리스트
⚠️ 절대 하지 말아야 할 것:
// ❌ 나쁜 예: 토큰을 설정 파일에 직접 노출
{
"mcpServers": {
"github": {
"env": {
"GITHUB_TOKEN": "ghp_1234567890abcdef"
}
}
}
}
// ✅ 좋은 예: 환경 변수 사용
{
"mcpServers": {
"github": {
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
필수 보안 조치:
- ✅ API 토큰은 환경 변수로 관리
- ✅
mcp.json파일은.gitignore에 추가 - ✅ 최소 권한 원칙 (필요한 권한만 부여)
- ✅ 정기적으로 토큰 갱신
7.2 흔한 에러 해결법
에러 1: “MCP server not found”
증상:
AI: "MCP 서버에 연결할 수 없습니다."
해결:
# 1. Node.js 버전 확인
node --version
# v18.0.0 이상이어야 함
# 2. MCP 패키지 수동 설치
npx -y @modelcontextprotocol/server-filesystem
# 3. Cursor 완전 재시작
# Cmd+Q → 다시 실행
에러 2: “Permission denied”
증상:
AI: "파일 시스템 접근 권한이 없습니다."
해결:
# macOS: Cursor에 전체 디스크 접근 권한 부여
System Settings → Privacy & Security → Full Disk Access
→ Cursor 추가
# 또는 경로 권한 확인
ls -la /Users/YOUR_USERNAME/workspace
# drwxr-xr-x 여야 함
에러 3: “Github API rate limit”
증상:
AI: "Github API 요청 한도를 초과했습니다."
해결:
# 1. 인증된 요청 사용 (시간당 5,000회)
# Personal Access Token 확인
# 2. 캐싱 활용
# Cursor Settings → MCP → Enable Caching
# 3. 요청 최소화
# 불필요한 대규모 레포 스캔 자제
7.3 성능 최적화
문제: MCP 응답이 느림
해결:
// ~/.cursor/mcp.json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/YOUR_USERNAME/workspace"
],
"timeout": 30000, // 타임아웃 30초로 증가
"cache": true // 캐싱 활성화
}
}
}
추가 팁:
- 큰 레포는
.gitignore로 제외 node_modules,.next등 빌드 폴더 제외- 필요한 폴더만 MCP 경로에 포함
8. 실무 팁 (Best Practices)
8.1 MCP 서버 조합 전략
초보자 추천 조합:
{
"mcpServers": {
"filesystem": { ... }, // 로컬 파일 접근
"github": { ... } // Github 연동
}
}
중급자 추천 조합:
{
"mcpServers": {
"filesystem": { ... },
"github": { ... },
"google-calendar": { ... }, // 일정 관리
"notion": { ... } // 노트 연동
}
}
고급자 추천 조합:
{
"mcpServers": {
"filesystem": { ... },
"github": { ... },
"google-calendar": { ... },
"notion": { ... },
"slack": { ... }, // 팀 커뮤니케이션
"jira": { ... }, // 이슈 트래킹
"custom-api": { ... } // 회사 내부 API
}
}
8.2 프롬프트 템플릿
일일 브리핑
오늘 브리핑:
1. Google Calendar에서 오늘 일정
2. Github에서 어제 커밋 요약
3. 미해결 이슈 우선순위
4. 오늘 집중할 작업 추천
주간 리뷰
이번 주 리뷰:
1. Github 활동 통계 (커밋, PR, 이슈)
2. 완료한 작업 목록
3. 다음 주 계획 제안
4. 개선 필요 영역
프로젝트 건강 체크
[프로젝트명] 건강 체크:
1. 코드 활동 분석 (최근 7일)
2. 이슈 현황 (열린/닫힌)
3. 의존성 업데이트 필요 여부
4. 권장 사항
8.3 팀 협업 가이드
공유 MCP 설정:
# 프로젝트 루트에 .cursor-mcp.json 생성
# (개인 토큰은 제외)
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"${PROJECT_ROOT}"
]
},
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
팀원 온보딩:
# MCP 설정 가이드 (팀 내부용)
## 1. 환경 변수 설정
- GITHUB_TOKEN: [팀 리더에게 요청]
- NOTION_TOKEN: [노션 워크스페이스 관리자에게 요청]
## 2. MCP 설정 파일 복사
cp .cursor-mcp.json ~/.cursor/mcp.json
## 3. 개인 토큰 추가
~/.cursor/mcp.json 파일에서 ${GITHUB_TOKEN} 등을 실제 값으로 교체
## 4. Cursor 재시작
9. 자주 묻는 질문 (FAQ)
Q1. MCP는 무료인가요?
A: MCP 자체는 완전 무료입니다!
- ✅ MCP 프로토콜: 오픈소스 (MIT 라이선스)
- ✅ 기본 MCP 서버들: 무료
- ⚠️ 외부 API 비용은 별도 (Github, Google Calendar 등)
예시:
- Github API: 무료 (시간당 5,000 요청)
- Google Calendar API: 무료 (일일 1,000,000 요청)
- Notion API: 무료 (Rate limit 있음)
Q2. Cursor Pro 없이도 MCP 사용 가능한가요?
A: 네, 가능합니다!
- MCP는 Cursor 무료 플랜에서도 작동
- 단, AI 요청 횟수는 플랜에 따라 제한
- 무료: 월 2,000회 (GPT-3.5)
- Pro: GPT-4 무제한
권장: MCP 설정 후 무료로 테스트 → 만족하면 Pro 구독
Q3. 보안이 걱정됩니다. 안전한가요?
A: 올바르게 설정하면 안전합니다.
MCP의 보안 원칙:
- ✅ 모든 데이터는 로컬에서 처리
- ✅ AI 요청만 외부로 전송 (OpenAI/Anthropic)
- ✅ API 토큰은 사용자가 직접 관리
- ✅ 권한은 최소 권한 원칙 적용
추가 보안 조치:
// 읽기 전용 권한만 부여
{
"mcpServers": {
"github": {
"env": {
"GITHUB_TOKEN": "ghp_readonly_token"
}
}
}
}
Q4. MCP와 Copilot의 차이는?
A: 역할이 다릅니다.
| 기능 | Copilot | MCP |
|---|---|---|
| 목적 | 코드 자동완성 | 외부 데이터 연결 |
| 범위 | 현재 파일 | 전체 시스템 |
| 데이터 소스 | 학습 데이터 | 실시간 API |
| 사용 예 | ”함수 자동완성" | "Github 이슈 분석” |
결론: 둘 다 사용하면 시너지 효과!
Q5. 어떤 서비스를 MCP로 연결할 수 있나요?
A: 거의 모든 서비스!
공식 MCP 서버:
- ✅ Github
- ✅ Google Calendar
- ✅ Google Drive
- ✅ Slack
- ✅ Notion
- ✅ 파일 시스템
커뮤니티 MCP 서버:
- Jira
- Trello
- Asana
- Linear
- Figma
- 등등…
직접 만들기:
- REST API가 있는 모든 서비스
- 회사 내부 시스템
- 데이터베이스
찾는 방법:
# NPM에서 검색
npm search @modelcontextprotocol
# Github에서 검색
https://github.com/search?q=mcp+server
Q6. MCP 설정이 복잡한데 더 쉬운 방법은?
A: GUI 도구를 사용하세요!
MCP Manager (비공식 도구):
npm install -g mcp-manager
mcp-manager
기능:
- 🖱️ GUI로 MCP 서버 추가/제거
- 🔑 토큰 안전 관리
- 🧪 연결 테스트
- 📋 설정 파일 자동 생성
또는 템플릿 사용:
# Github에서 템플릿 다운로드
git clone https://github.com/awesome-mcp/cursor-templates
cd cursor-templates
./setup.sh
10. 실전 경험담: MCP로 달라진 내 하루
10.1 Before MCP (2025년 11월)
아침 루틴:
08:00 - 출근
08:10 - Google Calendar 열어서 오늘 일정 확인
08:15 - Github 열어서 어제 커밋 확인
08:20 - Notion 열어서 할 일 목록 확인
08:25 - Slack 열어서 메시지 확인
08:30 - 드디어 코딩 시작...
총 소요 시간: 30분
10.2 After MCP (2025년 12월)
아침 루틴:
08:00 - 출근
08:01 - Cursor 열고 "오늘 브리핑" 입력
08:02 - AI가 일정, 커밋, 할 일, 메시지 모두 요약
08:03 - 바로 코딩 시작!
총 소요 시간: 3분
절약된 시간: 27분 × 주 5일 = 주당 2시간 15분!
10.3 실제 사용 사례
사례 1: 긴급 버그 수정
[금요일 오후 5시, 퇴근 직전]
나: "fast-trend 레포에서 오늘 배포 후 발생한 이슈 있어?"
AI: "이슈 #15가 30분 전 생성되었습니다.
제목: '다크모드 토글 시 화면 깜빡임'
라벨: bug, priority-high
보고자: @user123
관련 커밋: 3a7f9b2 (오늘 오후 2시 배포)
변경 파일: src/components/ThemeToggle.tsx
원인 추정: CSS transition 누락"
나: "해당 파일 열고 수정 방법 알려줘"
AI: [파일 열기 + 수정 제안]
[5분 만에 수정 완료, 퇴근!]
사례 2: 프로젝트 회고
[월말, 프로젝트 회고 미팅 준비]
나: "이번 달 fast-trend 프로젝트 활동 요약해줘"
AI: "2025년 12월 활동 요약:
📊 통계:
- 커밋: 47개 (전월 대비 +23%)
- PR: 12개 (평균 머지 시간: 1.2일)
- 이슈: 15개 생성, 13개 해결 (해결률: 87%)
👨💻 기여자:
1. @minjeongkim: 38 커밋 (81%)
2. @contributor1: 6 커밋 (13%)
3. @contributor2: 3 커밋 (6%)
🔥 주요 성과:
- 블로그 포스트 10개 추가
- SEO 최적화 완료
- 다크모드 구현
- 페이지 로딩 속도 40% 개선
⚠️ 개선 필요:
- 테스트 커버리지: 45% (목표: 80%)
- 오래된 이슈 2개 (30일 이상)
💡 다음 달 제안:
1. 테스트 코드 작성 집중
2. 오래된 이슈 정리
3. 성능 모니터링 도구 도입"
[회고 자료 10분 만에 완성!]
사례 3: 일정 기반 작업 계획
[월요일 아침, 이번 주 계획 세우기]
나: "이번 주 일정 보고 개발 계획 세워줘.
우선순위: fast-trend #12 (버그) > my-app #5 (기능)"
AI: "이번 주 최적 개발 계획:
📅 월요일 (오늘):
- 09:00-10:00: 팀 미팅
- 10:00-12:00: fast-trend #12 버그 수정 ✅ (2시간 집중)
- 14:00-15:00: 코드 리뷰
- 15:00-17:00: my-app #5 기능 시작 (2시간)
📅 화요일:
- 09:00-12:00: 클라이언트 미팅 (개발 시간 없음)
- 14:00-18:00: my-app #5 기능 계속 (4시간 집중) ✅
📅 수요일:
- 10:00-12:00: my-app #5 마무리 (2시간)
- 14:00-17:00: 테스트 및 PR 작성 (3시간)
⚡ 핵심 전략:
- 버그 수정은 월요일 오전 집중 시간에 완료
- 기능 개발은 화요일 오후 4시간 블록 활용
- 수요일에 여유 시간 확보 (예상치 못한 이슈 대비)
✅ 실행 가능성: 높음 (총 13시간 확보, 필요 시간 11시간)"
[계획 수립 5분 완성, 바로 실행!]
결론: MCP는 AI의 ‘슈퍼파워’입니다
핵심 요약
MCP = AI에게 안경 씌워주기
- 설정 한 번:
~/.cursor/mcp.json파일 작성 - 영구 효과: 모든 프로젝트에서 자동 작동
- 무한 확장: Github, Calendar, Notion, Slack 등 모든 서비스 연결
실질적 이점
- ⏱️ 시간 절약: 하루 30분 → 주당 2.5시간
- 🧠 인지 부하 감소: 여러 앱 전환 불필요
- 🚀 생산성 향상: AI가 컨텍스트를 완벽히 이해
- 📊 데이터 기반 의사결정: 실시간 프로젝트 분석
시작 가이드 (3단계)
오늘 (10분):
~/.cursor/mcp.json파일 생성- 파일 시스템 MCP 서버 설정
- Cursor 재시작 → 테스트
이번 주 (30분):
- Github Personal Access Token 생성
- Github MCP 서버 추가
- “내 레포 분석해줘” 테스트
이번 달 (1시간):
- Google Calendar 연동
- “오늘 브리핑” 루틴 만들기
- 팀원들에게 공유
마지막 조언
MCP는 마법이 아닙니다.
- ❌ AI가 모든 걸 알아서 하지 않습니다
- ✅ 하지만 AI가 올바른 정보에 접근하게 해줍니다
비유:
- MCP 없는 AI = 눈 가린 천재
- MCP 있는 AI = 눈 뜬 천재
여러분의 선택은?
추가 학습 자료
MCP 공식 리소스:
질문이나 피드백은 댓글로 남겨주세요! 🚀
부록: MCP 서버 목록
공식 MCP 서버
| 서버 | 기능 | 설치 명령 |
|---|---|---|
| filesystem | 로컬 파일 접근 | @modelcontextprotocol/server-filesystem |
| github | Github API 연동 | @modelcontextprotocol/server-github |
| google-calendar | Google Calendar 연동 | @modelcontextprotocol/server-google-calendar |
| google-drive | Google Drive 연동 | @modelcontextprotocol/server-google-drive |
| slack | Slack 메시지 연동 | @modelcontextprotocol/server-slack |
커뮤니티 MCP 서버
| 서버 | 기능 | Github |
|---|---|---|
| notion-mcp | Notion 데이터베이스 | 링크 |
| jira-mcp | Jira 이슈 트래킹 | 링크 |
| linear-mcp | Linear 프로젝트 관리 | 링크 |
| figma-mcp | Figma 디자인 파일 | 링크 |
더 많은 서버: awesome-mcp