노션API설정부터 클로드에 노션MCP연결하기까지

이전에 작성했던 내용과 비슷하지만, 좀 더 간추려서 작성한 내용입니다.

API란? Application Programming Interface

소프트웨어 프로그램들이 서로 상호작용하기 위해 사용하는 일련의 규칙 또는 프로토콜인데,
이걸 사용하려면 규칙을 알아야합니다.

규칙 :
내가 바라는 데이터형식이 있어, 그거 맞춰서 알려주면, 나도 정해진 규칙대로 너한테 알려줄게.
그리고, 아무나 나의 데이터를 접근할 수 없게 키(key)를 발급받아야 해.

노션에서 하나의 행에 적는 걸 블록이라고 하는 데, 그 블록내용을 알려달라는 내용입니다. API 호출을 하기위해서 이런 규칙에 맞게 작성해야합니다.

요청코드

curl 'https://api.notion.com/v1/blocks/0c940186-ab70-4351-bb34-2d16f0635d49' \
  -H 'Authorization: Bearer '"$NOTION_API_KEY"'' \
  -H 'Notion-Version: 2022-06-28'

응답코드

{
  "object": "block",
  "id": "c02fc1d3-db8b-45c5-a222-27595b15aea7",
  "parent": {
    "type": "page_id",
    "page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
  },
  "created_time": "2022-03-01T19:05:00.000Z",
  "last_edited_time": "2022-03-01T19:05:00.000Z",
  "created_by": {
    "object": "user",
    "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
  },
  "last_edited_by": {
    "object": "user",
    "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
  },
  "has_children": false,
  "archived": false,
  "type": "heading_2",
  "heading_2": {
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "Lacinato kale",
          "link": null
        },
        "annotations": {
          "bold": false,
          "italic": false,
          "strikethrough": false,
          "underline": false,
          "code": false,
          "color": "default"
        },
        "plain_text": "Lacinato kale",
        "href": null
      }
    ],
    "color": "default",
    "is_toggleable": false
  }
}

이런 게 있다 정도만 보시고 넘어갈게요. 저희에게는 매직도구가 있거든요.

노션API를 사용하기위해서 키(key)도 발급받아야 하고, 그걸 노션페이지에 등록도 해야합니다.
이 과정을 거치면 API를 통해서 노션페이지에 접속이 가능하게 됩니다.