[MCP] Claude에 Notion API 연결하기

이번에는 Claude에 Notion API를 연결하여 자동으로 내 노션 페이지를 접근할 수 있게 해볼 것입니다! 

 

아래는 최종적으로 나올 수 있는 결과입니다🌱

 

 

Notion MCP는 노션에서 제공해주는 공식 MCP를 사용할건데요, 

https://github.com/makenotion/notion-mcp-server

GitHub - makenotion/notion-mcp-server: Official Notion MCP Server

 

위의 레포를 이용하시면 됩니다. 

 

1. Notion API 생성하기

가장 먼저, https://www.notion.so/profile/integrations

Your connected workspace for wiki, docs & projects | Notion

위의 사이트에서 API키를 발급합니다. 

 

"View my integrations"를 클릭하고.. 

 

새 API를 생성해줍니다. 

 

이후, 발급받은 API 키를 잘 기억해줍니다. 

 

 

2. Notion 페이지와 연결

이후, 연결하고자 하는 페이지에 들어가 오른쪽 상단의 "···"을 누르고,

연결 > 위에서 생성한 API를 연결해줍니다. 

 

해당 과정은 워크스페이스에 존재하는 최상위 페이지에 적용해주면 되고, 

만약 최상위 페이지가 여러개 존재한다면 각각의 페이지 모두에 연결을 해줘야합니다! 

 

 

3. Claude JSON 파일 설정하기

저번 글에서 진행했던 것처럼 claude의 JSON 파일을 수정해줍니다. 

2025.05.07 - [기타] - MCP가 뭔데? (Claude에 Naver API 연결하기)

MCP가 뭔데? (Claude에 Naver API 연결하기)

 

JSON 파일에 아래 내용을 복사해주고, 파일을 저장한 후, Claude를 완전종료 후 다시 실행합니다. 

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer xxxx\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

# xxx 자리에 Notion API키 넣기

 

저 같은 경우에는 Naver API를 이미 연결해뒀기 때문에 아래와 같이 JSON 파일을 구성해주었습니다! 

{
  "mcpServers": {
    "naver-search-mcp": {
      "command": "npx",
      "args": [
        xxxxxx
      ]
    },
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer xxxxx\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

 

 

4. Claude에서 Notion 접근하기 ! 

모든 과정이 끝났는데요, 

이제 Claude에서 원하는 작업을 요청하면 됩니다. 

 

이런 식으로 원하는 페이지 안에 새로운 페이지를 생성하는 등의 작업을 진행할 수 있게 되죠. 

 

 

마무리

MCP는 처음 이해하는 과정 + 처음 설정하는 과정만

잘 넘기면 이후에는 정말 쉽게 사용할 수 있는 것 같습니다 ㅎㅎ

저 역시 GPT 결제를 취소하고 Claude 유료 플랜으로 넘어갔습니다ㅋㅋ