> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ale.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion 데이터 연동 및 활용

> Notion을 Porter AI에 연결하고 활용합니다.

<Card>
  Notion 페이지와 하위 페이지를 지식베이스로 만들어 AI 답변에 활용하거나, Notion MCP를 연결해 AI가 페이지와 데이터베이스를 조회하고 작성·수정하도록 설정할 수 있습니다.
</Card>

## Notion 데이터 연동 및 관리

### Notion 페이지를 지식베이스로 만들기

<Steps>
  <Step title="스페이스 설정 창 커넥터 페이지에서 Notion 커넥터 선택">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion01.png" />
    </Frame>
  </Step>

  <Step title="설치하기 버튼으로 Notion 커넥터 설치">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion17.png" />
    </Frame>
  </Step>

  <Step title="Notion API 키로 연결">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion18.png" />
    </Frame>

    <Accordion title="Notion API 키 생성 방법">
      <Steps>
        <Step title="API 키 생성 페이지로 이동">
          <Frame>
            <img className="block rounded-md" src="https://files.cloudtype.io/promm/images/ko/notion02.png" />
          </Frame>

          Notion 설정 메뉴 상단의 연결 페이지에서 `API 연결 개발 또는 관리`를 클릭하면 API 키 생성 페이지로 이동할 수 있습니다.
        </Step>

        <Step title="API 키 생성">
          <Frame>
            <img className="block rounded-md" src="https://files.cloudtype.io/promm/images/ko/notion03.png" />
          </Frame>

          이동한 페이지에서 `새 API 통합`을 클릭한 후 이름과 연결할 워크스페이스를 지정하고 `저장`하면 API 키가 생성됩니다.
        </Step>

        <Step title="사용 권한 설정">
          <Frame>
            <img className="block rounded-md" src="https://files.cloudtype.io/promm/images/ko/notion04.png" />
          </Frame>

          데이터를 활용할 페이지에 접근할 수 있도록 API 키에 권한을 부여해야 합니다. `사용 권한` 탭에서 `편집하기`를 클릭하고 접근을 허용할 페이지를 선택하세요.

          <Note>
            페이지에 동기화 블록(Synced block)을 사용한 경우 원본 페이지에도 사용 권한을 부여해야 데이터를 활용할 수 있습니다.
          </Note>
        </Step>

        <Step title="API 키 조회">
          <Frame>
            <img className="block rounded-md" src="https://files.cloudtype.io/promm/images/ko/notion05.png" />
          </Frame>

          구성 탭에서 `표시하기`를 클릭하면 API 키 값을 확인할 수 있습니다.

          <Tip>
            기능 섹션에서 `콘텐츠 업데이트`와 `콘텐츠 입력` 권한을 비활성화하면 읽기 전용으로 연결해 보안 수준을 높일 수 있습니다.
          </Tip>
        </Step>
      </Steps>
    </Accordion>
  </Step>

  <Step title="URL로 Notion 페이지 불러오기">
    <video autoPlay muted loop playsInline className="w-full aspect-video" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notionpage.mp4" />

    <Info>
      복사한 링크의 하위 페이지까지 포함하도록 설정할 수 있으며, 인덱싱된 데이터는 Porter AI의 지식베이스로 등록됩니다.
    </Info>

    <Accordion title="Notion 페이지 URL 확인 방법">
      <Frame>
        <img className="block rounded-md" src="https://files.cloudtype.io/promm/images/ko/notion07.png" />
      </Frame>

      > Notion 페이지 우측 상단의 <Icon icon="ellipsis" iconType="solid" size={15} color="9fa3a5" /> 아이콘을 클릭하면 페이지 링크를 복사할 수 있습니다.
    </Accordion>
  </Step>
</Steps>

### 생성한 지식베이스 관리하기

> 등록한 Notion 지식베이스의 내용을 조회·편집하고, 접근 권한을 설정하거나 원본 페이지의 변경 사항을 동기화할 수 있습니다.

<AccordionGroup>
  <Accordion title="데이터 조회 및 편집">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion13.png" />
    </Frame>

    추가된 지식베이스를 선택하면 인덱싱된 하위 페이지의 수와 내용을 확인할 수 있습니다. 하위 페이지 목록에서 <Icon icon="magnifying-glass" iconType="solid" size={15} color="9fa3a5" /> 아이콘을 클릭하면 인덱싱된 내용을 편집하고 저장할 수 있습니다.
  </Accordion>

  <Accordion title="접근 권한 설정">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion14.png" />
    </Frame>

    지식베이스 상단의 권한 탭에서 지식베이스를 사용할 수 있는 팀원과 접근 범위를 설정할 수 있습니다.

    <Info>
      팀원 초대 방법은 [팀원 초대 및 공유 설정](/ko/agents-and-bots#팀원-초대-및-공유-설정)을 참고하세요.
    </Info>
  </Accordion>

  <Accordion title="동기화 및 재색인">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion15.png" />
    </Frame>

    Notion 설정 탭에서 연결한 항목 우측의 <Icon icon="ellipsis-vertical" iconType="solid" size={15} color="9fa3a5" /> 아이콘을 클릭하면 전체 페이지 또는 지정한 페이지를 동기화하거나 재색인할 수 있습니다. 연결된 페이지를 삭제하는 것도 가능합니다.

    * **동기화**: Notion에서 수정된 내용만 지식베이스에 반영합니다.
    * **재색인**: 지정한 페이지의 전체 내용을 다시 불러와 지식베이스를 갱신합니다.

    <Tip>
      Notion 페이지가 변경된 경우 동기화를 실행하면 최신 내용을 기반으로 AI를 활용할 수 있습니다.
    </Tip>
  </Accordion>
</AccordionGroup>

## Notion MCP 연결 설정

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion21.png" />
</Frame>

> Notion 커넥터 설정 페이지에서 OAuth 방식으로 Notion을 연결하면 Notion MCP가 제공하는 도구로 Notion을 관리할 수 있습니다.

### 개인별 OAuth 인증

> 관리자가 Notion 커넥터의 개인별 인증을 활성화하면, 멤버 권한의 팀원은 채팅창에서 Notion 도구를 활성화한 후 OAuth 인증으로 연결된 Notion을 단독으로 활용할 수 있습니다.

<Tip>
  `도구 설정`에서 개인별 연결에 허용할 Notion MCP 도구를 선택할 수 있습니다. 이 설정은 스페이스의 모든 멤버에게 공통으로 적용됩니다.
</Tip>

### 공유 OAuth 인증

> 공유 인증은 하나의 Notion 계정을 OAuth 방식으로 연결해 스페이스의 모든 멤버가 공통으로 사용하는 방식입니다. 최대 3개까지 연결할 수 있으며, 부서나 업무 영역에 따라 서로 다른 Notion 계정을 나누어 연결할 수 있습니다.

<Note>
  공유 인증 시 모든 멤버가 같은 계정 권한으로 사용할 수 있습니다. 페이지 생성·수정·이동처럼 데이터를 변경하는 도구는 필요한 경우에만 활성화하세요.

  <Frame>
    <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion22.png" />
  </Frame>
</Note>

### Notion MCP 도구 설정

> `도구 설정`에서는 AI가 사용할 수 있는 MCP 도구를 활성화/비활성화할 수 있습니다.

<Accordion title="지원하는 Notion MCP 도구 목록">
  | 도구                           | 기능                                           |
  | ---------------------------- | -------------------------------------------- |
  | `notion-search`              | Notion 워크스페이스와 연결된 데이터 소스에서 페이지와 데이터를 검색합니다. |
  | `notion-fetch`               | Notion 페이지, 데이터베이스, 데이터 소스의 상세 내용을 조회합니다.    |
  | `notion-create-attachment`   | 첨부 파일을 생성해 Notion에 업로드합니다.                   |
  | `notion-download-attachment` | Notion에 등록된 텍스트 첨부 파일의 내용을 가져옵니다.            |
  | `notion-create-pages`        | 하나 이상의 Notion 페이지를 생성합니다.                    |
  | `notion-update-page`         | Notion 페이지의 속성이나 내용을 수정합니다.                  |
  | `notion-move-pages`          | 페이지나 데이터베이스를 다른 상위 페이지로 이동합니다.               |
  | `notion-duplicate-page`      | 기존 Notion 페이지를 복제합니다.                        |
  | `notion-create-database`     | 새로운 Notion 데이터베이스를 생성합니다.                    |
  | `notion-update-data-source`  | 데이터 소스의 스키마, 제목, 속성을 수정합니다.                  |
  | `notion-create-comment`      | 페이지나 특정 콘텐츠에 댓글을 작성합니다.                      |
  | `notion-get-comments`        | 페이지의 댓글과 토론 내용을 조회합니다.                       |
  | `notion-get-async-task`      | 비동기로 실행된 작업의 진행 상태를 확인합니다.                   |
  | `notion-get-teams`           | 현재 워크스페이스의 팀스페이스 목록을 조회합니다.                  |
  | `notion-get-users`           | 현재 워크스페이스의 사용자 목록을 조회합니다.                    |
  | `notion-query-data-sources`  | Notion 데이터베이스의 데이터를 조건에 따라 조회합니다.            |
  | `notion-query-database-view` | 데이터베이스 보기에 설정된 조건으로 데이터를 조회합니다.              |
  | `notion-query-meeting-notes` | 연결된 회의록 데이터 소스에서 회의 기록을 조회합니다.               |
  | `notion-create-view`         | Notion 데이터베이스에 새로운 보기를 생성합니다.                |
  | `notion-update-view`         | 데이터베이스 보기의 이름, 필터, 정렬, 표시 설정을 수정합니다.         |
</Accordion>

<Tip>
  Notion 데이터를 검색하고 조회하는 용도로만 사용한다면 검색·조회 관련 도구만 활성화하고, 페이지 생성·수정·이동처럼 데이터를 변경하는 도구는 비활성화하세요.
</Tip>

## AI로 Notion 활용하기

### 채팅창에서 사용

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion23.png" />
</Frame>

> 채팅창에서 추가한 Notion 지식베이스 또는 커넥터를 활성화하여 사용할 수 있습니다.

<Info>
  `내 계정`이라는 이름의 커넥터는 채팅 화면에서 OAuth 인증 후 사용할 수 있습니다.

  <Frame>
    <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/notion24.png" />
  </Frame>
</Info>

### 에이전트와 봇의 도구로 사용

> 에이전트 설정 과정에서 추가한 Notion 지식베이스 또는 커넥터를 활성화하여 에이전트의 도구로 활용할 수 있습니다. 자세한 내용은 [커스텀 에이전트 설정](/ko/agents-and-bots#커스텀-에이전트-추가하기)을 참고하세요.

### Slack 등 메신저에서 사용

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/connector.png" />
</Frame>

> 커넥터를 통한 메신저 연동 시, Notion 지식베이스 또는 커넥터를 활성화하면 연동한 메신저에서 AI가 활용합니다. 자세한 연동 방법은 아래의 링크에서 확인하세요.

<CardGroup cols={3}>
  <Card title="Discord Bot 연동" icon="discord" href="/ko/discord" />

  <Card title="Slack 워크스페이스 연동" icon="slack" href="/ko/slack" />

  <Card title="Telegram DM 연동" icon="telegram" href="/ko/telegram" />
</CardGroup>