📝

Notion MCP 발급 가이드

난이도⭐⭐⭐☆☆

💡 Notion MCP가 뭐예요?

사용자 앱이 Notion 메모 검색 / 페이지 생성을 자동으로 할 수 있게 해줘요. AI 비서 / 회의록 정리 / 일정 관리 앱에 진짜 강력해요.

  • ✅ 여러 외부 도구 통합 시 (Notion + Slack + Calendar) 추천
  • ✅ AI 비서 앱에 자동 연결
  • ⚠️ 단일 도구만 쓸 거면 직접 SDK 가이드 (Notion) 더 단순

Notion Integration Token 발급 (기존 가이드 활용)

MCP 연결도 Notion Integration Token (secret_...)이 필요해요.

이미 발급 받았으면 다음 Step으로! Notion API 가이드 참조 (Integration 생성 + Database 공유 + Database ID 추출).

Notion MCP Server 활성화

현재 Notion 공식 MCP 서버 URL:

https://mcp.notion.com

Foundry 환경변수 입력

포비한테 직접 입력해주세요 (또는 채팅창에 알려주면 자동 저장):

  • NOTION_API_TOKEN = secret_...
  • NOTION_MCP_URL = https://mcp.notion.com

저장하면 자동 재배포 → Notion MCP 연결 활성화 ✅

(선택) 다른 외부 도구도 함께

AI 비서 앱이면 여러 도구 통합 추천:

❓ 자주 묻는 질문

기존 Notion API 가이드랑 뭐가 달라요?
토큰은 동일! 단순히 직접 API 호출 (@notionhq/client) vs MCP 표준 프로토콜로 호출 차이예요. MCP 장점: 여러 외부 도구 (Notion + Slack + GitHub)를 한 번에 통합 / AI 비서에 자연스럽게 연결.
MCP 안 쓰고 직접 SDK가 더 단순한가요?
단일 도구만 쓰면 직접 SDK 추천! 예: Notion 메모 백업만 필요 → @notionhq/client 직접. 여러 도구 통합 / AI 비서면 MCP Client 추천.
Notion MCP 공식 서버 없으면?
자체 MCP 서버 구축도 가능 (Notion API + MCP wrapper). 단 작업량 ↑. 공식 출시 대기 또는 직접 SDK 추천.
여러 Workspace 동시 연결?
각 Workspace마다 별도 Integration Token 발급 → 환경변수 여러 개로 분리 가능 (예: NOTION_API_TOKEN_TEAM / NOTION_API_TOKEN_PERSONAL).

🔗 참고 링크