헤드리스 CMS이자 비주얼 페이지 빌더인 Storyblok에 앱을 연결해 게시된 콘텐츠를 제공하거나 Lovable 앱에서 스토리를 만들고 게시합니다.
Storyblok에 앱 연결하기
헤드리스 CMS이자 비주얼 페이지 빌더인 Storyblok에 앱을 연결해 게시된 콘텐츠를 제공하거나 Lovable 앱에서 스토리를 만들고 게시하세요.
Storyblok은 헤드리스 CMS입니다. Lovable 앱이 게시된 스토리나 미리보기 스토리를 가져올 수 있고, Storyblok 앱에서 관리하는 스토리를 만들고 수정하고 게시할 수도 있습니다. 편집 워크플로, 비주얼 페이지 빌딩, 구조화된 콘텐츠가 코드베이스 외부에 존재하는 앱을 위해 설계되었습니다.
이 통합은 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
Storyblok을 사용하면 앱에서 다음과 같은 작업이 가능합니다.
- Content Delivery API에서 게시된 스토리 또는 초안 스토리 가져오기
- Management API로 스토리 생성, 수정, 게시
- 공간의 에셋과 컴포넌트 스키마 조회
- Storyblok 리치 텍스트와 컴포넌트를 앱에서 렌더링
- 콘텐츠 필드에서 SEO 메타데이터(title, description, 소셜 이미지) 구동
Content Delivery API 연결은 읽기 전용입니다. Management API 연결은 로그인 과정에서 승인한 공간의 콘텐츠를 변경할 수 있습니다.
주요 활용 사례 및 예시 앱
다음 예시는 Storyblok으로 무엇을 만들 수 있는지 보여줍니다. 각 항목에는 시작용 프롬프트가 포함되어 있습니다.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| Storyblok 기반 마케팅 사이트 | Use Storyblok and build a marketing site that pulls landing pages, blog posts, and navigation from Storyblok. | Storyblok에서 관리하는 콘텐츠로 전체 마케팅 사이트를 렌더링합니다. 앱이 슬러그로 스토리를 가져와 일치하는 컴포넌트를 렌더링하고 SEO 메타데이터를 설정하므로 에디터가 코드 변경 없이 페이지를 출시할 수 있습니다. |
| 블로그 또는 편집 사이트 | Use Storyblok and build a blog that lists articles, supports tag filtering, and renders rich text from Storyblok. | Storyblok 스토리로 구동되는 편집 읽기 경험을 구축합니다. 앱이 스토리 목록을 페이지네이션하고, 태그나 콘텐츠 타입으로 필터링하며, 각 포스트의 리치 텍스트와 임베디드 컴포넌트를 렌더링합니다. |
| 제품 카탈로그 또는 디렉터리 | Use Storyblok and build a product directory where editors manage listings in Storyblok and the app renders detail pages by slug. | Storyblok 스토리를 구조화된 디렉터리로 전환합니다. 앱이 필터와 함께 항목을 나열하고, 슬러그로 상세 페이지에 링크하며, 전적으로 Storyblok에서 관리되는 필드를 렌더링합니다. |
| 문서 또는 지식 베이스 | Use Storyblok and build a docs site with sections, a sidebar, and search-friendly pages from Storyblok. | 탐색 가능한 구조로 Storyblok에서 문서를 게시합니다. 앱이 스토리 트리를 읽고, 폴더 경로에서 내비게이션을 구축하며, 풍부한 콘텐츠에서 각 페이지를 렌더링합니다. |
| 다국어 콘텐츠 사이트 | Use Storyblok and build a localized site that renders content in the visitor's language using Storyblok translations. | 단일 Storyblok 공간에서 현지화된 경험을 제공합니다. 앱이 라우트별로 올바른 언어 버전을 가져오고 번역이 없으면 기본 언어로 폴백합니다. |
| 에디터를 위한 미리보기 환경 | Use Storyblok and build a preview site that shows draft content for editors before publishing. | 에디터가 게시되지 않은 작업을 검토할 수 있는 방법을 제공합니다. 미리보기 토큰으로 연결하면 앱이 초안 콘텐츠를 요청하므로 에디터가 진행 중인 스토리를 라이브 전에 볼 수 있습니다. |
| 콘텐츠 운영 콘솔 | Use Storyblok and build an internal tool that creates stories and publishes approved pages. | 팀이 직접 만든 앱에서 Storyblok 스토리를 관리하게 합니다. 앱이 Management API 연결로 스토리를 만들고 수정한 뒤 에디터가 변경을 승인하면 게시합니다. |
Storyblok 연결 방법
Storyblok 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 다릅니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise에서는 처음에 사실상 비활성화되어 있으며, admin이 Connectors → Admin settings → App + chat connectors에서 바꾸기 전까지 연결 및 클라이언트를 만들 수 있는 사용자가 No one으로 설정됩니다.
Storyblok은 두 가지 API를 제공하며 연결을 추가할 때 어느 쪽을 연결할지 선택합니다.
- CDN API(기본값): Content Delivery API 액세스 토큰으로 게시 콘텐츠나 미리보기 콘텐츠를 가져오는 읽기 전용 접근
- Management API: Storyblok 계정으로 로그인해 승인한 공간에서 콘텐츠를 만들고 수정하고 게시하는 읽기·쓰기 접근
서로 다른 계정이나 액세스 토큰을 사용하여 여러 Storyblok 연결을 만들 수 있습니다. 이는 환경 분리(예: 개발과 프로덕션), 다른 공간이나 지역 대상 지정, 게시된 콘텐츠와 미리보기 콘텐츠 간 전환에 유용합니다.
연결이 만들어지면 사용할 프로젝트에 연결할 수 있습니다. 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에게 자신의 프로젝트를 연결해 달라고 요청할 수 있습니다.
사전 요구사항
Storyblok을 연결하기 전에 다음을 준비하세요.
- Storyblok 계정과 공간(space)
- 해당 공간이 호스팅되는 지역
- CDN API(가장 일반적)의 경우, 해당 공간의 Content Delivery API 액세스 토큰(public 또는 preview)
- Management API의 경우, 로그인해 Lovable을 인가할 Storyblok 계정 자격 증명
- Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참조)
이 커넥터를 통한 모든 API 요청은 Storyblok 플랜 한도에 포함됩니다. 청구와 할당량은 Lovable이 아닌 Storyblok에서 직접 처리됩니다.
필요한 API에 따라 아래 설정 단계를 따르세요.
CDN API는 읽기 전용이며 앱이 게시 콘텐츠나 미리보기 콘텐츠를 가져올 수 있게 합니다. Storyblok 콘텐츠를 표시하는 앱이 가장 많이 고르는 선택지입니다. Storyblok 공간의 Content Delivery API 액세스 토큰으로 연결합니다.
1단계: Storyblok CDN API 액세스 토큰 발급
Content Delivery API 액세스 토큰을 사용하면 Lovable 앱이 Storyblok 공간에서 콘텐츠를 가져올 수 있습니다. 게시된 콘텐츠와 미리보기 콘텐츠를 위해 별도의 토큰을 만들 수 있습니다.
Storyblok 액세스 토큰을 만드는 방법은 다음과 같습니다.
Storyblok 공간 열기
Storyblok 앱에 로그인하고 연결할 공간을 엽니다.
액세스 토큰 열기
Settings → Access Tokens으로 이동합니다.
새 토큰 생성
Generate new token을 클릭하고 Lovable integration처럼 알아보기 쉬운 이름을 입력한 뒤 액세스 수준을 선택합니다.
- Public: 게시된 콘텐츠만 반환합니다. 프로덕션 사이트에 사용하세요.
- Preview: 게시된 콘텐츠와 초안 콘텐츠를 반환합니다. 스테이징이나 에디터 미리보기 환경에 사용하세요.
Generate를 클릭하고 토큰을 복사합니다.
공간 지역 확인
공간의 지역(EU, US, CA, AP, 또는 CN)을 확인하세요. 공간 설정에서 찾을 수 있으며 Lovable에서 선택하는 지역과 일치해야 합니다.
액세스 토큰은 비밀번호처럼 작동합니다. 안전하게 보관하고 절대 공개하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Storyblok 문서를 참고하세요. Content Delivery API v2
2단계: Storyblok을 Lovable에 연결
액세스 토큰을 준비했으면 Lovable에서 연결을 추가합니다.
Connectors에서 Storyblok 열기
Connectors를 열고 Storyblok을 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 Details, Configure connection, Sharing 세 개의 접이식 섹션으로 나뉩니다.
연결 이름 지정
Details 아래에서 Lovable이 연결 이름을 채워 주며 원하면 바꿀 수 있습니다. 이 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다.
CDN API 선택
Configure connection 아래에서 CDN API를 선택합니다. 액세스 토큰을 쓰는 옵션입니다.
연결 구성
Configure connection 아래에서 다음을 입력합니다.
- Space region: Storyblok 공간이 호스팅되는 지역을 선택합니다. European Union (EU)(기본값), United States (US), Canada (CA), Australia / APAC (AP), China (CN) 중에서 고릅니다. 지역은 토큰이 속한 공간과 일치해야 합니다. US 공간의 토큰은 EU 지역에 인증되지 않습니다.
- Public or preview access token: Content Delivery API 액세스 토큰을 붙여넣습니다.
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 선택한 지역의 Storyblok Content Delivery API로 토큰을 검증합니다.
Management API는 승인한 공간에서 콘텐츠를 만들고 수정하고 게시할 수 있는 읽기·쓰기 접근을 제공합니다. 앱이 콘텐츠를 표시하는 데 그치지 않고 관리해야 한다면 이쪽을 선택하세요. Storyblok 계정으로 로그인해 연결합니다.
Connectors에서 Storyblok 열기
Connectors를 열고 Storyblok을 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 위치를 참고하세요.
연결 추가
Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 Details, Configure connection, Sharing 세 개의 접이식 섹션으로 나뉩니다.
연결 이름 지정
Details 아래에서 Lovable이 연결 이름을 채워 주며 원하면 바꿀 수 있습니다. 이 이름은 Lovable 내부에서 연결을 식별하는 데만 사용됩니다.
Management API 선택
Configure connection 아래에서 Management API를 선택합니다.
공간 지역 선택
Space region 아래에서 이 연결이 관리할 Storyblok 공간의 지역을 선택합니다. European Union (EU)(기본값), United States (US), Canada (CA), Australia / APAC (AP), China (CN) 중에서 고릅니다. 지역은 로그인 과정에서 승인하는 공간과 일치해야 합니다.
Scope 검토(선택 사항)
Scopes 아래에서 앱이 요청하는 권한을 검토합니다. Refresh access, Read spaces, Read stories는 항상 포함됩니다. 모든 읽기 권한과 대부분의 쓰기·게시 권한이 기본으로 선택되어 있습니다. 공간, 공동 작업자, 릴리스, 웹훅, 사용자, 워크플로에 대한 쓰기 접근은 기본으로 꺼져 있습니다.
전체 scope 문서는 Storyblok의 scope 레퍼런스를 참고하세요.
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
Storyblok에 연결하고 인가
Connect를 클릭합니다. Storyblok 인가 창이 열리므로 브라우저가 팝업을 차단하지 않도록 하세요. 차단하면 Lovable이 대신 리디렉션합니다.
요청이 뜨면 Storyblok에 로그인하고, 권한을 부여할 공간을 선택하고, 요청된 권한을 검토한 뒤 앱을 인가합니다.
확인 메시지와 함께 Lovable로 돌아옵니다.
연결되면 프로젝트에서 빌드하는 사용자는 누구나(구성된 connection-level access 기준) 채팅에서 Lovable에게 자신의 프로젝트를 Storyblok에 연결해 달라고 요청할 수 있습니다. 앱이 할 수 있는 일은 어느 API를 연결했는지에 따라 달라집니다. CDN API 연결은 콘텐츠를 가져오는 읽기 전용이고, Management API 연결은 콘텐츠를 만들고 수정하고 게시할 수 있습니다.
게시 콘텐츠와 미리보기 콘텐츠 작업
Storyblok Content Delivery API는 토큰과 요청에 따라 다른 콘텐츠를 반환합니다.
- Public 토큰은 게시된 콘텐츠만 반환합니다.
- Preview 토큰은 게시된 콘텐츠와 초안 콘텐츠를 반환할 수 있습니다.
Lovable에 프롬프트할 때 어떤 버전을 원하는지 언급하세요. 예를 들어 에디터 미리보기에는 "초안 콘텐츠 보여줘", 프로덕션 사이트에는 "게시된 콘텐츠 사용해줘"라고 말합니다.
제한 사항
Storyblok 커넥터는 다음을 할 수 없습니다.
- Storyblok 웹훅이나 게시 이벤트 수신. Storyblok의 변경에 반응해야 한다면 앱에 자체 엔드포인트가 필요합니다.
- 연결 하나에서 둘 이상의 지역 사용. 각 연결은 선택한 지역 하나를 사용합니다.
- 엔드 유저별 Storyblok 로그인 지원. 각 연결은 링크된 모든 프로젝트에서 공유되는 단일 Storyblok 계정 또는 액세스 토큰을 나타냅니다.
Storyblok 쪽에서 인가가 취소되면 API 호출이 다시 성공하기 전에 Lovable에서 통합을 다시 연결해야 합니다.
Storyblok 연결 관리
연결은 Connectors에서 관리합니다. **Storyblok**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Storyblok 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, Storyblok을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.