Notion 연결 — MCP

Notion에 있는 자료를 Claude에게 보여주려고 매번 복사해서 붙여넣은 적 있지 않나요? MCP(Model Context Protocol, 모델 컨텍스트 프로토콜)가 있으면 Claude Code가 Notion 같은 외부 서비스에 직접 접근합니다.

외부 도구를 케이블 하나로 연결합니다

Claude Code는 로컬 파일만 다루지 않습니다. Notion, Slack, 데이터베이스처럼 파일 시스템 밖에 있는 데이터를 매번 복사해 옮기면 서식이 깨지거나 최신 값을 놓치기 쉽습니다.

MCP는 Claude Code가 외부 서비스와 대화하는 표준 통로입니다. 설정 파일을 직접 만질 필요는 없습니다. “Notion 연결해 줘” 같은 요청으로 설치와 인증 과정을 Claude Code에게 맡길 수 있습니다. 연결이 끝나면 Notion 페이지 검색·조회·작성 같은 요청을 문장으로 할 수 있습니다.

기본 연결은 프로젝트 단위로 저장됩니다. 같은 도구를 다른 프로젝트에서도 쓰려면 그 프로젝트에서 다시 연결해야 합니다. 모든 프로젝트에서 공용으로 쓰고 싶으면 사용자 범위로 연결해 달라고 요청하면 되고, 이 경우 새 프로젝트를 열 때마다 다시 연결하지 않아도 됩니다. 마케터가 캠페인 성과를 Notion 대시보드에 매주 옮겨 적는다면, 연결 하나로 “이번 주 광고 성과를 Notion 리포트 페이지에 정리해 줘”라고 바로 요청할 수 있습니다. 흔한 안티패턴은 연결 없이 데이터를 손으로 복사해 붙여넣는 것입니다.

아래 연습을 그대로 붙여넣어 지금 연결된 외부 도구부터 확인해 보세요.

순서

연결할 외부 도구를 정합니다(예: Notion).
claude mcp add --transport http notion https://mcp.notion.com/mcp 같은 명령으로 연결을 요청하거나, Claude에게 문장으로 맡깁니다.
서버가 인증을 요구하면 /mcp를 실행해 브라우저에서 로그인합니다.
claude mcp list로 연결 상태를 확인하고, 페이지 하나를 조회해 테스트합니다.

연습

기본

지금 연결된 MCP 서버 목록을 보여주고, 각각 정상 연결 상태인지 확인해 줘.

내 일로

[Notion 같은 자주 쓰는 외부 도구]를 아직 연결 안 했어. 연결하는 방법을 알려주고, 가능하면 지금 바로 연결해 줘.

연결한 도구에서 페이지 하나를 실제로 불러와 확인해 보세요.

연결한 외부 도구의 페이지나 데이터를 Claude Code 요청으로 불러올 수 있으면 통과입니다.

막히는 지점

연결이 어느 날 401 오류로 갑자기 끊기는 경우가 있습니다. 인증 토큰이 만료된 것이므로 /mcp를 다시 실행해 로그인하면 됩니다. 어느 페이지·데이터베이스까지 공유했는지 확인하지 않고 쓰면 원치 않는 범위까지 접근이 열려 있을 수 있으므로, 연결 직후 claude mcp get으로 범위를 한 번 확인해 둡니다.

2026-07-13 기준 · 출처 · Claude Code — MCP