> ## 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.

# 문제 해결

> 실행이 시작되지 않거나, 작업이 멈춘 것 같거나, 페이지가 실패했거나, 조건이 아무것도 못 잡을 때 보세요.

## 조건이 아무것도 못 잡을 때

<Warning>
  많이 걸릴 거라 예상한 조건인데 건수가 **0개**로 나옵니다.
</Warning>

<Steps>
  <Step title="속성이 맞는 데이터 소스에 있는지 확인">
    데이터 소스가 여러 개인 데이터베이스는 각 소스마다 속성이 다릅니다. 의도한 데이터 소스를
    고르고, 거기서 제공하는 속성으로 조건을 다시 만드세요.
  </Step>

  <Step title="값이 실제로 존재하는지 확인">
    선택·상태 조건은 정확한 옵션과 일치해야 합니다. 노션에서 `Done`과 `done`은 다른 값입니다.
  </Step>

  <Step title="조건을 뒤집어서 대조">
    조건을 반대로 해보세요 — `비어 있음` 대신 `비어 있지 않음`, 체크 해제 대신 체크됨.
    페이지가 있는 게 확실한 데이터베이스에서 **양방향 모두 0**이 나온다면 조건이 의도대로
    해석되지 않는 것이니, 속성 하나로 단순화한 뒤 다시 쌓아 올리세요.
  </Step>
</Steps>

## 실행이 시작되지 않을 때

### "다른 작업이 진행 중입니다"

**Claude에서 시작한** 실행은 서로를 기다립니다. 계정당 한 번에 하나씩이라 두 실행이 같은
페이지에서 충돌하지 않습니다.

현재 작업이 끝날 때까지 기다리셨다가(**History**에서 진행 상황 확인) 다시 요청하세요. 거부된
시도에는 과금되지 않았습니다.

<Note>
  콘솔은 이렇게 막지 않습니다. 실행 중에 콘솔에서 두 번째를 시작하면 둘 다 진행되니, 같은
  페이지를 대상으로 한다면 진행 중인 실행이 끝난 뒤에 시작하세요.
</Note>

### "크레딧이 부족합니다"

보유량보다 많이 필요해서 아무것도 건드리기 전에 거부된 것입니다. 조건을 좁히거나, 부스터를
추가하거나, 월간 리필을 기다리세요 —
[크레딧과 플랜](/ko/credits#크레딧이-부족할-때) 참고.

재시도해도 결과는 같습니다.

### "건수가 달라졌습니다"

미리보기와 실행 사이에 데이터베이스에 페이지가 추가되거나 삭제된 경우입니다. 확인하지 않으신
대상에 실행하는 대신, BulkNotion이 거부하고 다시 보시도록 요청합니다.

한 번 더 미리보기를 하시고, 새 숫자를 확인한 뒤 시작하세요.

## 작업이 멈춘 것 같을 때

<Warning>
  진행률이 같은 숫자에 한동안 머물러 있습니다.
</Warning>

진행은 페이지 단위가 아니라 **배치 단위**로 움직여서, 멈춰 있다가 건너뜁니다. 초당 4\~6페이지
정도가 정상이고, 1,000페이지 실행은 몇 분 걸립니다.

<Steps>
  <Step title="조금 기다리기">
    문제라고 판단하기 전에 20초쯤 뒤에 다시 확인해 보세요.
  </Step>

  <Step title="History 확인">
    실제로 실패한 작업은 거기에 실패로 표시되고 사유도 나옵니다.
  </Step>

  <Step title="작업 ID와 함께 문의">
    규모에 비해 훨씬 오래 걸린다면 History의 작업 ID를 보내 주세요.
  </Step>
</Steps>

## 일부 페이지가 실패했을 때

작업이 성공 건수와 함께 실패 건수를 보고합니다. 흔한 원인:

* **BulkNotion이 해당 페이지에 접근할 수 없음.** 노션 승인 때 포함되지 않았거나 그 뒤 옮겨진
  경우입니다. 다시 연결해 포함하세요 —
  [나중에 페이지 추가](/ko/notion-connection#나중에-페이지-추가).
* **실행 도중 페이지가 삭제됨.**
* **노션 속도 제한.** 큰 실행에서 가끔 발생합니다. 실패한 페이지만 다시 돌리면 대개 됩니다.

성공한 페이지는 이미 업데이트된 상태입니다. 다시 실행하면 새로 선택한 페이지에만 적용됩니다.

## 데이터베이스나 템플릿이 안 보일 때

<Warning>
  검색해도 데이터베이스가 나오지 않거나, 템플릿 목록이 비어 있습니다.
</Warning>

대부분 노션 승인 범위 문제입니다. BulkNotion은 노션 화면에서 선택하신 것만 볼 수 있습니다.

<Steps>
  <Step title="다시 연결해서 범위 넓히기">
    **Settings**에서 연결을 다시 실행하고 데이터베이스를 체크하세요. 템플릿이 있는 페이지도
    함께요.
  </Step>

  <Step title="워크스페이스 확인">
    여러 개를 연결하셨다면 전환기가 해당 데이터베이스가 있는 워크스페이스를 가리키는지
    확인하세요.
  </Step>

  <Step title="노션에 템플릿이 있는지 확인">
    템플릿 목록은 노션에서 그 데이터베이스에 정의된 템플릿에서 옵니다. 없다면 노션에서 먼저
    만드세요.
  </Step>
</Steps>

## Claude가 도구를 못 찾을 때

BulkNotion 커넥터를 다시 연결하라고 요청하세요. MCP 클라이언트는 도구 목록을 캐시하므로,
업데이트 전에 연결된 클라이언트는 예전 목록을 들고 있을 수 있습니다.

커넥터에 대해서는 [MCP 개요](/ko/mcp/overview)를 참고하세요.

## 그래도 안 되면

특정 실행에 관한 문제라면 History의 **작업 ID**와 함께 문의해 주세요. 저희가 무슨 일이
있었는지 확인하는 가장 빠른 방법입니다.