# Notion

> 특정 Notion 페이지와 데이터베이스에 대한 접근을 에이전트에게 주고 — 읽고, 조회하고, 새 페이지를 씁니다.

Notion 커넥터는 에이전트가 워크스페이스를 검색하고, 페이지를 일반 텍스트로 읽고, 데이터베이스를 조회하고, 페이지를 만들거나 이어 쓰게 해줍니다.

## 언제 쓰는가

Notion 은 팀이 맥락을 쌓아두는 곳입니다. 그것이 없으면 에이전트에게 일일이 말해줘야 하는 것들 — 스펙, 회의록, 프로젝트 트래커 — 이죠. 읽을 수 있는 에이전트는 배경을 묻지 않게 되고, 결과물도 팀이 이미 보고 있는 곳에 정리해 둘 수 있습니다.

## 연결하기

<Steps>

1. **[에이전트 빌더](/ko/docs/build/agent-builder/)에서 커넥터를 열고** Notion 을 고릅니다.

2. **로그인하고 무엇을 공유할지 고릅니다.** Notion 의 동의 화면이 통합이 접근할 페이지를 묻습니다. 이것이 접근 통제이고, Notion 쪽에 있습니다.

3. **연결을 에이전트에 바인딩합니다.**

</Steps>

<Aside type="caution" title="결과가 비었다면 대개 페이지가 공유되지 않은 것입니다">
  아무것도 찾지 못한 검색은 철자 문제보다 공유 문제인 경우가 많습니다. 승인할 때 포함되지
  않았거나 그 뒤에 만들어진 페이지라면, Notion 의 페이지 메뉴에서 통합에 공유하세요.
</Aside>

## 에이전트가 할 수 있는 일

| 작업 | 관문 |
| --- | --- |
| 제목으로 페이지·데이터베이스 검색 | 없음 |
| 중첩 목록과 토글을 포함해 페이지를 일반 텍스트로 읽기 | 없음 |
| 속성 하나로 필터링해 데이터베이스 조회 | 없음 |
| 페이지 아래나 데이터베이스 안에 페이지 생성 | 없음 |
| 기존 페이지에 내용 이어 쓰기 | 없음 |

Notion 에는 기본적으로 관문에 걸리는 작업이 없습니다. 위 작업 중 바깥으로 무언가를 보내거나 데이터를 지우는 것이 없기 때문입니다. 생성과 이어 쓰기는 워크스페이스를 바꾸긴 합니다. 에이전트는 위치와 제목을 먼저 확인하도록 지시받지만, [승인](/ko/docs/work/approvals/) 관문이 막지는 않습니다.

## 다루기

- **검색을 먼저 하세요.** 에이전트는 페이지를 읽거나 이어 쓰기 전에 식별자가 필요합니다. 그래서 *"로드맵 페이지 업데이트해줘"* 같은 막연한 지시는 검색 한 단계를 더 씁니다. 페이지 링크를 붙여넣는 편이 빠릅니다.
- **아주 긴 페이지는 잘립니다.** 페이지를 읽으면 들어가는 만큼 돌려주고 잘렸다고 알려줍니다. 큰 문서는 섹션을 가리켜 주세요.
- **데이터베이스 조회는 속성 하나로 필터링합니다.** 조건이 여럿인 복잡한 뷰는 Notion 에서 만들고 그 결과를 에이전트가 읽게 하는 편이 낫습니다.

## 한계

- 에이전트는 Notion 에서 통합에 공유한 것만 봅니다.
- 읽기는 일반 텍스트를 돌려줍니다. 페이지 안의 데이터베이스, 동기화 블록, 복잡한 레이아웃 같은 Notion 고유 구조는 평평해지고, 서식이 그대로 왕복하지는 않습니다.
- 삭제 작업은 없습니다.
- 에이전트가 만든 페이지는 Notion 통합의 소유이며 페이지 기록에도 그렇게 표시됩니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="커넥터 개요"
    href="/ko/docs/connect/overview/"
    description="연결과 바인딩, 그리고 접근 해지."
  />
  <LinkCard
    title="프로젝트"
    href="/ko/docs/capabilities/projects/"
    description="매번 가져오는 대신 맥락을 Endue 안에 두기."
  />
  <LinkCard
    title="연결 가능한 서비스"
    href="/ko/docs/connect/available-connectors/"
    description="Linear · GitLab, 그리고 카탈로그의 나머지."
  />
</CardGrid>