MCP(Model Context Protocol) 입문 — AI에게 도구를 연결하는 표준

MCP란 무엇인가?

**MCP(Model Context Protocol)**는 AI 모델이 외부 도구와 데이터에 접근하는 방식을 표준화한 오픈 프로토콜입니다. Anthropic이 2024년 말에 공개했으며, AI 에이전트 생태계의 "USB 포트"와 같은 역할을 합니다.

---

왜 MCP가 필요한가?

기존 방식의 문제

사용자: "우리 회사 매출 데이터 분석해줘"
AI: "죄송합니다. 저는 외부 데이터베이스에 접근할 수 없습니다.
     데이터를 복사해서 붙여넣어 주시겠어요?"

MCP 적용 후

사용자: "우리 회사 매출 데이터 분석해줘"
AI: [MCP: PostgreSQL 연결]
    [쿼리 실행: SELECT * FROM sales WHERE year = 2026]
    "2026년 1분기 매출이 전년 대비 23% 성장했습니다.
     특히 B2B 부문에서..."

---

MCP 핵심 개념

1. MCP 서버

외부 도구나 데이터를 Claude에 노출하는 서비스입니다.

// 간단한 MCP 서버 예시
import { MCPServer } from '@anthropic-ai/mcp';

const server = new MCPServer({
  name: 'company-data',
  version: '1.0.0',
});

// 도구 정의
server.addTool({
  name: 'get_sales_data',
  description: '회사 매출 데이터를 조회합니다',
  parameters: {
    year: { type: 'number', description: '조회 연도' },
    quarter: { type: 'number', description: '분기 (1-4)' },
  },
  handler: async ({ year, quarter }) => {
    const data = await db.query(`
      SELECT * FROM sales
      WHERE year = $1 AND quarter = $2
    `, [year, quarter]);
    return data;
  },
});

server.start();

2. MCP 클라이언트

Claude Code나 다른 AI 애플리케이션이 MCP 서버에 연결하는 방식입니다.

3. 리소스 (Resources)

AI가 참조할 수 있는 데이터입니다.

server.addResource({
  uri: 'company://docs/guidelines',
  name: '회사 코딩 가이드라인',
  mimeType: 'text/markdown',
  handler: async () => {
    return fs.readFile('./CODING_GUIDELINES.md', 'utf-8');
  },
});

4. 프롬프트 (Prompts)

재사용 가능한 프롬프트 템플릿입니다.

server.addPrompt({
  name: 'code_review',
  description: '코드 리뷰 요청',
  arguments: [
    { name: 'file_path', description: '리뷰할 파일 경로' }
  ],
  handler: async ({ file_path }) => ({
    messages: [{
      role: 'user',
      content: `다음 파일을 리뷰해주세요: ${file_path}
                회사 가이드라인을 참고해서 개선점을 제안해주세요.`
    }]
  }),
});

---

Claude Code에서 MCP 사용하기

1. MCP 서버 설정

~/.claude/settings.json:

{
  "mcpServers": {
    "company-db": {
      "command": "node",
      "args": ["./mcp-servers/company-db/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://..."
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-filesystem"],
      "args": ["--root", "/home/user/projects"]
    }
  }
}

2. 연결 확인

claude /mcp

# 출력:
# Connected MCP Servers:
# ✓ company-db (3 tools, 2 resources)
# ✓ github (5 tools)
# ✓ filesystem (4 tools)

3. 사용 예시

You: GitHub에서 최근 열린 이슈들을 확인하고,
     company-db에서 관련 고객 정보를 찾아줘

Claude: [MCP: github.list_issues]
        [MCP: company-db.search_customers]

        최근 3개 이슈를 확인했습니다:
        1. #142 결제 오류 - 고객: ABC Corp (VIP)
        2. #141 로그인 문제 - 고객: XYZ Inc (일반)
        ...

---

공식 MCP 서버 목록

Anthropic과 커뮤니티에서 제공하는 MCP 서버들:

서버	설명	설치
mcp-server-filesystem	파일 시스템 접근	npx @anthropic-ai/mcp-server-filesystem
mcp-server-github	GitHub API 연동	npx @anthropic-ai/mcp-server-github
mcp-server-postgres	PostgreSQL 쿼리	npx @anthropic-ai/mcp-server-postgres
mcp-server-sqlite	SQLite 데이터베이스	npx @anthropic-ai/mcp-server-sqlite
mcp-server-slack	Slack 메시지	npx @anthropic-ai/mcp-server-slack
mcp-server-google-drive	Google Drive 파일	npx @anthropic-ai/mcp-server-gdrive
mcp-server-notion	Notion 페이지	npx @anthropic-ai/mcp-server-notion

---

커스텀 MCP 서버 만들기

프로젝트 설정

mkdir my-mcp-server && cd my-mcp-server
npm init -y
npm install @anthropic-ai/mcp zod

기본 구조

// index.ts
import { MCPServer, z } from '@anthropic-ai/mcp';

const server = new MCPServer({
  name: 'my-custom-server',
  version: '1.0.0',
});

// 날씨 정보 도구
server.addTool({
  name: 'get_weather',
  description: '특정 도시의 현재 날씨를 조회합니다',
  parameters: z.object({
    city: z.string().describe('도시 이름'),
  }),
  handler: async ({ city }) => {
    const response = await fetch(
      `https://api.weather.com/v1/current?city=${city}`
    );
    return response.json();
  },
});

// 서버 시작
server.start({ transport: 'stdio' });

테스트

# 로컬 테스트
npx @anthropic-ai/mcp-inspector ./index.ts

---

보안 고려사항

1. 권한 최소화

{
  "mcpServers": {
    "database": {
      "command": "...",
      "permissions": {
        "read": true,
        "write": false,
        "delete": false
      }
    }
  }
}

2. 환경 변수 관리

# .env 파일 사용 (Git 제외)
DATABASE_URL=postgresql://...
API_KEY=sk-...

# Claude 설정에서 참조
"env": {
  "DATABASE_URL": "${DATABASE_URL}"
}

3. 감사 로깅

server.use(async (ctx, next) => {
  console.log(`[${new Date().toISOString()}] Tool: ${ctx.tool}`);
  await next();
});

---

다음 단계

MCP를 이해했다면, 다음 편에서 Vibe Coding을 통해 AI와 자연스럽게 협업하는 워크플로우를 배워보겠습니다. 단순한 질문-응답을 넘어, AI를 진정한 페어 프로그래밍 파트너로 활용하는 방법을 알아봅니다.