클로드 코워크 MCP 연동

MCP 연동하면 클로드가 달라진다 — 코워크 MCP 완전 세팅 가이드

작성자:

클로드 코워크(Claude Cowork)에 MCP(Model Context Protocol)를 연동하는 순간, AI는 단순 대화 도구에서 실제 업무 실행 머신으로 전환된다. 파일 읽기, 웹 검색, 데이터베이스 조회, 외부 API 호출까지 — MCP가 없으면 클로드는 텍스트만 다루지만, MCP가 있으면 실제 시스템을 직접 조작한다.

MCP가 뭔지 모르면 클로드를 절반만 쓰는 것이다

MCP는 Anthropic이 2024년 공개한 오픈 프로토콜이다. AI 모델이 외부 도구와 데이터 소스에 표준화된 방식으로 접근할 수 있도록 설계됐다. USB 표준처럼, 어떤 서버든 MCP 규격을 따르면 클로드와 바로 연결된다.

클로드 코워크 환경에서 MCP를 연동하면 다음이 가능해진다:

  • 로컬 파일 시스템 직접 읽기·쓰기
  • Notion, Google Drive, GitHub 실시간 연동
  • 웹 검색 결과를 컨텍스트에 자동 삽입
  • DB 쿼리 실행 후 결과 즉시 분석
  • 슬랙·이메일 자동 발송

설치 전에 반드시 확인해야 할 3가지

MCP 연동 실패의 90%는 환경 설정 누락에서 발생한다. 시작 전 체크리스트를 확인하자.

항목 확인 내용 비고
Node.js 버전 18.x 이상 필수 node -v 로 확인
Claude Code CLI 최신 버전 설치 여부 npm update -g @anthropic-ai/claude-code
인터넷 연결 MCP 서버 레지스트리 접근 필요 방화벽 예외 처리 필요할 수 있음

공식 MCP 서버 5종 — 실무에서 가장 많이 쓰는 것만

Anthropic이 공식 지원하는 MCP 서버 중 실무 활용도가 높은 5종을 정리했다.

MCP 서버 기능 설치 명령
filesystem 로컬 파일 읽기/쓰기 npx @modelcontextprotocol/server-filesystem
brave-search 실시간 웹 검색 npx @modelcontextprotocol/server-brave-search
github GitHub 레포 연동 npx @modelcontextprotocol/server-github
postgres PostgreSQL DB 조회 npx @modelcontextprotocol/server-postgres
slack 슬랙 메시지 전송 npx @modelcontextprotocol/server-slack

클로드 코워크에 MCP 연동하는 정확한 순서

Claude Code 환경 기준으로 MCP를 연결하는 방법은 두 가지다. 첫 번째는 claude mcp add CLI 명령, 두 번째는 .claude/settings.json 직접 편집이다. 초보자에게는 CLI가 안전하다.

Step 1 — CLI로 MCP 서버 추가

터미널에서 아래 명령을 실행한다. filesystem 서버를 예시로 든다:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /원하는/경로

Step 2 — 연결 확인

Claude Code를 재시작한 뒤 /mcp 명령으로 연결된 서버 목록을 확인한다. 서버 이름 옆에 초록 점이 뜨면 정상 연결이다.

Step 3 — 실제 사용 테스트

Claude Code 채팅창에 “내 데스크탑의 파일 목록을 알려줘”라고 입력한다. MCP가 정상 연동됐다면 클로드가 실제 파일 목록을 읽어 답변한다. 연동 전이라면 이 요청은 실행 불가하다.

settings.json으로 직접 편집하는 고급 방법

여러 MCP 서버를 한 번에 등록하거나 환경변수를 주입해야 할 때는 settings.json을 직접 편집한다. 파일 위치는 프로젝트 루트의 .claude/settings.json이다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Desktop"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "여기에_API_키_입력"
      }
    }
  }
}

Brave Search MCP는 무료 API 키 발급이 필요하다. Brave Search API 공식 페이지에서 월 2,000건 무료 플랜을 이용할 수 있다.

MCP 연동 시 자주 발생하는 오류 3가지와 해결법

오류 메시지 원인 해결법
MCP server not found 서버 이름 오타 또는 미설치 claude mcp list 로 등록 서버 재확인
Permission denied 파일시스템 접근 권한 부족 접근 가능한 경로로 변경
API key invalid 환경변수 미주입 settings.json env 항목에 키 직접 삽입

MCP 연동 후 달라지는 실제 업무 자동화 시나리오 3가지

실무에서 바로 적용 가능한 자동화 시나리오다.

시나리오 1 — 일일 업무 리포트 자동 생성
filesystem MCP로 프로젝트 폴더를 읽고, 전날 수정된 파일 목록과 변경 내용을 요약해 슬랙으로 자동 전송. 별도 리포팅 도구 없이 클로드 하나로 해결된다.

시나리오 2 — 실시간 리서치 + 문서화
Brave Search MCP로 특정 키워드를 검색하고, 결과를 정리해 Notion MCP로 자동 저장. 리서치부터 문서화까지 수동 작업 제로.

시나리오 3 — GitHub PR 리뷰 자동화
GitHub MCP로 새 PR을 감지하고, 코드 변경사항을 클로드가 분석해 리뷰 코멘트를 자동 작성. 코드 리뷰 시간을 대폭 단축한다.

2026년 기준 MCP 생태계 현황 — 왜 지금 시작해야 하는가

2026년 4월 현재, MCP 공식 레지스트리에는 500개 이상의 서버가 등록돼 있다. Anthropic, Microsoft, Google, Cloudflare 등 주요 기업이 공식 MCP 서버를 제공 중이다. Claude Code 기준으로 MCP는 더 이상 고급 기능이 아니라 기본 인프라로 자리잡고 있다.

특히 Claude Code의 /mcp 명령과 MCP 서버 레지스트리 연동은 2025년 하반기 업데이트 이후 설치 과정이 대폭 간소화됐다. 기존에는 JSON 설정 파일을 수동으로 작성해야 했지만, 이제 CLI 한 줄로 설치·등록·활성화가 동시에 처리된다.

MCP를 먼저 익힌 사람이 AI 자동화 경쟁에서 구조적으로 앞선다. 설정 한 번으로 반복 업무를 영구 제거할 수 있는 기회다.

댓글 남기기