MCP 연동 가이드

claudecode-company는 MCP(Model Context Protocol) 서버와 연동하여, 비서가 외부 서비스를 직접 조작할 수 있습니다.

작동 방식

claudecode-company 쪽에서는 특별한 설정이 필요 없습니다. Claude Code에 MCP 서버를 추가하면, 비서가 자동으로 활용합니다.

나

내일 오후 2시에 A사 미팅 잡아줘

비서

캘린더에 추가했습니다! TODO에 "A사 미팅 자료 준비"도 넣어뒀어요.

추천 MCP 서버

Notion (공식)

지식 베이스 및 데이터베이스에 연결합니다. 비서가 Notion 페이지를 조회하고 업데이트할 수 있습니다.

방법 1: OAuth (권장)

claude mcp add-json notion '{"type":"http","url":"https://mcp.notion.com/mcp"}'

브라우저에서 OAuth 인증이 자동으로 열립니다. 수동 API 키 설정이 필요 없습니다.

방법 2: API 토큰

claude mcp add notion \
  -e NOTION_TOKEN=ntn_YOUR_TOKEN \
  -- npx -y @notionhq/notion-mcp-server

기능:

Notion 페이지 조회, 생성, 업데이트
데이터베이스 검색 및 업데이트
기존 지식 베이스 참조

Google Calendar

일정 관리를 담당합니다. 비서가 미팅을 등록하고 알림을 설정할 수 있습니다.

claude mcp add google-calendar \
  -e GOOGLE_OAUTH_CREDENTIALS=/path/to/gcp-oauth.keys.json \
  -- npx -y @cocal/google-calendar-mcp

사전 준비:

Google Cloud Console에서 프로젝트 생성
Calendar API 활성화
OAuth 2.0 자격 증명 생성 (데스크톱 앱)
자격 증명 JSON 다운로드

기능:

일정 생성, 조회, 수정, 삭제
오늘/이번 주 일정 표시
빈 시간 확인
반복 일정 관리

GitHub (공식)

리포지토리 관리를 담당하며, 개발 부서와 잘 어울립니다.

방법 1: HTTP (권장)

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

방법 2: Docker

claude mcp add github \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_PAT \
  -- docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN \
  ghcr.io/github/github-mcp-server

기능:

이슈 생성, 조회, 검색
풀 리퀘스트 관리 및 리뷰
리포지토리 상태 확인
코드 검색

Slack (공식)

팀 커뮤니케이션 도구로, 영업 및 PM 부서에 유용합니다.

방법 1: OAuth (권장)

claude mcp add-json slack '{"type":"http","url":"https://mcp.slack.com/mcp","oauth":{"clientId":"1601185624273.8899143856786","callbackPort":3118}}'

방법 2: 플러그인 설치

claude plugin install slack

기능:

메시지 전송 및 조회
채널 상태 모니터링
사용자 정보 참조
클라이언트 커뮤니케이션 알림

참고: 워크스페이스 관리자가 MCP 연동을 승인해야 합니다.

설정 방법

명령줄 (권장)

위의 claude mcp add 명령어를 실행하고 Claude Code를 재시작하세요.

수동 파일 편집

글로벌 설정 (모든 프로젝트): ~/.claude/settings.json

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

프로젝트 설정 (특정 프로젝트만): .claude/settings.json

팁: 자주 사용하는 서비스(캘린더, Notion)는 글로벌 설정에, 프로젝트별 서비스(GitHub)는 프로젝트 설정에 넣으세요.

비서와의 연동 예시

MCP 서버가 설정되면 비서가 자연스럽게 활용합니다:

나

이번 주 일정 알려줘

비서

캘린더를 확인할게요.
- 월요일 10:00 A사 정기 미팅
- 수요일 14:00 B사 면접
- 금요일 종일 세금 신고 마감

수요일 B사 제안서 준비하실까요?

나

A사 미팅 내용 Notion에 정리해줘

비서

Notion에 노트 페이지를 만들었습니다. secretary/notes/에도 요약본을 저장했어요.

나

이 버그 GitHub 이슈로 만들어줘

비서

GitHub에 이슈를 만들었습니다. engineering/debug-log/에도 로그를 저장했어요.

MCP 없이도 잘 됩니다

claudecode-company는 MCP 서버 없이도 완벽하게 동작합니다. 비서가 .company/ 폴더 내에서 파일을 효과적으로 관리합니다. MCP는 선택적 편의 기능입니다.

← 비서와의 일상 활용 사례 →