Notion CLI로 터미널에서 Notion 사용하기

설정 방법과 일반적인 문제 해결 방법을 비롯해 명령줄에서 Notion을 사용하는 데 도움이 되는 기초 지식을 알아보세요 👩🏽💻
자주 묻는 질문(FAQ)으로 이동Notion CLI ntn은 개발자와 AI 코딩 어시스턴트가 Notion 앱에서 여기저기를 클릭하는 대신 명령어를 입력하여 Notion을 읽고 업데이트할 수 있도록 해주는 명령줄 인터페이스 도구입니다. 명령줄에서 Notion 콘텐츠를 읽고 쓸 수 있으며, Workers를 관리할 수 있습니다(사용 권한이 있는 경우).
이 문서에서는 개괄적인 개요를 다룹니다. 기술 설정에 관한 내용은 개발자 문서에서 확인하세요.
시작하기 전에 알아둘 사항
이 CLI는 개발자와 기술 빌더를 위해 설계되었으며,
모든 요금제에서 사용할 수 있습니다. 그러나 Notion Worker를 배포하고 관리하려면 비즈니스 또는 엔터프라이즈 요금제를 사용해야 합니다.
CLI를 통해 사용하는 일부 개발자 플랫폼 기능에는 특정 요금제 또는 관리자 활성화가 필요할 수 있습니다.
문제가 있는 경우, 먼저 최신 버전의 CLI를 사용 중인지 확인하세요.
문제가 발생하는 경우
먼저 다음 사항을 간단히 확인해 보세요.
CLI를 업데이트한 다음 다시 시도하세요. CLI는 최신 상태로 유지되도록 설계되었으며, 이전 버전의 경우 작동 방식이 다를 수 있습니다.
올바른 Notion 계정으로 로그인했는지 확인하세요. 계정이나 워크스페이스가 여러 개인 경우, 로그아웃한 후 다시 로그인하세요.
먼저 Notion에서 사용 권한을 확인하세요. Notion에서 페이지나 데이터베이스를 열 수 없는 경우, CLI에서도 해당 페이지나 데이터베이스를 읽거나 변경할 수 없습니다.
워커 명령을 사용하려는 경우, 워커가 활성화되어 있는지 확인하세요. Workers 사용 권한은 이용 중인 요금제와 워크스페이스 소유자가 이를 활성화했는지 여부에 따라 달라질 수 있습니다.
여전히 문제가 해결되지 않았나요? 명령어마다 절차가 다를 수 있으므로 정확히 일치하는 오류와 적절한 해결 방법은 개발자 문서를 참고하여 알아보세요.
자주 묻는 질문(FAQ)
Notion을 사용하려면 CLI가 필요한가요?
아니요. CLI는 선택 사항이며 개발자 워크플로용입니다.
CLI는 모바일에서 작동하나요?
아니요. CLI는 데스크톱의 터미널에서 실행됩니다.
명령어의 전체 목록은 어디에서 볼 수 있나요?
전체 명령어 목록은 개발자 문서에서 확인하세요.
