문서·위키·데이터베이스를 위한 올인원 워크스페이스 Notion에 앱을 연결해 페이지를 읽고 쓰고, 데이터베이스를 조회하고, 팀이 Notion에서 관리하는 콘텐츠로 앱을 구축하세요.
Notion은 문서, 위키, 프로젝트, 데이터베이스를 위한 워크스페이스입니다. Notion 앱 커넥터는 Lovable 앱이 팀이 공유한 페이지·데이터베이스에 접근할 수 있게 해주며, Notion 콘텐츠를 사용자 대상 경험으로 바꾸거나 정형 데이터를 Notion에 단일 진실 공급원으로 다시 기록하는 앱을 만들 수 있습니다.
이것은 Lovable로 만든 앱을 위한 Notion 앱 커넥터 입니다. 생성된 앱이 런타임에 Notion 콘텐츠를 읽고 씁니다.
대신 Lovable 에이전트가 빌드 중 Notion 문서를 읽도록 하고 싶다면 Notion 채팅 커넥터(MCP)를 사용하세요. 별도의 설정이 필요한 별개 통합입니다.
Notion을 사용하면 앱에서 다음을 할 수 있습니다.
- Notion 워크스페이스에서 페이지·블록·리치 텍스트 읽기
- 필터·정렬·페이지네이션으로 Notion 데이터베이스 조회
- 새 페이지 생성, 기존 페이지에 블록 추가
- 데이터베이스 행 업데이트(예: 상태, 담당자, 마감일)
- 편집자가 Notion에서 작업하는 콘텐츠 관리 사이트와 대시보드 운영
각 Notion 연결은 하나의 Notion 워크스페이스에 대해 권한이 부여되며, 권한 부여 시 명시적으로 통합과 공유된 페이지·데이터베이스만 볼 수 있습니다. 여러 워크스페이스에 걸쳐 작업하거나 환경을 분리하려면 여러 연결을 만들 수 있습니다.
일반적인 사용 사례와 예시 앱
| 예시 앱 | 예시 프롬프트 | 설명 |
|---|---|---|
| Notion 기반 마케팅 사이트 | Use Notion and build a marketing site that pulls landing pages and a blog from a Notion database. | Notion에서 관리하는 콘텐츠로 마케팅 사이트 렌더링. 앱이 슬러그로 페이지를 가져와 일치하는 컴포넌트를 렌더링하고, 편집자는 코드를 건드리지 않고 업데이트를 배포할 수 있습니다. |
| 사내 지식 베이스 또는 위키 | Use Notion and build a searchable knowledge base from our company wiki in Notion. | Notion 위키를 빠르게 검색 가능한 사이트로 변환. 앱이 페이지 트리를 읽어 내비게이션을 만들고, 각 글에 대해 리치 텍스트와 임베디드 블록을 렌더링합니다. |
| 고객 대상 도움말 센터 | Use Notion and build a help center that lists articles by category from a Notion database. | 깔끔한 읽기 경험으로 Notion 도움말 글 발행. 앱이 카테고리별로 페이지네이션하고 리치 텍스트를 렌더링하며, 메타데이터는 전적으로 Notion에서 관리됩니다. |
| 프로젝트 트래커 대시보드 | Use Notion and build a project tracker that shows tasks from our Notion database, grouped by status, with filters for owner and due date. | Notion 데이터베이스를 집중된 대시보드로 활용. 앱이 데이터베이스를 조회하고 UI에서 행을 그룹화·필터링해, 팀이 한눈에 진행 상황을 볼 수 있게 합니다. |
| Notion으로 들어가는 리드 캡처 폼 | Build a lead capture form. When someone submits it, create a new row in our Leads database in Notion. | 폼 제출을 Notion 데이터베이스로 푸시. 앱이 입력을 검증하고 대상 데이터베이스에 새 페이지를 만들어, 영업이 Notion에서 리드를 작업할 수 있게 합니다. |
| 에디토리얼 콘텐츠 사이트 | Use Notion and build a blog that lists articles from a Notion database, supports tag filtering, and renders rich text. | Notion 페이지 기반 에디토리얼 읽기 경험 구축. 앱이 글을 페이지네이션하고 태그로 필터링하며, 리치 텍스트와 임베디드 블록을 렌더링합니다. |
| 상태 페이지 또는 체인지로그 | Use Notion and build a public changelog that pulls release notes from a Notion database. | 팀이 Notion에서 릴리스 노트를 작성하고 공개로 노출. 앱이 새 항목을 읽어 시간 순으로 렌더링하고 RSS 스타일 피드를 노출합니다. |
Notion 연결의 동작 방식
Lovable은 중앙에서 관리하는 하나의 Notion 앱을 사용해 모든 워크스페이스의 Notion 통합을 처리합니다. Lovable 워크스페이스 내에서는 다음과 같습니다.
- 여러 Notion 연결을 만들 수 있습니다.
- 각 연결은 하나의 Notion 워크스페이스에 묶인 별도의 OAuth 권한 부여입니다.
- 각 연결은 권한 부여 시 공유된 페이지·데이터베이스만 볼 수 있으며, 해당 Notion 워크스페이스의 다른 콘텐츠에는 접근할 수 없습니다.
- 단일 Lovable 워크스페이스의 여러 프로젝트가 같은 연결을 사용할 수 있습니다.
덕분에 환경 분리(예: 개발/프로덕션)나 단일 Lovable 워크스페이스에서 여러 Notion 워크스페이스 작업이 쉬워집니다.
Notion은 안전한 OAuth 처리와 자동 토큰 갱신을 위해 Lovable의 게이트웨이 아키텍처를 사용합니다. 인증과 사용 제한에 대한 자세한 내용은 게이트웨이 기반 커넥터를 참고하세요.
Notion 연결 방법
워크스페이스 admin 과 owner 가 Notion을 연결할 수 있습니다.
사전 요구 사항
Notion 연결 전에 다음을 준비하세요.
- 통합을 설치할 수 있는 Notion 워크스페이스(또는 관리자 승인 요청 가능)
- 앱에 필요한 페이지·데이터베이스를 공유할 수 있는 Notion 권한
- Lovable 워크스페이스 admin 또는 owner 역할
이 커넥터를 통한 모든 API 요청은 Notion 워크스페이스로 전달됩니다. Notion API 사용량은 Notion 요금제 한도에 포함되며, Lovable이 아닌 Notion이 직접 처리합니다.
1단계: 통합과 공유할 콘텐츠 결정
Notion은 통합과 명시적으로 공유된 콘텐츠만 노출합니다. 권한 부여 전에 앱이 읽거나 쓸 페이지·데이터베이스를 결정하세요.
여러 페이지를 개별로 공유하는 대신, 최상위 페이지(또는 데이터베이스) 하나를 공유하고 앱이 Notion의 일반 상속을 통해 그 아래 모든 항목에 접근하도록 하세요.
2단계: Lovable에 Notion 연결
서로 다른 Notion 워크스페이스에 권한을 부여하거나 환경을 분리하기 위해 여러 연결을 만들 수 있습니다.
Connectors에서 Notion 열기
Connectors → App connectors 로 이동해 Notion 을 선택합니다.
연결 추가
Add connection 을 클릭합니다.
연결 구성
- Display name: 연결 이름을 지정합니다(예:
Notion Prod). - Who can access this connection: 특정 사람으로 제한하거나 워크스페이스 전체를 초대합니다. 자세한 내용은 연결 단위 접근을 참고하세요.
Notion에 연결하고 권한 부여
- Connect 를 클릭합니다. Notion 권한 부여 창이 열립니다. 브라우저의 팝업 차단이 꺼져 있는지 확인하세요.
- 필요하면 Notion에 로그인하고 연결할 워크스페이스를 선택합니다.
- Select pages 화면에서 앱이 접근할 페이지·데이터베이스를 선택합니다. 이후 Notion 내부에서 업데이트할 수 있습니다.
- 요청된 권한을 검토하고 Allow access 를 클릭합니다. 확인 메시지와 함께 Lovable로 돌아옵니다.
연결되면 Lovable 앱이 Notion 페이지와 데이터베이스를 읽고 쓰기 시작합니다.
공유된 페이지·데이터베이스 다루기
Notion의 권한 모델은 opt-in 방식입니다. 통합은 명시적으로 공유된 콘텐츠만 볼 수 있습니다.
- 앱이 봐야 할 콘텐츠를 보지 못한다면, Notion에서 통합과 페이지·데이터베이스를 공유하세요(Share → Connections → Add connections).
- 부모 페이지를 공유하면 하위 페이지도 자동으로 통합과 공유됩니다.
- Lovable 연결을 제거하지 않고도 언제든지 Notion 내부에서 접근을 취소할 수 있습니다. 연결은 유지되며 통합이 보는 콘텐츠가 줄어듭니다.
- 앱이 만들거나 업데이트한 페이지는 Notion 페이지 히스토리에서 개별 사용자가 아니라 통합으로 표시됩니다.
Lovable에 프롬프트를 줄 때 앱이 사용할 데이터베이스나 페이지를 명시적으로 지정하세요. 예: "use the Tasks database to populate the dashboard".
제한사항
Notion 커넥터로 할 수 없는 것:
- 들어오는 Notion 웹훅·이벤트 수신(예: "페이지 업데이트됨" 알림)
- 통합과 공유되지 않은 페이지·데이터베이스 접근
- 최종 사용자별 인증(각 연결은 앱 사용자 모두가 공유하는 단일 Notion 권한 부여를 사용)
- Notion 워크스페이스 관리(멤버 관리, 권한, 결제)
같은 Notion 로그인과 Notion 워크스페이스를 공유하는 여러 커넥터는 페이지 권한도 공유하며, 가장 최근에 구성된 커넥터가 모든 커넥터의 권한을 덮어씁니다.
앱이 Notion 변경에 실시간으로 반응해야 한다면 푸시 이벤트에 의존하기보다 폴링 패턴(예: 일정 간격으로 데이터베이스 조회)을 구현하세요.
Notion 연결에서 프로젝트 연결 해제
Editor 이상은 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용 가능합니다.
프로젝트 연결 해제:
Connectors 열기
Connectors 를 열고 App connectors 로 이동한 뒤 Notion 을 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects 에서 해제할 프로젝트를 체크합니다.
확인
Unlink projects 를 클릭하고 확인합니다.
해제되면 해당 프로젝트는 이 연결을 통해 Notion에 접근할 수 없게 됩니다. 프로젝트에 Notion이 다시 필요하면 사용 가능한 연결에 다시 연결할 수 있습니다.
Notion 연결 삭제
워크스페이스 admin과 owner가 Notion 연결을 삭제할 수 있습니다.
연결을 삭제하는 것은 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 자격 증명이 제거되며, 이 연결을 사용하는 앱은 새 연결을 추가할 때까지 작동을 멈춥니다.
삭제 전 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 확인하세요.
연결 삭제:
Connectors 열기
Connectors 를 열고 App connectors 로 이동한 뒤 Notion 을 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토
Linked projects 섹션을 확인합니다.
삭제
Delete this connection 에서 Delete 를 클릭하고 확인합니다.