법인 카드·지출 관리 플랫폼인 Ramp에 앱을 연결해 거래, 카드, fund, 사용자, 비즈니스 데이터를 읽는 앱을 만듭니다.

Ramp에 앱 연결하기

법인 카드·지출 관리 플랫폼인 Ramp에 앱을 연결해 거래, 카드, fund, 사용자, 비즈니스 데이터를 읽는 앱을 만드세요.

Ramp는 회사의 거래, 카드, 지출 한도, 사용자를 추적하는 법인 카드·지출 관리 플랫폼입니다. Ramp 커넥터를 사용하면 Lovable 앱이 Ramp 비즈니스의 데이터를 읽을 수 있습니다. Ramp 계정으로 로그인하기만 하면 되며, Ramp 개발자 앱이나 API 키는 필요하지 않습니다.

Ramp는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 프로젝트 채팅과 게시된 앱 모두에서 작동합니다.

Ramp를 사용하면 앱에서 다음 작업을 할 수 있습니다.

Ramp 계정의 비즈니스 정보 읽기
카드 번호가 마스킹된 상태로 실물 카드와 가상 카드 나열
fund(자금)와 각 fund의 지출 한도, 잔액 읽기
거래를 읽고 날짜, 사용자, 카드, 가맹점별로 필터링
Ramp 비즈니스의 사용자와 역할 나열

Ramp 커넥터는 읽기 전용이며, 각 연결은 Ramp 비즈니스 하나의 데이터를 읽습니다. 내부 지출 대시보드, 거래 리포팅, 카드·한도 현황 관리, Ramp 데이터를 다른 시스템과 결합하는 재무 운영 도구에 적합합니다.

주요 활용 사례 및 예시 앱

다음 예시는 Ramp로 만들 수 있는 앱과, 각 앱을 시작할 때 쓸 수 있는 프롬프트입니다.

예시 앱	프롬프트 예시	설명
지출 대시보드	Ramp를 사용해 월별 총지출, 상위 가맹점, 금액이 가장 큰 거래를 보여 주는 대시보드를 만들어줘.	회사 지출을 한곳에서 추적합니다. 앱이 Ramp에서 거래와 비즈니스 데이터를 읽은 다음 재무팀과 경영진을 위해 지출 추세를 차트로 보여 줍니다.
거래 탐색기	Ramp를 사용해 직원이 사용자, 카드, 기간, 가맹점별로 거래를 필터링할 수 있는 거래 탐색기를 만들어줘.	팀이 Ramp 거래를 검색할 수 있는 화면을 제공합니다. 앱이 Ramp에서 거래를 읽고 필터를 적용한 뒤 사용자나 카드별로 묶어 세부 정보를 보여 줍니다.
카드·한도 현황	Ramp를 사용해 모든 카드와 카드 소유자, 현재 지출 한도와 잔액을 나열하는 리포트를 만들어줘.	카드 배정과 지출 한도를 한눈에 확인합니다. 앱이 카드를 읽어 각 카드를 해당 카드가 속한 fund와 짝지은 다음, 해당 fund의 한도와 남은 잔액을 보여 줍니다.
팀 지출 리포트	Ramp를 사용해 사용자와 가맹점 카테고리별로 묶은 월별 팀 지출 리포트를 만들어줘.	팀원별 지출을 세분화합니다. 앱이 Ramp에서 사용자와 거래를 읽고 선택한 기간의 1인당 지출을 요약합니다.
예산 트래커	Ramp를 사용해 fund 잔액을 지출 한도와 비교하고 한도에 가까워진 fund를 강조 표시하는 예산 트래커를 만들어줘.	fund가 한도에 도달하기 전에 사용 현황을 지켜봅니다. 앱이 fund와 지출 한도를 읽고, 설정된 금액에 가까워진 fund를 표시합니다.

Ramp 연결을 만들 수 있는 사람은 플랜과 워크스페이스 설정에 따라 달라집니다. 앱 + 채팅 커넥터는 Free, Pro, Business 플랜에서 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. 관리자가 Connectors → Admin settings → App + chat connectors에서 바꾸기 전까지 연결 및 클라이언트를 만들 수 있는 사용자 설정의 기본값이 No one이기 때문입니다.

서로 다른 Ramp 비즈니스로 Ramp 연결을 여러 개 만들 수 있습니다. 조직이 Ramp 비즈니스를 둘 이상 운영할 때 유용합니다.

연결을 만든 뒤에는 연결을 사용할 프로젝트에 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 채팅에서 Lovable에게 자신의 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.

사전 요구 사항

Ramp를 연결하기 전에 다음을 준비하세요.

연결할 Ramp 비즈니스
해당 비즈니스에서 서드파티 애플리케이션을 승인할 수 있는 Ramp 사용자(일반적으로 Ramp Admin 또는 Business Owner)
Lovable 워크스페이스의 연결 생성 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)

이 커넥터를 통한 모든 API 요청은 연결된 Ramp 비즈니스에서 데이터를 읽으며 Ramp의 API 요청 한도(rate limit)에 포함됩니다. 요청 한도와 할당량은 Lovable이 아닌 Ramp가 직접 관리합니다.

Ramp 연결 설정

Lovable에서 연결을 만든 다음 Ramp에서 승인해 마무리합니다.

Connectors에서 Ramp 열기

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

연결 추가

Add connection을 클릭하고 App + chat connector를 선택합니다. 양식은 Details, Configure connection, Sharing의 접을 수 있는 섹션으로 나뉩니다.

연결 이름 지정

Details에서 Lovable이 연결 이름을 자동으로 채우며, 이 이름은 바꿀 수 있습니다. 이름은 Lovable 안에서 연결을 식별하는 데만 쓰입니다.

스코프 검토(선택)

Scopes에서 앱이 요청하는 권한을 검토합니다. 읽기 스코프 다섯 개가 모두 기본으로 선택되어 있으며, Business: read는 필수입니다.

스코프	설명	기본값
Business: read (`business:read`)	회사 정보를 읽습니다. 연결을 검증하는 데 필요합니다.	필수
Transactions: read (`transactions:read`)	카드 거래를 읽습니다.	켜짐
Users: read (`users:read`)	사용자와 역할을 읽습니다.	켜짐
Cards: read (`cards:read`)	실물 카드와 가상 카드를 읽습니다(번호는 마스킹됨).	켜짐
Funds: read (`funds:read`)	fund와 지출 한도를 읽습니다.	켜짐

Lovable은 offline_access도 요청합니다. 이 스코프 덕분에 Ramp에 다시 로그인하지 않아도 연결이 계속 작동합니다. 다른 스코프 조합을 쓰려면 연결을 삭제하고 새로 추가하세요.

전체 스코프 문서는 Ramp 권한 부여 가이드를 참고하세요.

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

관리형 연결(managed connection)은 기본적으로 워크스페이스 전체와 공유됩니다. 연결을 사용할 수 있는 사람을 제한하려면 Sharing에서 Restrict to specific people을 클릭하세요.

자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.

Ramp에 연결하고 권한 부여

Connect를 클릭합니다. Ramp 권한 부여 창이 열리므로 브라우저가 팝업을 차단하지 않는지 확인하세요. 팝업이 차단되면 Lovable이 대신 권한 부여 페이지로 리디렉션합니다.

로그인하라는 메시지가 나타나면 Ramp에 로그인하고, 요청된 권한을 검토한 뒤 비즈니스에 대해 앱을 승인합니다.

확인 메시지와 함께 Lovable로 돌아옵니다.

연결되면 프로젝트에서 빌드하는 누구나 채팅에서 Lovable에게 자신의 프로젝트를 Ramp에 링크해 달라고 요청할 수 있습니다(구성된 연결 단위 접근 권한 기준). 그러면 Lovable 앱이 연결된 Ramp 비즈니스에서 비즈니스, 카드, fund, 거래, 사용자 데이터를 읽을 수 있습니다.

제한 사항

Ramp 커넥터는 읽기 전용이며 다음 작업을 할 수 없습니다.

Ramp에서 카드, fund, 지출 한도, 거래, 청구서, 경비 환급, 거래처를 포함한 어떤 항목도 생성하거나 변경하기
전체 카드 번호와 보안 코드, 영수증, 청구서, 경비 환급, 거래처 읽기. 이런 데이터에는 이 연결이 요청할 수 없는 스코프가 필요합니다.
Ramp 웹훅이나 실시간 이벤트 알림 수신
최종 사용자별 Ramp 로그인 지원. 각 연결은 링크된 모든 프로젝트가 공유하는 단일 Ramp 비즈니스를 나타냅니다.

앱이 선택한 스코프 밖의 데이터를 요청하면 Ramp가 권한 오류를 반환합니다. 이때는 지원되는 데이터로 화면을 만들어 달라고 Lovable에게 요청하세요.

Ramp 쪽에서 권한 부여를 취소했다면, API 호출이 다시 성공하도록 Lovable에서 통합을 다시 연결해야 합니다.

Ramp 연결 관리

연결은 Connectors에서 관리합니다. **Ramp**를 선택한 다음 연결을 여세요.

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