Airtable에 앱 연결하기
앱을 스프레드시트-데이터베이스 하이브리드인 Airtable에 연결하여 베이스, 테이블, 레코드를 읽고 쓰며 Airtable 베이스를 커스텀 앱 인터페이스로 전환하세요.
Airtable을 사용하면 Lovable 앱이 팀이 Airtable 앱에서 관리하는 베이스, 테이블, 레코드에서 읽고 쓸 수 있습니다. 진실의 원천(source of truth)이 Airtable에 있고 그 위에 커스텀 인터페이스(내부 도구, 고객 대상 포털, 또는 워크플로)가 필요한 앱을 위해 설계되었습니다.
Airtable을 사용하면 앱에서 다음과 같은 작업이 가능합니다:
- Metadata API를 사용하여 베이스, 테이블, 필드, 뷰 나열
- 모든 베이스에서 레코드 생성, 읽기, 업데이트, 삭제
- Airtable 수식과 뷰를 사용하여 레코드 필터링, 정렬, 페이지네이션
- Airtable 데이터로 구동되는 내부 도구와 고객 대상 앱 구축
- Airtable에 단일 진실의 원천을 유지하면서 사용자에게 맞춤 UI 노출
각 Airtable 연결은 단일 **Airtable Personal Access Token (PAT)**을 사용합니다. PAT는 연결이 어떤 베이스에 접근하고 어떤 작업을 수행할 수 있는지를 결정합니다. Lovable은 토큰에 부여한 스코프를 그대로 상속받습니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| Airtable 위에 구축된 내부 CRM | Airtable을 사용해서 내 Airtable 베이스에서 연락처와 거래를 읽고 팀이 인라인으로 상태를 업데이트할 수 있는 CRM을 만들어줘. | Airtable 베이스를 커스텀 CRM으로 전환합니다. 앱이 연락처와 거래를 읽고, 사용자가 필드를 업데이트할 수 있게 하며, 변경 사항을 다시 써서 Airtable이 진실의 원천으로 유지되게 합니다. |
| 고객 대상 포털 | Airtable을 사용해서 각 고객이 내 Airtable 주문 테이블에서 자신의 주문만 보는 고객 포털을 만들어줘. | Airtable 테이블의 필터링된 뷰를 고객에게 노출합니다. 앱이 고객별로 레코드를 필터링하고, 맞춤 UI를 렌더링하며, 베이스의 나머지를 숨깁니다. |
| 재고 또는 자산 추적기 | Airtable을 사용해서 직원이 항목을 스캔하고, 재고를 보고, Airtable에서 수량을 업데이트할 수 있는 재고 앱을 만들어줘. | 수동 Airtable 편집을 집중된 운영 UI로 대체합니다. 앱이 재고 레코드를 읽고, 검색과 바코드 스캔을 지원하며, 수량 업데이트를 베이스에 다시 푸시합니다. |
| Airtable에 쓰는 제출 양식 | Airtable을 사용해서 채용 지원서 양식을 만들어줘. 누군가 제출하면 내 Applications 테이블에 새 레코드를 만들어줘. | 사용자 입력을 캡처하고 Airtable 레코드를 생성합니다. 앱이 제출을 검증하고, 페이로드를 형식화하며, 선택한 테이블에 행을 만듭니다. |
| 이벤트 RSVP 및 참석자 대시보드 | Airtable을 사용해서 응답을 Airtable에 쓰고 admin에게 라이브 참석자 수를 보여주는 RSVP 페이지를 만들어줘. | Airtable에서 이벤트를 처음부터 끝까지 실행합니다. 앱이 RSVP를 수집하고, 테이블에 쓰며, 동일한 데이터에서 주최자를 위한 대시보드를 렌더링합니다. |
| 디렉토리 또는 카탈로그 | Airtable을 사용해서 내 Airtable 베이스의 각 행이 카테고리와 태그별 필터가 있는 상세 페이지가 되는 디렉토리를 만들어줘. | Airtable 테이블을 탐색 가능한 디렉토리로 렌더링합니다. 앱이 필터와 함께 항목을 나열하고, 레코드 ID나 슬러그로 상세 페이지에 링크하며, Airtable에서 모든 필드를 읽습니다. |
| 콘텐츠 캘린더 또는 워크플로 보드 | Airtable을 사용해서 내 Editorial 베이스를 읽고 에디터가 상태 열 사이로 콘텐츠를 옮길 수 있는 콘텐츠 캘린더를 만들어줘. | 팀에게 Airtable 위에서 집중된 워크플로 UI를 제공합니다. 앱이 상태별로 그룹화된 레코드를 읽고, 드래그 앤 드롭을 지원하며, Airtable에서 상태 필드를 업데이트합니다. |
Airtable 연결 방법
워크스페이스 admin과 owner가 Airtable을 연결할 수 있습니다.
다른 Personal Access Token을 사용하여 여러 Airtable 연결을 만들 수 있습니다. 이는 환경 분리(예: 개발과 프로덕션), 다른 베이스로 연결 범위 지정, 또는 특정 앱이 수행할 수 있는 작업을 제한하는 데 유용합니다.
연결이 만들어지면 Airtable이 워크스페이스의 어떤 프로젝트에든 연결될 수 있습니다. 여러 프로젝트가 동일한 연결을 사용할 수 있습니다.
사전 요구사항
Airtable을 연결하기 전에 다음을 준비하세요:
- 연결하려는 베이스에 접근할 수 있는 Airtable 계정
- 적절한 스코프와 베이스 접근 권한이 있는 Airtable Personal Access Token (PAT)
- Lovable 워크스페이스 owner 또는 admin 역할
이 커넥터를 통한 모든 API 요청은 Personal Access Token을 사용합니다. API 사용량은 Airtable 플랜의 속도 제한과 레코드 한도에 포함되며 청구는 Lovable이 아닌 Airtable에서 직접 처리됩니다.
1단계: Airtable Personal Access Token 만들기
**Personal Access Token (PAT)**은 Lovable 앱이 Airtable Web API로 인증할 수 있게 해줍니다. PAT는 스코프가 지정되므로 토큰이 어떤 베이스에 접근할 수 있고 어떤 작업을 수행할 수 있는지 선택합니다.
PAT를 만들려면:
Airtable 토큰 페이지 열기
Airtable에 로그인하고 airtable.com/create/tokens로 이동합니다.
새 토큰 만들기
Create new token을 클릭하고 설명적인 이름을 부여합니다(예: Lovable integration).
스코프 추가
앱이 필요로 하는 스코프를 추가합니다. 일반적인 스코프:
data.records:read: 테이블에서 레코드 읽기data.records:write: 레코드 생성, 업데이트, 삭제schema.bases:read: 베이스, 테이블, 필드 나열(Metadata API)schema.bases:write: 테이블과 필드 생성 또는 수정
대부분의 Lovable 앱은 data.records:read, data.records:write, schema.bases:read만 필요합니다. 앱이 실제로 필요한 스코프만 부여하세요.
베이스 접근 추가
Access에서 이 토큰이 사용할 수 있는 베이스를 선택합니다. 특정 베이스나 워크스페이스의 모든 베이스에 대한 접근을 부여할 수 있습니다. 앱이 필요로 하는 가장 작은 베이스 세트로 접근을 제한하세요.
토큰 생성 및 복사
Create token을 클릭하고 값을 복사합니다.
Personal Access Token은 비밀번호처럼 작동합니다. 안전하게 보관하고 절대 공개하지 마세요. 다음 단계에서 필요합니다.
자세한 지침은 Airtable 문서를 참고하세요: Personal access tokens.
2단계: Airtable을 Lovable에 연결
다른 Personal Access Token을 사용하여 여러 연결을 만들 수 있습니다.
Airtable을 연결하려면:
Connectors에서 Airtable 열기
Connectors → App connectors로 이동하여 Airtable을 선택합니다.
연결 추가
Add connection을 클릭합니다.
연결 구성
- Display name: 연결의 이름을 지정합니다(예:
Airtable Prod). - Personal access token: Airtable PAT를 붙여넣습니다.
- Who can access this connection: 특정 사람으로 접근을 제한하거나 전체 워크스페이스를 초대합니다. 자세한 내용은 연결 수준 접근을 참고하세요.
연결
Connect를 클릭합니다.
Lovable이 Airtable로 토큰을 검증합니다. 토큰이 유효하지 않거나 취소된 경우 연결이 실패하며 새 토큰을 붙여넣을 수 있습니다.
연결되면 Lovable 앱이 Airtable 베이스에서 읽기와 쓰기를 시작할 수 있습니다.
베이스, 테이블, 레코드 작업
Airtable Web API는 두 개의 표면을 노출하며 둘 다 커넥터를 통해 사용 가능합니다:
- Metadata API: 베이스, 테이블, 필드, 뷰 나열. ID를 하드코딩하지 않고 Lovable이 베이스의 스키마를 발견하기를 원할 때 유용합니다.
- Record API: 특정 테이블에서 레코드 생성, 읽기, 업데이트, 삭제.
Lovable에 프롬프트할 때 사용하려는 베이스 이름과 테이블 이름, 그리고 어떤 필드를 읽거나 쓸지 언급하면 도움이 됩니다.
제한 사항
Airtable 커넥터는 Airtable Web API를 감쌉니다.
Airtable 커넥터는 다음을 할 수 없습니다:
- Airtable 웹훅이나 변경 이벤트 수신(앱은 업데이트를 위해 Airtable을 폴링해야 함)
- 앱에서 Airtable Automations나 스크립팅 블록 기능 사용
- 최종 사용자별 인증 지원
- Airtable의 베이스별 API 속도 제한 초과. 무거운 트래픽은 요청을 일괄 처리해야 함
요청이 Personal Access Token이 취소, 회전, 또는 베이스에 더 이상 접근할 수 없어 실패하면 Airtable에서 새 토큰을 만들고 다시 연결해야 합니다. PAT에 대한 자동 갱신은 없습니다.
Airtable 연결에서 프로젝트 연결 해제하는 방법
Editor 이상은 연결을 완전히 삭제하지 않고 특정 프로젝트를 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용 가능합니다.
프로젝트 연결을 해제하려면:
Connectors 열기
Connectors를 열고 App connectors로 이동한 다음 **Airtable**을 선택합니다.
연결 열기
관리하려는 연결을 엽니다.
프로젝트 선택
Linked projects에서 연결 해제하려는 프로젝트를 체크합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결이 해제되면 해당 프로젝트는 이 연결을 통해 더 이상 Airtable에 접근할 수 없습니다. 프로젝트가 다시 Airtable이 필요하면 사용 가능한 연결에 연결할 수 있습니다.
Airtable 연결 삭제 방법
워크스페이스 admin과 owner는 Airtable 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 취소할 수 없습니다. 연결된 모든 프로젝트에서 자격증명이 제거되며 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제하기 전에 Linked projects 섹션을 검토하여 현재 어떤 프로젝트가 연결을 사용하고 있는지 확인하세요.
연결을 삭제하려면:
Connectors 열기
Connectors를 열고 App connectors로 이동한 다음 **Airtable**을 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토
Linked projects 섹션을 검토합니다.
삭제
Delete this connection에서 Delete를 클릭하고 확인합니다.