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

# 도구

> BulkNotion이 Claude에 제공하는 도구와, 그중 무엇이 실제로 변경을 일으키는지 확인할 때 보세요.

도구는 아홉 개입니다. **여덟 개는 읽기만 하고**, 나머지 하나가 대량 업데이트를 실행합니다.

## 읽기

| 도구                  | 하는 일                                                |
| ------------------- | --------------------------------------------------- |
| `whoami`            | 어떤 계정인지, 플랜, 남은 페이지, 연결된 워크스페이스                     |
| `get_credits`       | 남은 페이지, 플랜 종류, 다음 리필 날짜                             |
| `list_workspaces`   | 연결된 노션 워크스페이스 목록                                    |
| `search_databases`  | 이름으로 데이터베이스 찾기                                      |
| `describe_database` | 핵심 도구. 필터 가능한 속성, 존재하는 템플릿, 페이지 수, 남은 크레딧을 **한 번에** |
| `preview_selection` | 조건에 맞는 건수와 예시 제목 몇 개. 아무것도 바꾸지 않음                   |
| `list_jobs`         | 최근 실행 내역과 진행 상황                                     |
| `get_job`           | 특정 실행의 상태 — 완료까지 추적할 때 사용                           |

`describe_database` 덕분에 Claude가 심문하듯 하나씩 묻는 대신 제대로 된 대화를 할 수 있습니다.
데이터베이스만 알려주면 어떤 속성이 있고 어떤 값을 갖는지, 어떤 템플릿이 있는지 이미 압니다.

## 실행

| 도구                  | 하는 일                         |
| ------------------- | ---------------------------- |
| `start_bulk_update` | 미리보기한 선택 범위의 모든 페이지에 템플릿을 적용 |

<Warning>
  변경을 일으키는 유일한 도구입니다. 페이지당 1크레딧을 소모합니다.

  기본 동작은 각 페이지에 템플릿을 **추가**하고 기존 내용은 그대로 두는 것입니다. 페이지를 먼저
  비우는 콘솔과 반대입니다. 지우길 원하시면 명시적으로 요청하셔야 하고, 그건 되돌릴 수 없습니다.

  또한 말 한마디로는 실행되지 않습니다 — **미리보기한 선택 범위**와 **확인하신 건수**가 있어야
  합니다. [주의할 점](/ko/mcp/safety) 참고.
</Warning>

## 실제 진행 순서

<Steps>
  <Step title="Claude가 데이터베이스를 찾음">
    `search_databases`로 찾고 `describe_database`로 세부 정보를 가져옵니다.
  </Step>

  <Step title="조건을 제안">
    추측이 아니라 실제로 존재하는 속성으로 만듭니다.
  </Step>

  <Step title="미리보기">
    `preview_selection`이 건수, 소모될 크레딧, 예시 페이지 제목 몇 개를 반환합니다 —
    의도한 대상이 맞는지 판단하실 수 있게.
  </Step>

  <Step title="동의">
    이전에는 아무것도 실행되지 않습니다.
  </Step>

  <Step title="실행하고 추적">
    `start_bulk_update` 후 완료될 때까지 `get_job`.
  </Step>
</Steps>

## 특정 페이지만 고르기

많은 페이지를 대상으로 할 때는 조건이 정답입니다. 몇 개만 지정하시려면 이름을 말씀하시면
Claude가 그것들을 넘깁니다 — 그 방식은 최대 100개까지입니다. 그보다 많으면 조건이 더 쉽고
안정적입니다.

## 다음

<CardGroup cols={2}>
  <Card title="주의할 점" icon="shield-exclamation" href="/ko/mcp/safety">
    크레딧, 되돌릴 수 없음, 사고를 막는 안전장치들.
  </Card>

  <Card title="크레딧과 플랜" icon="coins" href="/ko/credits">
    실행 비용.
  </Card>
</CardGroup>