클로드 코워크(Claude Cowork) MCP 서버 설정 가이드

클로드 코워크(Claude Cowork) MCP 서버 설정 완벽 가이드

최근 업데이트된 클로드 코워크(Claude Cowork)는 단순한 대화형 AI를 넘어, 사용자의 로컬 환경과 긴밀하게 소통하는 강력한 워크스테이션으로 진화했습니다. 특히 MCP(Model Context Protocol)를 설정하면 내 컴퓨터의 파일을 읽거나 구글 검색, 슬랙 등을 직접 제어할 수 있어 업무의 차원이 달라집니다.

1. 시작 전 준비사항

• Node.js 및 npm 설치: 공식 MCP 서버(파일 시스템, 구글 검색 등)를 구동하기 위해 반드시 필요합니다.
• 클로드 데스크톱 앱: 로컬 MCP 기능을 제대로 활용하려면 웹 브라우저가 아닌 전용 데스크톱 앱을 설치해야 합니다.

2. 방법 1: 설정 파일 수동 수정 (고급용)

세부적인 경로 지정이 필요한 사용자에게 적합한 방법입니다. 운영체제별 설정 파일 경로를 확인하세요.

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

설정 단계

클로드 앱에서 [Settings] > [Developer] > [Edit Config]를 누르면 파일이 열립니다. 아래와 같이 mcpServers 항목을 추가해 보세요.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:/Users/사용자/Documents/Project"
      ]
    }
  }
}

⚠️ 주의: 윈도우 경로를 입력할 때는 백슬래시(\) 대신 슬래시(/)를 사용하는 것이 안전합니다.

3. 방법 2: UI를 통한 간편 설치 (추천)

2026년 버전 클로드 코워크는 코딩 없이 마우스 클릭만으로 플러그인을 추가할 수 있는 기능을 제공합니다.

• 코워크 세션 실행: 앱 내 'Work in a folder' 탭을 엽니다.
• 커넥터 아이콘 클릭: 입력창 옆의 [+] 또는 [Plugins] 아이콘을 누릅니다.
• 마켓플레이스 활용: 노션, 지메일 등 필요한 도구를 찾아 [Install]을 클릭하고 권한을 승인합니다.

4. 적용 확인 및 문제 해결

설정을 마쳤다면 아래 과정을 통해 정상 작동 여부를 체크해야 합니다.

• 앱 재시작: JSON 파일을 직접 수정했다면 반드시 앱을 완전히 종료 후 다시 실행하세요.
• 플러그 아이콘 확인: 하단에 활성화된 플러그 모양 아이콘을 통해 연결 상태를 볼 수 있습니다.
• 테스트 실행: "내 프로젝트 폴더 내 파일들을 요약해줘"라고 명령해 보세요.

만약 오류가 발생한다면 mcp.log 파일을 열어 로그를 확인하는 것이 가장 빠릅니다.