[클로드 시리즈_25] Claude Code에 날개 달기 — MCP 서버 연동으로 Notion·Slack까지 자동화하는 법

강호종 AI 길라잡이 강사 | 2026.05.28

---

핵심 결론 먼저

기본 Claude Code는 내 컴퓨터의 로컬 파일과 터미널만 제어할 수 있습니다. 그런데 MCP(Model Context Protocol) 서버를 연동하는 순간, Claude가 직접 DB에 쿼리를 날리고 Notion·Slack·GitHub까지 자율적으로 조작하는 진짜 AI 에이전트로 변합니다.
이 글에서는 MCP가 무엇인지, Notion과 어떻게 연동하는지, 그리고 실전에서 바로 쓸 수 있는 프롬프트까지 단계별로 정리합니다.

---

1. MCP란 무엇인가 — Claude의 능력 확장 다리

MCP 개념 이해

MCP(Model Context Protocol)는 Claude Code와 외부 서비스(DB, API 등)를 연결해 주는 표준 프로토콜입니다. Anthropic이 2024년 말 오픈소스로 공개한 규격으로, Claude가 MCP 서버에 명령을 내리면 서버가 대신 외부 서비스에 접근해 결과를 Claude에게 전달하는 구조입니다.

쉽게 말하면 Claude의 팔을 외부 세계로 뻗어주는 통로입니다.

MCP 연동 전후 비교

구분	구분기본 상태의 Claude Code	MCP 서버 연동 후
파일/시스템	파일 읽기/쓰기 가능	파일 읽기/쓰기 가능
명령어	로컬 터미널 명령어 실행	로컬 터미널 명령어 실행
확장 기능	—	+ DB 쿼리 직접 실행
확장 기능	—	+ 외부 서비스 API 연동
확장 기능	—	+ Notion, Slack, GitHub 등 트래커 연동

MCP로 할 수 있는 일 — 실전 예시

• 이슈 → 기능 구현 자동화: "JIRA 이슈 ENG-4521에 설명된 기능을 추가하고 GitHub에서 PR을 생성해줘."
• 모니터링 분석: "Sentry를 확인해서 가장 많이 발생하는 에러 Top 5를 정리해줘."
• DB 쿼리: "PostgreSQL 데이터베이스에서 최근 7일 신규 가입자 목록을 뽑아줘."
• 워크플로우 자동화: "회의록 내용을 읽고 Notion에 프로젝트와 업무 DB를 만들어줘."

---

2. Claude Code와 Notion 연동 — MCP 서버로 지식 창고 연결하기

Notion 워크스페이스를 MCP로 연동하면 AI가 직접 내 데이터를 읽고 업무를 배분하도록 만들 수 있습니다. 설정은 크게 3단계입니다.

---

Step 1. Notion API 준비하기 (통행증 발급)

Notion MCP 서버를 사용하려면 먼저 Notion에서 API 키(통행증)를 발급받아야 합니다.

① 새 통합(Integration) 만들기

Notion 개발자 페이지(notion.so/my-integrations)에 접속하여 [새 API 통합]을 클릭합니다.

② 이름 및 권한 설정

이름을 지정하고 권한(콘텐츠 읽기/업데이트/삽입 등)을 체크한 뒤 저장합니다.

③ API 키 복사

발급된 '프라이빗 API 통합 토큰(Internal Integration Token)'을 복사해둡니다.

⚠️ 반드시 확인! 토큰은 ntn_으로 시작합니다. 이 토큰이 외부에 노출되면 워크스페이스 데이터가 유출될 수 있으므로 절대 코드에 직접 입력하지 마세요.

④ 권한 부여 (매우 중요!)

AI가 접근하길 원하는 Notion 페이지나 데이터베이스 우측 상단의 [···] 메뉴를 누르고, [연결(Connections)] 탭에서 방금 만든 통합 이름을 검색하여 추가합니다.

💡 이 작업을 하지 않으면 토큰이 유효해도 "object not found" 에러가 납니다. Claude가 접근할 모든 페이지에 연결을 추가해야 합니다.

---

Step 2. Notion MCP 서버 추가하기

API 키를 발급받았다면 Claude Code에 Notion MCP 서버를 등록합니다.

방법 1 — Notion 공식 호스팅 서버 (OAuth, 가장 간편)

bash

claude mcp add --transport http notion https://mcp.notion.com/mcp

명령어 실행 후 브라우저에서 OAuth 인증을 완료하면 끝납니다. API 키를 직접 다룰 필요가 없어 가장 안전합니다.

방법 2 — npm 패키지 방식 (API 키 직접 입력

bash

claude mcp add --scope user \
  notion \
  -e NOTION_TOKEN="발급받은_API_키를_여기에_붙여넣으세요" \
  -- npx -y @notionhq/notion-mcp-server

📌 팩트체크 확인: 2025년 이전 자료에 등장하는 구 패키지명 @modelcontextprotocol/server-notion은 더 이상 유지되지 않습니다. 2026년 현재 Notion 공식 패키지는 **@notionhq/notion-mcp-server**이며, 호스팅 서버 주소는 https://mcp.notion.com/mcp 입니다.

등록 확인하기

bash

claude mcp list

목록에 notion 서버가 나타나면 성공적으로 연결된 것입니다.

---

Step 3. AI와 함께 Notion 200% 활용하기

MCP 연결이 완료되면, Claude Code에 자연어로 지시를 내려보세요.

[검색/요약]

"내 노션 워크스페이스에서 '2026년 마케팅 전략' 페이지를 검색하고, 내용을 3줄로 요약해 줘."

[문서 작성]

"오늘 작업한 코드 수정 내역을 정리해서 노션의 '개발 일지' 데이터베이스에 새 페이지로 등록해 줘."

[자동화]

"현재 폴더의 README.md 파일 내용을 읽고, 내 노션 프로젝트 페이지에 똑같이 업데이트해 줘."

---

3. Notion Skills 설치 — Claude가 Notion을 더 똑똑하게 다루는 법

Notion은 공식적으로 Claude Code 전용 Skills(스킬셋)을 제공합니다. Skills를 설치하면 Claude가 노션 특화 작업 방식을 익혀 훨씬 정확하게 동작합니다.

Claude Code 플러그인 방식 (2026년 기준 공식 권장)

Claude Code에서 아래 명령어를 입력하면 Notion MCP 서버와 Skills를 한 번에 설치할 수 있습니다.

/plugin install claude-code-notion@makenotion

설치 후 /reload-plugins를 실행하면 현재 세션에 즉시 적용됩니다.

💡 이 플러그인은 Skills 4종(구조화, 작성, 요약, 캡처)과 MCP 서버 연결을 한 번에 처리합니다. Notion이 공식 GitHub(makenotion/claude-code-notion-plugin)에서 관리하는 플러그인입니다.

---

4. 실전 활용 — AI 기반 자동화 워크플로우

MCP와 Skills가 모두 장착되면 이제 AI가 Notion 워크스페이스에 직접 접속해 업무를 처리합니다.

활용 예시 1. 과거 데이터 검색 및 조회

직접 데이터베이스를 뒤질 필요 없이 자연어로 질문하여 자료를 찾습니다.

"회의록 DB에 들어가서, 지난주에 노션 본사랑 미팅했던 내용 찾아봐 줘."

"서울대 4기 강의 자료 내용 중 한 페이지를 요약해줘."

결과: Claude가 지정된 회의록 DB에 접속하여 해당 미팅 노트의 내용을 터미널에 요약해 줍니다.

---

활용 예시 2. 프로젝트 및 업무 DB 자동 생성·연결

Notion AI로 녹음 및 텍스트 변환된 회의록을 바탕으로 후속 작업을 AI가 직접 세팅합니다.

"이 미팅 내용을 바탕으로 관련된 '프로젝트'를 생성하고, 
여기서 파생되는 세부 업무들도 '업무 DB'에 각각 만들어 줘. 
이때 프로젝트와 업무 간의 관계형(Relation) 연결도 확실하게 해 줘."

결과: Claude가 지시사항을 분석하여

1. 프로젝트 DB에 새 항목을 만들고
2. 필요한 태스크들을 업무 DB에 여러 개 생성한 뒤
3. 서로 관계형 속성으로 자동 연결까지 완료합니다.

---

단 세 마디 프롬프트로 노션 자동화 완성

1. "노션 MCP 연결해 줘"
2. "노션 스킬도 설치해 줘"  
3. "회의록 읽고 프로젝트랑 업무 생성해 줘"

이 세팅을 마치면 수동으로 데이터를 복사하고 연결하던 시간을 획기적으로 줄이고, 훨씬 더 생산적인 일에 시간을 투자할 수 있습니다.

🚀 고급 팁: 앞서 배운 서브에이전트(Subagents)와 결합하면 시너지가 납니다. research-worker 에이전트가 웹 리서치를 수행하고 결과물을 메인 창으로 가져오면, 메인 창에서 다시 Notion MCP를 통해 그 리서치 결과를 노션 페이지로 자동 아카이빙할 수 있습니다.

---

5. Q&A — 자주 묻는 질문 5가지

Q1. MCP 서버는 어디서 찾을 수 있나요?

Anthropic 공식 디렉토리인 claude.ai/directory에서 검토된 커넥터 목록을 확인할 수 있습니다. Notion, Slack, GitHub, JIRA, Asana 등 주요 서비스가 이미 등록되어 있습니다. claude mcp add 명령어로 바로 설치 가능합니다.

Q2. 안 쓰는 MCP 서버는 어떻게 끄나요?

/mcp 명령어를 입력하면 연결된 서버 목록이 뜹니다. 여기서 Disable 처리하면 비활성화됩니다. 안 쓰는 MCP 서버를 켜 두면 매 메시지마다 도구 정의(약 18,000토큰)를 로드해서 토큰을 낭비하므로 꼭 정리해 두세요.

Q3. Notion API 키가 노출되면 어떻게 되나요?

해당 통합에 권한 부여된 모든 Notion 페이지와 DB에 외부인이 접근할 수 있습니다. 노출 시 즉시 notion.so/my-integrations에서 해당 통합을 삭제하거나 토큰을 재발급하세요. API 키는 절대 GitHub 등 공개 저장소에 올리지 마세요.

Q4. MCP 서버가 여러 개 연결되어 있으면 Claude가 헷갈리지 않나요?

Claude는 각 서버의 도구 이름과 설명을 분석해서 어떤 서버를 써야 할지 자동으로 판단합니다. 다만 유사한 기능의 서버가 너무 많으면 판단이 느려질 수 있습니다. 실제로 사용하는 서버만 활성화해 두는 것이 좋습니다.

Q5. Claude Desktop 앱에서도 MCP를 쓸 수 있나요?

네. Claude Desktop 앱의 경우 설정 → Connectors에서 MCP 서버를 추가할 수 있습니다. 단, Remote MCP 서버는 claude_desktop_config.json 파일이 아닌 Connectors 탭에서 설정합니다.

---

마무리 — 오늘 당장 해볼 수 있는 3가지 액션

1. Notion API 키 발급 — notion.so/my-integrations 에서 5분이면 완료
2. MCP 서버 연결 — claude mcp add --transport http notion https://mcp.notion.com/mcp 한 줄 실행
3. 첫 자동화 프롬프트 시도 — "내 노션에서 최근 회의록 찾아서 3줄로 요약해 줘"

MCP 하나를 연결하는 것만으로 Claude Code가 완전히 다른 도구가 됩니다. 연동해보고 가장 유용했던 활용 사례를 댓글로 공유해 주시면, 다음 편에서 직접 다뤄보겠습니다!

다음 편 예고: [클로드 코드 시리즈] Hooks(훅)을 활용한 자동화 & 품질검사 엔진 — AI가 스스로 규칙을 지키게 만드는 법

---

작성자 | 강호종 AI 길라잡이 강사

생성형 AI 활용 업무 효율화 전문강사 · 디지털융합교육원 지도강사, 젠스파크 AI 전문강사 · (사)한국AINFT협회 이사
저서: 『생성형 AI 활용 업무혁신』(2026) · 『이것이 GEO마케팅이다』(2026)
📞 010-9912-9934 · 📧 art386@naver.com · blog.naver.com/art386 · aiart386.tistory.com

---

#MCP서버 #ClaudeCode #Notion자동화 #클로드코드 #MCP연동 #ModelContextProtocol #AI자동화 #Notion #강호종강사 #AI길라잡이 #생성형AI #업무자동화 #NotionMCP #클로드MCP #데이터베이스연동 #AI워크플로우 #바이브코딩 #NotionAPI #Anthropic #2026AI트렌드