Lovable API 커넥터로 Lovable에서 만든 앱이 연결된 워크스페이스의 프로젝트, 게시, 분석, 멤버, 보안 인사이트를 읽고 관리하게 설정합니다.

앱을 Lovable API에 연결하기

앱을 Lovable API에 연결하여 연결된 Lovable 워크스페이스의 프로젝트를 나열·관리하고, 게시하고, 프로젝트 미리보기를 임베드하고, 분석·멤버·보안 인사이트를 읽습니다.

Lovable API는 Lovable 워크스페이스와 프로젝트에 프로그래밍 방식으로 접근하게 해 줍니다. Lovable API 커넥터를 사용하면 Lovable로 만든 앱이 서버 코드에서 이 API를 호출할 수 있습니다. 따라서 앱이 연결된 Lovable 계정을 관리하고 보고서를 만들 수 있습니다. Lovable에서 작업을 운영하면서 자체 dashboard, admin tool, 자동화를 만들고 싶은 팀을 위해 설계되었습니다.

Lovable API는 app + chat 커넥터로 사용할 수 있습니다. 하나의 공유 연결이 빌드 중에는 프로젝트 채팅에서, 게시된 앱에서는 앱 안에서 동작합니다.

Lovable을 프로그래밍 방식으로 사용하는 방법은 세 가지이며, 각각 실행 위치가 다릅니다.

기능	실행 위치	하는 일
Lovable API 커넥터(이 페이지)	Lovable로 만든 앱. API 키는 Lovable이 저장합니다.	앱이 연결된 Lovable 워크스페이스를 읽고 관리합니다.
Lovable API	직접 만든 스크립트와 서비스. API 키는 직접 저장하고 관리합니다.	Lovable 외부의 모든 것이 REST API를 직접 호출합니다.
Lovable MCP 서버	ChatGPT, Claude, Cursor 같은 AI 클라이언트	외부 AI 도구가 Lovable 프로젝트를 만들고, 편집하고, 관리합니다.

Lovable API로 앱은 다음을 할 수 있습니다.

워크스페이스 세부 정보와 프로젝트 목록을 가져오고 프로젝트 세부 정보를 읽기
프로젝트 설정 업데이트 및 프로젝트 삭제
프로젝트 게시 또는 게시 취소, 배포 상태 추적, 게시 설정 업데이트
수명이 짧은 embed URL로 프로젝트의 빌드된 미리보기를 앱에 임베드
프로젝트 트래픽 분석과 워크스페이스 수준 분석 읽기
코드 보안 스캔과 발견 항목 읽기
멤버, 그룹, 보안 인사이트 같은 관리 데이터 읽기

이 커넥터는 Lovable API만 다룹니다. Lovable agent에 채팅 메시지나 빌드 메시지를 보낼 수는 없습니다(제한 사항 참조). Lovable 워크스페이스 위에 만드는 내부 dashboard, client portal, 운영 도구에 적합합니다.

일반적인 사용 사례와 예시 앱

다음 예시는 Lovable API로 무엇을 만들 수 있는지 보여줍니다. 각 항목에는 시작용 프롬프트가 포함되어 있습니다.

예시 앱	예시 프롬프트	설명
워크스페이스 프로젝트 디렉터리	Use the Lovable API and build a page that lists the projects in our Lovable workspace with their publish status.	모든 프로젝트를 한곳에서 확인합니다. 앱이 연결된 워크스페이스에서 프로젝트를 읽고 상태와 최근 활동을 보여줍니다.
게시 dashboard	Use the Lovable API and build an admin page where we can publish projects and track deployment status.	자체 도구에서 release를 실행합니다. 앱이 게시를 트리거하고 각 배포가 완료될 때까지 상태를 polling합니다.
보안 posture 보고서	Use the Lovable API and build a report of security scan results across our projects.	워크스페이스 보안을 살펴봅니다. 앱이 코드 보안 스캔을 나열하고 프로젝트별 발견 항목을 요약합니다.
팀 roster	Use the Lovable API and build an onboarding tracker that shows workspace members and their roles.	Lovable 팀 정보를 앱에 반영합니다. 앱이 연결된 워크스페이스에서 멤버와 역할을 읽습니다.
트래픽 개요	Use the Lovable API and build a page that shows traffic trends for our published projects.	앱을 떠나지 않고 앱 트래픽을 보고합니다. 앱이 프로젝트 분석을 읽고 trend chart를 렌더링합니다.

Lovable API 연결 방법

Lovable API 커넥터는 Business 및 Enterprise 플랜에서만 사용할 수 있습니다.

Lovable API 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. App + chat 커넥터는 Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. admin이 Connectors → Admin settings → App + chat connectors에서 바꾸기 전까지 connection과 client를 만들 수 있는 사람의 기본값은 No one입니다.

서로 다른 API 키로 여러 Lovable API 연결을 만들 수 있습니다. 여러 Lovable 워크스페이스를 관리하거나 읽기 전용 보고와 전체 관리 접근을 분리할 때 유용합니다.

연결을 만들면 사용하려는 프로젝트에 연결을 링크할 수 있습니다.

사전 요구 사항

Lovable API를 연결하기 전에 다음이 있는지 확인하세요.

앱이 관리할 Business 또는 Enterprise 플랜의 Lovable 워크스페이스입니다. 앱을 빌드하는 워크스페이스여도 되고 다른 워크스페이스여도 됩니다.
앱이 관리할 워크스페이스의 admin 또는 owner 역할입니다. 커넥터 설정 중 API 키를 만들 수 있어야 합니다. 미리 키를 준비할 필요는 없습니다. admin이나 owner가 아니라면 해당 워크스페이스의 Settings → Access tokens에서 키를 만들도록 요청한 뒤 설정 중 붙여 넣으세요. 다른 워크스페이스를 관리하거나 키의 스코프와 만료일을 직접 제어할 때도 이 방식이 필요합니다. 프로젝트의 PII label과 프로젝트별 보안 inventory라는 두 읽기 기능에는 Enterprise 워크스페이스가 필요합니다.
앱을 빌드하는 워크스페이스에서 connection을 만들 권한입니다(connection과 client를 만들 수 있는 사람 참조).

이 커넥터를 통해 보내는 모든 요청은 연결된 워크스페이스에 작용하며 API 키를 만든 사람에게 귀속됩니다. 요청은 그 사람이 접근할 수 있는 범위 안에서, 키에 부여된 접근 권한으로 제한됩니다. 플랜으로 제한되는 엔드포인트와 키를 통해 사용되는 크레딧은 연결된 워크스페이스의 Lovable 플랜을 따릅니다.

Lovable에서 연결 추가하기

앱을 빌드하는 워크스페이스에서 연결을 추가합니다. 연결에는 하나의 워크스페이스에 스코프가 지정된 Lovable API 키가 필요합니다. 양식에서 빌드 중인 워크스페이스용 키를 만들 수도 있고, 앱이 관리할 워크스페이스의 기존 키를 붙여 넣을 수도 있습니다.

Connectors에서 Lovable API 열기

Connectors를 열고 Lovable API를 선택합니다. 카탈로그를 여는 다른 위치는 커넥터를 찾을 수 있는 곳을 참조하세요.

연결 추가

Add connection을 클릭합니다.

연결 구성

Display name: 예를 들어 Acme workspace처럼 연결 이름을 지정합니다. 이 이름은 Lovable 안에서 연결을 식별하는 데만 사용됩니다.
API key: Create API key 아래에서 Key name(예: Automation)과 Monthly credit cap을 입력한 뒤 Create key를 클릭합니다.

Lovable은 Projects에 Read & write, Workspace에 Read 접근 권한을 가진 워크스페이스 API 키를 만들고, 월별 한도를 설정한 뒤 API key 필드를 채웁니다. 나중에 Settings → Access tokens에서 한도를 올릴 수 있습니다.

다른 워크스페이스용으로 만들었거나 자체 스코프와 만료일이 있는 기존 키를 사용하려면 API key에 붙여 넣습니다. 키는 lov_로 시작해야 합니다. 만드는 방법은 API 키 만들기 및 관리를 참조하세요.

이 연결을 사용할 수 있는 사람 선택

Sharing 아래에서 연결은 기본적으로 나에게만 비공개이며 Private label이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 사용할 수 있게 합니다.

자세한 내용은 connection과 client를 사용할 수 있는 사람을 참조하세요.

연결

Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Lovable API에 대해 키를 검증합니다.

API 키는 연결된 워크스페이스의 비밀번호처럼 동작합니다. 안전하게 보관하고 공개적으로 공유하지 마세요.

연결되면 프로젝트에서 빌드하는 사람은 프로젝트 채팅에서 Lovable에 프로젝트를 Lovable API에 링크해 달라고 요청할 수 있습니다(구성된 connection 수준 접근 권한 기준). 그러면 Lovable 앱이 서버 코드에서 연결된 워크스페이스를 읽고 관리할 수 있습니다.

제한 사항

Lovable API 커넥터는 관리 전용입니다. 다음은 할 수 없습니다.

어떤 연결에서도 Lovable agent에 채팅 메시지나 빌드 메시지를 보내기. 앱을 빌드하거나 편집하려면 대신 Lovable editor 또는 Lovable MCP 서버를 사용하세요.
프로젝트 생성 또는 remix. 프로젝트는 Lovable editor에서 만들거나 Lovable MCP 서버를 통해 만드세요.
프로젝트 코드 파일, git history, database를 다루거나 knowledge와 skill을 관리하기.
최종 사용자별 Lovable login 지원. 각 연결은 연결된 모든 프로젝트가 공유하는 하나의 Lovable 계정을 나타냅니다.

API 키가 만료되거나 삭제되면 API 호출이 다시 성공하기 전에 Lovable에서 새 키를 만들고 연결을 업데이트해야 합니다.

Lovable API 연결 관리하기

연결은 Connectors에서 관리합니다. **Lovable API**를 선택한 뒤 연결을 엽니다.

Unlink projects를 사용하면 다른 프로젝트에서는 연결을 계속 사용할 수 있게 두면서 특정 프로젝트에서 Lovable API 접근만 제거할 수 있습니다. 단계는 연결에서 프로젝트 링크 해제를 참조하세요.
Delete the connection은 워크스페이스에서 연결을 완전히 제거합니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 자격 증명이 제거되고, Lovable API를 사용하는 앱 기능은 새 연결을 추가할 때까지 동작을 멈춥니다. 단계와 삭제 권한은 연결 삭제를 참조하세요.