Slack, HubSpot, Google Sheets 같은 도구를 한 번 연결해 빌드 중 채팅과 게시된 앱에서 함께 사용합니다.
앱 + 채팅 커넥터: 게시된 앱과 채팅에 기능 추가
Slack, HubSpot, Google Sheets 같은 도구를 한 번 연결해 어디서나 사용하세요. Lovable은 빌드 중 그 연결을 사용하고, 게시된 앱은 이를 통해 사용자를 위해 메시지를 보내고 데이터를 읽고 작업을 수행합니다.
앱 + 채팅 커넥터는 Lovable 앱의 기능을 확장하는 가장 쉬운 방법입니다. Slack, HubSpot, Google Sheets 같은 도구를 한 번 연결하면 그 하나의 connection이 세 곳에서 작동합니다.
- Chats에서. 프로젝트 밖에서 도구를 다룰 때 Lovable이 그 connection을 사용하며, 승인 카드는 프로젝트 채팅과 동일합니다.
- 빌드 중 채팅에서. Lovable이 도움을 주면서 연결된 도구를 읽고 그 위에서 작업할 수 있습니다. 예를 들어 세일즈 대시보드를 디자인할 때 실제 HubSpot 계정의 deal stage를 살펴보므로, 결과가 지어낸 예시가 아니라 실제 데이터와 일치합니다.
- 사용 중 게시된 앱에서. 다른 사람과 공유한 앱이 스스로 그 도구를 사용할 수 있습니다. 예를 들어 방문자가 폼을 제출하면 앱이 팀 Slack에 메시지를 게시하거나, Google Sheet에 행을 추가하거나, HubSpot에 contact를 만들 수 있습니다.
사용 가능한 모든 도구는 Connectors에서 둘러볼 수 있으며, 제품 내 여러 위치에서도 열 수 있습니다. 전체 위치는 커넥터를 찾는 위치에 정리되어 있습니다. 앱 + 채팅 연결이 다른 연결 유형과 어떻게 비교되는지는 커넥터 개요를 참고하세요.
필요한 도구가 카탈로그에 없다면 워크스페이스 관리자가 모든 REST API를 대상으로 커스텀 커넥터를 만들 수 있습니다. 커스텀 커넥터는 워크스페이스 카탈로그에 합류하며, 그 연결도 이 페이지에서 설명하는 방식 그대로 작동합니다.
앱 + 채팅 연결의 작동 방식
앱 + 채팅 연결은 하나의 공유 계정으로 실행됩니다. 본인(또는 팀원)이 도구에 로그인하거나 API 키를 한 번 붙여넣으면, 누가 빌드하든 어떤 방문자가 게시된 앱을 사용하든 모든 요청이 그 계정을 사용합니다.
앱의 각 사용자가 대신 자신의 계정으로 로그인해 자기 데이터만 봐야 한다면 앱 사용자 커넥터를 사용하세요.
connection은 하나의 프로젝트가 아니라 워크스페이스에 속합니다. connection을 한 번 만든 다음 필요한 프로젝트마다 링크합니다. 링크해야 connection을 프로젝트에서 사용할 수 있고, 링크되면 Lovable이 통합 코드를 대신 작성합니다.
누가 무엇을 할 수 있는지는 두 가지 설정이 제어합니다.
- connection을 만들 수 있는 사람. Free와 Pro 플랜에서는 editor 이상 역할을 가진 워크스페이스 멤버가 connection을 만들 수 있습니다. Business와 Enterprise 플랜에서는 워크스페이스 admin이 커넥터별로 No one, Admins, Editors & admins 중 하나를 선택합니다. 커넥터를 No one으로 설정하면 아무도 새 connection을 만들 수 없어 사실상 비활성화됩니다. Enterprise 플랜에서는 커넥터가 처음에 사실상 비활성화되어, admin이 필요한 커넥터마다 바꿀 때까지 이 설정이 No one으로 기본 설정됩니다. 전체 내용은 connection과 client를 만들 수 있는 사람을 참고하세요.
- connection을 사용할 수 있는 사람. connection을 만든 사람이 누가 사용할 수 있는지 정합니다. connection은 비공개로 두거나, 특정 사람과 공유하거나, 워크스페이스 전체와 공유할 수 있으며, 접근 권한이 있는 사람은 누구나 이를 프로젝트에 링크해 빌드할 수 있습니다. 접근 권한이 프로젝트에 미치는 영향은 connection과 client를 사용할 수 있는 사람을 참고하세요.
예상과 달리 connection을 만들거나 사용할 수 없다면 보통 이 두 설정 중 하나가 원인입니다. 확인 방법은 FAQ의 connection을 만들거나 링크할 수 없는 이유는 무엇인가요?를 참고하세요.
연결 만들기
connection 생성은 몇 분이면 되고 도구당 한 번만 하면 됩니다.
커넥터 선택
Connectors를 열고 연결할 도구를 선택합니다. 카탈로그를 열 수 있는 모든 위치는 커넥터를 찾는 위치를 참고하세요.
connection 추가
Add connection을 클릭합니다. 커넥터가 여러 연결 유형을 지원하면 App + chat connector를 선택합니다. 양식은 접을 수 있는 Details, Configure connection, Sharing 섹션으로 나뉩니다. Lovable은 Details 아래에 connection 이름을 자동으로 채우며, 이 이름은 바꿀 수 있습니다. 접힌 섹션에는 선택한 내용의 요약이 표시됩니다.
인증
도구에 따라 OAuth로 로그인하거나 API 키 같은 자격 증명을 붙여넣습니다. 커넥터가 여러 인증 방식을 지원하면 Configure connection에서 하나를 고릅니다. 일부 도구는 API 키를 만들거나 대시보드에 앱을 등록하는 등 provider 측 설정이 먼저 필요합니다. 시작 전에 커넥터 문서에서 정확한 지침을 확인하세요.
일부 커넥터는 Lovable이 소유하고 관리하는 자격 증명을 사용하는 Managed by Lovable 옵션을 제공하므로 직접 자격 증명을 준비할 필요가 없습니다. 워크스페이스는 커넥터당 managed connection을 하나 가질 수 있습니다. 본인의 provider 계정으로 로그인시키는 managed 옵션은 예외입니다. 이때는 connection마다 별개의 provider 계정이므로 워크스페이스가 여러 개를 가질 수 있습니다.
일부 managed 옵션은 사용량을 Lovable 크레딧으로 과금하며 Uses credits 뱃지를 표시합니다. 연결하기 전에 양식이 커넥터의 가격과 provider 규칙 링크가 담긴 사용량 안내를 보여 줍니다. 커넥터 사용량은 Usage details의 Run credits에 나타납니다. 요율은 커넥터 비용과 해당 커넥터 페이지를 참고하세요.
connection을 사용할 사람 선택
Sharing에서 새 connection은 기본적으로 본인만 사용할 수 있으며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 워크스페이스 멤버를 이메일로 추가하거나 Invite entire workspace를 클릭합니다. Managed by Lovable 옵션을 사용하는 connection은 기본적으로 워크스페이스 전체와 공유됩니다. 접근 권한이 있는 사람은 누구나 connection을 프로젝트에 링크하고 빌드할 수 있습니다. 나중에 connection 설정에서 이 값을 바꿀 수 있습니다. connection 공유를 중지하려면 Make private를 클릭합니다. 접근 권한이 프로젝트와 협업자에게 미치는 영향은 connection과 client를 사용할 수 있는 사람을 참고하세요.
connection 생성
양식 하단에 계속 표시되는 Connect를 클릭합니다. 사용을 시작하려면 프로젝트에 연결 링크에 설명된 것처럼 해당 프로젝트 채팅에서 Lovable에게 요청해 프로젝트에 링크하세요.
프로젝트에 연결 링크
connection은 그 자체로는 아무 일도 하지 않습니다. 프로젝트에 링크하면 자격 증명이 그 프로젝트와 안전하게 공유되어 Lovable과 게시된 앱이 도구를 호출할 수 있습니다.
connection은 프로젝트 채팅에서 Lovable에게 요청해 링크합니다. 앱이 무엇을 하기 바라는지 설명하세요. 예를 들어 다음과 같습니다.
Connect Slack to this project and post a message to #new-signups whenever someone creates an account.Lovable은 프로젝트 채팅에 카드를 표시합니다. 이 카드에서 접근 권한이 있는 기존 connection을 고르거나 새 connection을 만들면 Lovable이 기능을 빌드합니다. 프로젝트 채팅에서 만든 connection은 Managed by Lovable 옵션을 사용하지 않는 한 본인만 사용할 수 있습니다. 나중에 connection 설정에서 공유할 수 있습니다.
Gmail, Google Calendar, Linear처럼 개인 계정에 연결하는 커넥터의 경우, 카드에는 처음에 본인이 만든 connection만 표시됩니다. 팀원이 만든 connection을 고르려면 View shared connections를 선택하세요.
링크는 connection의 접근 규칙을 따릅니다. connection에 접근 권한이 있는 사람만 프로젝트에 링크할 수 있고, connection 하나를 워크스페이스의 원하는 만큼 많은 프로젝트에 링크할 수 있습니다. connection 접근 권한이 프로젝트 공유와 프로젝트 owner에 미치는 영향을 포함한 전체 규칙은 connection과 client를 사용할 수 있는 사람을 참고하세요.
채팅에서 커넥터 작업 승인
같은 승인 카드가 Chats에도 나타납니다.
connection이 링크되면 Lovable이 이를 사용하기 시작하며, 무엇을 하는지는 사용자가 계속 통제합니다. Lovable이 메시지 전송이나 레코드 업데이트처럼 변경을 일으키는 데 connection을 사용하려 하면 먼저 멈추고 승인을 요청합니다. 승인 카드는 Lovable이 하려는 작업을 설명하고 요청 세부 정보를 보여 줍니다. 읽기 전용 요청은 묻지 않고 실행됩니다.
세 가지 방식으로 응답할 수 있습니다.
- Allow once: 이 작업 한 번만 승인합니다.
- Always allow: 이 connection의 이후 작업을 쓰기 작업을 포함해 묻지 않고 실행하게 합니다.
- Skip: 작업을 실행하지 않고 넘어갑니다.
Always allow 설정은 본인과 그 특정 connection 조합에 적용됩니다. 나중에 connection 설정의 Agent approval for this connection에서 바꾸거나, Account settings → Preferences → Agent permissions에서 저장된 모든 승인을 한곳에서 검토할 수 있습니다.
연결 관리
기존 connection에 관한 모든 것은 connection 자체에서 관리합니다. Connectors를 열고 커넥터를 선택한 뒤 connection을 엽니다. 프로젝트 안에서도 갈 수 있으며, 모든 진입점은 커넥터를 찾는 위치를 참고하세요.
connection에서 링크된 프로젝트를 확인하고 링크 해제하거나, Sharing에서 사용자를 바꾸거나, agent 승인 설정을 조정하거나, connection을 삭제할 수 있습니다.
connection을 관리할 수 있는 사람은 그 접근 설정을 따릅니다. connection을 만든 사람이 누가 사용할 수 있는지 통제하며 언제든 connection 설정에서 조정할 수 있고, 이는 connection과 client를 사용할 수 있는 사람에서 설명합니다. 워크스페이스 admin과 owner는 모든 connection을 삭제할 수 있습니다.
Connectors에서 커넥터를 열면 해당 connection이 Private connections와 Shared connections 두 목록으로 표시됩니다.
프로젝트 안에서는 More → Connectors를 엽니다. 협업자가 링크된 connection을 사용할 수 없으면 Lovable이 Missing access to this connection 아래에 그 사람을 표시합니다. connection을 관리할 수 있다면 이름 옆의 Grant access를 클릭하세요. 비공개 connection이라면 Lovable이 Share connection으로 확인을 요청합니다. 그러면 connection이 공유 상태가 되고, 해당 협업자는 다른 프로젝트에서도 connection을 사용할 수 있습니다. connection을 관리하지 않는 협업자에게는 소유자에게 문의하라는 안내가 표시됩니다.
연결에서 프로젝트 링크 해제
링크 해제는 connection을 삭제하지 않고 특정 프로젝트만 connection에서 제거합니다. connection은 다른 프로젝트에서 계속 사용할 수 있습니다. editor 이상 역할을 가진 워크스페이스 멤버가 프로젝트를 링크 해제할 수 있습니다.
connection 열기
Connectors를 열고 커넥터를 선택한 뒤 관리할 connection을 엽니다.
프로젝트 선택
Linked projects에서 링크 해제할 프로젝트를 체크합니다.
확인
Unlink projects를 클릭하고 확인합니다.
링크 해제된 프로젝트는 이 connection을 통한 도구 접근을 잃습니다. 프로젝트에 다시 도구가 필요하면 사용 가능한 아무 connection에나 링크하세요.
연결 삭제
connection을 삭제하면 워크스페이스에서 완전히 제거됩니다. 워크스페이스 admin과 owner는 모든 connection을 삭제할 수 있습니다. 다른 멤버는 자신이 만들었거나 접근 권한을 명시적으로 부여받은 connection을 삭제할 수 있습니다.
connection 삭제는 영구적이며 되돌릴 수 없습니다. 링크된 모든 프로젝트에서 자격 증명이 제거되고, 새 connection을 추가할 때까지 그 connection을 사용하는 앱은 작동을 멈춥니다.
connection 열기
Connectors를 열고 커넥터를 선택한 뒤 제거할 connection을 엽니다.
링크된 프로젝트 검토
Linked projects 섹션에서 현재 connection을 사용하는 프로젝트를 확인합니다.
삭제
Delete this connection 아래에서 Delete를 클릭하고 확인합니다.
게이트웨이 기반 커넥터
대부분의 앱 + 채팅 커넥터는 Lovable 앱과 서드파티 서비스 사이의 보안 게이트웨이를 거칩니다. 게이트웨이는 인증을 자동으로 처리하고, 자격 증명을 프로젝트 밖에 두며, 프로젝트별 사용량 제한을 적용하고, 아웃바운드 트래픽을 고정된 IP 범위에서 내보냅니다. 자세한 내용은 통합 보안을, 앱과 서드파티 서비스 사이에서 데이터가 이동하는 방식은 커넥터 데이터 흐름을 참고하세요.
관리형 프로젝트 secret: LOVABLE_API_KEY
앱 + 채팅 커넥터와 Lovable AI는 프로젝트를 Lovable 서비스에 식별하기 위해 LOVABLE_API_KEY라는 프로젝트 secret에 의존합니다. Lovable이 이 secret을 자동으로 만들고 관리하므로 사용자가 처리할 일은 없습니다.