위키 · Notion 공식
브랜드 톤 문서를, 매번 복사해 붙였어요
우리 톤에 맞춰 카피를 써 달라고 했어요. “톤 가이드를 붙여 주세요”가 왔어요. 근데 그 가이드는 노션에 있어요. 지난주에도, 그저께도 복사해서 붙였어요.
매번 붙여넣으면
우리 제품 원칙에 맞게 이 카피 초안 봐줘.
제품 원칙 문서를 여기에 붙여 주시면 그 기준으로 볼게요.
워크스페이스를 열면
노션의 제품 원칙 페이지 기준으로, 이 초안에서 어긋난 문장만 표시해줘.
원칙 페이지에 ‘증거 없는 최상급 금지’가 있어요. 초안 2문장이 그 줄을 넘어요. 표시해 뒀어요.
회사가 정한 건 노션에 있어요. 에이전트는 거기 못 들어가요. 그래서 원칙, 톤, 지난 결정을 물을 때마다 사람이 페이지를 열어 복사해요. 붙이는 걸 잊으면 에이전트는 일반적인 답을 해요.
이 도구를 붙이면, 노션 페이지를 직접 찾아 읽고 그 기준으로 답해 줘요.
설치는 한 줄, 다음은 OAuth
명령 다음에 브라우저에서 워크스페이스를 승인해요. 딸깍 한 방이 아니에요.
- 1
이 말을 그대로 AI에 붙여넣으세요
공식 Notion MCP를 연결해줘. 명령은 claude mcp add --transport http notion https://mcp.notion.com/mcp 야. 로컬 저장소는 쓰지 마. OAuth 후에 내 권한 범위만 쓰는지 확인해줘. 페이지는 내가 읽기만 하라고 하기 전에는 수정하지 마.공식 Claude Code 명령.
claude mcp add --transport http notion https://mcp.notion.com/mcp - 2
승인됐다면, 이렇게 물어보세요
노션에서 제품 원칙 페이지를 찾아, 제목과 상위 세 줄만 보여줘. 페이지는 수정하지 마.
별 4,623은 2026-09-05 GitHub API(makenotion/notion-mcp-server) 값이에요. SSE 구주소 /sse 는 구형 클라이언트용이에요. 새 연결은 /mcp 를 쓰세요.
세 줄 요약
이럴 때
위키·회의록·브랜드 가이드가 노션에 있을 때. 매번 붙여넣기 싫을 때.
들어 있는 것
공식 호스트 + OAuth. Claude Code 한 줄: claude mcp add --transport http notion https://mcp.notion.com/mcp. 그다음 /mcp로 승인해요.
안 되는 것
로컬 저장소를 새로 깔 이유가 거의 없어요. 쓰기 권한을 주면 페이지가 바뀌어요. 시크릿이 적힌 페이지는 연결 전에 빼 두세요. 비대화형 토큰 인증은 아직 없어요.
써본 사람들 반응
별 숫자는 옛 로컬 저장소 기준이에요. 지금 쓸 물건은 호스트예요.
도움 됐다는 쪽
“Notion MCP is a remote MCP server hosted by Notion. After you authorize a connection with OAuth, the MCP client can use Notion MCP tools to read and update content that you can access.” developers.notion.com
— Notion MCP overview
“Notion MCP (https://mcp.notion.com/mcp) is our hosted, actively maintained server. It supports OAuth authorization and requires no infrastructure setup.” developers.notion.com
— Notion 개발자 문서
아쉽다는 쪽
“The open-source server (notion-mcp-server) is no longer actively maintained. For most users, we recommend Notion MCP.” developers.notion.com
— Notion 개발자 문서
“랭킹에 적은 4.6K 별은 유지보수가 줄어든 로컬 저장소 숫자예요. 호스트 사용량과 같은 값이 아니에요.”
— 워킹 레퍼런스 편집 주