Notion CLI(베타)로 터미널에서 Notion 사용하기

Notion CLI ntn은 개발자와 AI 코딩 에이전트가 터미널에 명령어를 입력하여 Notion을 사용할 수 있게 해주는 도구입니다. 명령줄에서 Notion 콘텐츠를 읽고 쓸 수 있으며, (사용 권한이 있는 경우) Workers를 관리할 수도 있습니다.

개발자 모드를 사용하면 Notion에서 Workers를 보고 로그를 읽을 수 있습니다. Workers를 배포하거나 코드 또는 설정을 변경해야 할 때는 CLI를 사용하세요.

이 문서는 개괄적인 내용을 다룹니다. 기술적인 설정은 개발자 문서를 참조하세요.

• 이 CLI는 개발자와 기술 빌더를 위해 설계되었으며,

• CLI는 모든 요금제에서 사용할 수 있습니다. 그러나 Notion Workers를 배포하고 관리하려면 비즈니스 또는 엔터프라이즈 요금제를 사용해야 합니다.

• CLI를 통해 사용하는 일부 개발자 플랫폼 기능에는 특정 요금제 또는 관리자 활성화가 필요할 수 있습니다.

• 문제가 있는 경우, 먼저 최신 버전의 CLI를 사용 중인지 확인하세요.

• Worker를 읽기 허용하거나, 로그를 읽거나, 끄거나 삭제하기만 하면 되는 경우에는 개발자 모드를 켠 후 Notion에서 수행할 수 있습니다.

CLI는 Mac, Linux, Windows에서 작동합니다. 이 중 어떤 운영 체제에서든 npm install -g ntn 명령어로 설치할 수 있습니다.

설치에 대한 자세한 내용은 개발자 문서를 참고하세요.

빠른 확인을 위한 다음 체크리스트부터 시작하세요.

1. CLI를 업데이트한 후 다시 시도하세요. CLI는 최신 상태로 유지되도록 설계되었으며, 이전 버전의 경우 작동 방식이 다를 수 있습니다.

2. 올바른 Notion 계정에 로그인했는지 확인하세요. 여러 계정이나 워크스페이스를 사용하는 경우, 로그아웃했다가 다시 로그인하세요.

3. 먼저 Notion에서 사용 권한을 확인하세요. Notion에서 페이지나 데이터베이스를 열 수 없는 경우, CLI에서도 해당 페이지나 데이터베이스를 읽거나 변경할 수 없습니다.

4. Workers 명령어를 사용하려는 경우, Workers가 활성화되어 있는지 확인하세요. Workers 사용 권한은 요금제 및 워크스페이스 소유자가 기능을 켰는지 여부에 따라 달라질 수 있습니다.

5. 여전히 해결되지 않나요? 명령어마다 절차가 다를 수 있으므로, 정확한 오류 및 해결 방법은 개발자 문서를 참고하세요.