Claude Code MCP 연동 방법 2026 — Notion, Slack, Figma 연결 완전 가이드

      u_6d3d56f4

      Claude Code MCP 연동 방법 2026 — Notion, Slack, Figma 연결 완전 가이드

      Claude Code가 외부 서비스와 연결되면 달라지는 것들

      Claude Code를 터미널에서 코딩 도구로만 사용하는 분들이 많습니다. 하지만 MCP를 활용하면 Claude Code의 활용 범위가 코딩을 넘어 업무 전반으로 확장됩니다.

      MCP(Model Context Protocol)는 Claude Code가 외부 서비스와 직접 소통할 수 있게 해주는 프로토콜입니다. Notion에 정리된 기획서를 읽어와서 코드 구조를 잡거나, 작업이 완료되면 Slack으로 알림을 보내거나, Figma 디자인을 참고해서 컴포넌트를 구현하는 워크플로우가 가능해집니다.

      이 글에서는 Claude Code에 Notion, Slack, Figma를 연동하는 방법을 2026년 기준으로 단계별로 정리합니다.

      MCP란 무엇인가?

      MCP는 Anthropic이 개발한 오픈 프로토콜로, AI 모델이 외부 도구와 데이터 소스에 접근할 수 있도록 표준화된 방식을 제공합니다. 쉽게 말하면 Claude Code와 외부 서비스 사이를 연결하는 다리 역할을 합니다.

      MCP를 통해 연결할 수 있는 서비스는 Notion, Slack, Figma 외에도 Google Drive, Jira, GitHub, 데이터베이스 등 300개 이상의 외부 서비스가 있습니다. 연결된 서비스의 데이터를 Claude Code가 직접 읽고 처리할 수 있기 때문에 업무 자동화 가능성이 크게 넓어집니다.

      MCP 서버 연동 기본 구조

      MCP 서버를 추가하는 기본 명령어 구조는 다음과 같습니다.

      claude mcp add 서버이름 명령어 [옵션]

      서버 유형에 따라 연결 방식이 다릅니다. 로컬에서 실행하는 서버와 원격 URL로 연결하는 SSE 방식 서버가 있습니다.

      로컬 서버 추가 방식입니다.

      claude mcp add 서버이름 /path/to/server

      SSE 방식 원격 서버 추가 방식입니다.

      claude mcp add --transport sse 서버이름 https://서버주소/sse

      환경 변수가 필요한 경우 -e 옵션으로 추가합니다.

      claude mcp add 서버이름 -e API_KEY=your_api_key -- 명령어

      Notion 연동하기

      Notion은 기획서, 회의록, 문서를 관리하는 데 많이 사용하는 서비스입니다. Claude Code와 Notion을 연동하면 Notion 문서를 읽어서 코드 작업에 활용하거나, 작업 결과를 Notion에 자동으로 기록할 수 있습니다.

      Notion API 키 발급

      먼저 Notion API 키를 발급받아야 합니다. Notion 개발자 포털(developers.notion.com)에 접속해서 새 인테그레이션을 생성합니다. 생성된 인테그레이션의 API 키를 복사해둡니다.

      연동할 Notion 페이지나 데이터베이스에서 인테그레이션 연결을 허용해야 합니다. 페이지 오른쪽 상단 메뉴에서 연결 추가를 선택하고 생성한 인테그레이션을 연결합니다.

      Notion MCP 서버 설치 및 연동

      claude mcp add notion -e NOTION_API_KEY=your_notion_api_key -- npx @notionhq/notion-mcp-server

      your_notion_api_key 부분에 발급받은 Notion API 키를 입력합니다.

      Notion 연동 후 활용 예시

      연동이 완료되면 아래와 같이 Notion 문서를 바로 활용할 수 있습니다.

      Notion에서 "2026년 3분기 기획서" 페이지를 읽어와서
주요 기능 목록을 정리해줘

      Notion 개발 태스크 데이터베이스에서
이번 주 완료 예정인 항목들을 가져와줘

      오늘 작업한 내용을 Notion 개발 일지 페이지에 추가해줘

      Slack 연동하기

      Slack은 팀 커뮤니케이션 도구로 많이 사용됩니다. Claude Code와 Slack을 연동하면 작업 완료 알림을 자동으로 보내거나, Slack 채널의 내용을 읽어서 작업에 활용할 수 있습니다.

      Slack API 토큰 발급

      Slack API 포털(api.slack.com)에 접속해서 새 앱을 생성합니다. 앱에 필요한 권한(스코프)을 설정합니다. 메시지 읽기에는 channels:history, channels:read 권한이 필요하고, 메시지 보내기에는 chat:write 권한이 필요합니다.

      앱을 워크스페이스에 설치하고 발급된 Bot Token을 복사합니다. Bot Token은 xoxb-로 시작합니다.

      Slack MCP 서버 연동

      claude mcp add slack -e SLACK_BOT_TOKEN=xoxb-your-token -- npx @modelcontextprotocol/server-slack

      xoxb-your-token 부분에 발급받은 Slack Bot Token을 입력합니다.

      Slack 연동 후 활용 예시

      #개발 채널에 "로그인 기능 구현 완료" 메시지를 보내줘

      #버그리포트 채널에서 오늘 올라온 버그 목록을 가져와줘
우선순위별로 정리해줘

      배포가 완료되면 #배포알림 채널에
배포된 기능 목록과 함께 완료 메시지를 보내줘

      Figma 연동하기

      Figma는 UI 디자인 도구로 많이 사용됩니다. Claude Code와 Figma를 연동하면 디자인 파일을 참고해서 컴포넌트를 구현하거나, 디자인 스펙을 코드로 변환하는 작업을 더 정확하게 처리할 수 있습니다.

      Figma API 토큰 발급

      Figma에 로그인한 뒤 계정 설정으로 이동합니다. 개인 액세스 토큰 섹션에서 새 토큰을 생성합니다. 생성된 토큰을 복사해둡니다. 토큰은 생성 시 한 번만 표시되므로 반드시 안전한 곳에 저장해두세요.

      Figma MCP 서버 연동

      claude mcp add figma -e FIGMA_API_TOKEN=your_figma_token -- npx figma-mcp-server

      your_figma_token 부분에 발급받은 Figma API 토큰을 입력합니다.

      Figma 연동 후 활용 예시

      이 Figma 파일 URL의 로그인 화면 디자인을 참고해서
React 컴포넌트를 구현해줘
https://www.figma.com/file/xxxxx

      Figma에서 버튼 컴포넌트의 색상, 크기, 폰트 스펙을 가져와서
Tailwind CSS 클래스로 변환해줘

      Figma 디자인 시스템에서 사용된 색상 팔레트를 가져와서
CSS 변수로 정의해줘

      여러 MCP 서버를 함께 활용하는 워크플로우

      MCP 서버는 여러 개를 동시에 연결해서 함께 활용할 수 있습니다. Notion, Slack, Figma를 모두 연결하면 아래와 같은 통합 워크플로우가 가능합니다.

      Notion의 이번 주 개발 태스크를 가져와서
Figma 디자인을 참고해 구현하고
완료되면 Slack #개발 채널에 완료 메시지를 보내줘

      한 번의 명령으로 여러 서비스를 넘나드는 작업을 처리할 수 있습니다. 반복적인 업무 흐름을 자동화하는 데 특히 효과적입니다.

      MCP 서버 관리

      연결된 MCP 서버 목록 확인

      claude mcp list

      현재 연결된 MCP 서버 목록과 상태를 확인합니다.

      특정 MCP 서버 상세 정보 확인

      claude mcp get notion

      MCP 서버 제거

      더 이상 사용하지 않는 MCP 서버는 제거합니다.

      claude mcp remove notion

      MCP 연동 시 주의사항

      API 키 보안 관리

      MCP 서버 연동 시 사용하는 API 키와 토큰은 민감한 정보입니다. 코드나 CLAUDE.md에 직접 입력하지 말고, 환경 변수나 별도의 설정 파일로 관리하세요. Git 저장소에 API 키가 포함된 파일이 올라가지 않도록 .gitignore에 설정 파일을 추가해야 합니다.

      권한 범위 최소화

      API 토큰을 발급받을 때 필요한 권한만 최소한으로 설정하는 것이 보안상 안전합니다. 예를 들어 Slack에서 메시지 읽기만 필요하다면 쓰기 권한은 부여하지 않는 것이 좋습니다.

      회사 보안 정책 확인

      외부 서비스 연동 전에 회사 보안 정책을 반드시 확인하세요. 특히 기업 내부 데이터가 포함된 서비스를 연동할 때는 데이터 처리 방식과 보안 요건을 검토해야 합니다.

      MCP 연동이 안 될 때 확인할 것

      API 키가 올바르게 입력됐는지 확인한다

      가장 흔한 원인입니다. API 키나 토큰에 공백이 포함되거나 일부가 누락된 경우 연동이 실패합니다. 복사한 값을 다시 확인해보세요.

      권한이 올바르게 설정됐는지 확인한다

      Notion의 경우 연동할 페이지에 인테그레이션이 연결되어 있어야 합니다. Slack의 경우 필요한 스코프가 모두 설정되어 있어야 합니다.

      네트워크 연결 상태를 확인한다

      MCP 서버가 외부 API에 접근할 수 있는 네트워크 환경인지 확인합니다. 회사 방화벽이나 프록시 설정이 외부 API 호출을 차단하는 경우가 있습니다.

      서버 로그를 확인한다

      연동 오류가 발생하면 아래 명령어로 상세 정보를 확인할 수 있습니다.

      claude mcp get 서버이름

      마무리

      MCP 연동은 Claude Code를 단순한 코딩 도구에서 업무 전반을 자동화하는 플랫폼으로 변환시켜주는 핵심 기능입니다. Notion, Slack, Figma를 연동하는 것만으로도 기획, 개발, 커뮤니케이션이 하나의 흐름으로 연결되는 워크플로우를 구성할 수 있습니다.

      처음에는 가장 자주 사용하는 서비스 하나만 연동해서 시작하는 것을 권장합니다. 하나를 익히고 나면 다른 서비스도 비슷한 방식으로 빠르게 연동할 수 있습니다. 다음 글에서는 Claude Code 서브에이전트 활용법을 복잡한 작업 자동화 방법으로 정리해드리겠습니다.

      다음 글 예고: Claude Code 서브에이전트 활용법 2026 — 복잡한 작업 자동화하는 방법

      17번 글로 바로 이어서 작성할까요? “네”라고 답해주시면 진행하겠습니다.

      Related Posts

      답글 남기기

      이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다