GTM 데이터 플랫폼 Clay에 앱을 연결하여 사람과 회사를 검색하고 enrichment routine을 실행하며 Clay 테이블을 조회합니다.

Clay에 앱 연결하기

GTM(go-to-market) 데이터 플랫폼 Clay에 앱을 연결하여 사람과 회사를 검색하고 enrichment routine을 실행하며 Lovable 앱에서 Clay 테이블을 조회하세요.

Clay는 사람 및 회사 데이터를 찾고 보강하고 활용하는 GTM 데이터 플랫폼입니다. Clay 커넥터를 사용하면 구조화된 필터로 Clay 데이터베이스를 검색하고, 레코드에 Clay routine(enrichment function 및 workflow)을 실행하고, Clay 테이블을 조회할 수 있습니다. 실시간 잠재 고객 발굴 및 데이터 보강이 필요한 영업·마케팅 앱에 적합합니다.

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

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

직함, 키워드 및 회사로 Clay의 사람 데이터베이스 검색
도메인, 업종 및 firmographic 정보로 회사 검색
제출한 레코드에 enrichment routine 실행
구조화된 필터로 Clay 테이블 조회

Clay 워크스페이스를 기반으로 한 잠재 고객 발굴 도구, 리드 보강 워크플로우, 고객사 조사 대시보드 및 사내 GTM 앱에 적합합니다.

주요 활용 사례 및 예시 앱

예시 앱	프롬프트 예시	설명
잠재 고객 목록 빌더	Clay를 사용해 핀테크 회사의 창업자를 검색하고 목록에 저장하는 도구를 만들어줘.	Clay 사람 검색을 집중된 잠재 고객 발굴 UI로 전환합니다. 필터로 Clay 검색을 만들고 결과 페이지를 탐색하며 추적할 사람을 저장합니다.
고객사 조사 대시보드	Clay를 사용해 대상 회사 목록의 firmographic 세부 정보를 보여주는 대시보드를 만들어줘.	앱을 벗어나지 않고 대상 고객사를 조사합니다. 도메인별로 회사를 검색하고 업종, 규모 및 매출 데이터를 나란히 표시합니다.
리드 보강 양식	회사 도메인을 붙여넣으면 Clay routine으로 보강된 회사 데이터를 반환하는 양식을 만들어줘.	간단한 UI에서 필요할 때 Clay enrichment를 실행합니다. 도메인을 routine에 제출하고 완료될 때까지 추적한 뒤 결과를 표시합니다.
대량 보강 추적기	리드 CSV를 업로드하고 enrichment routine을 실행한 뒤 진행 상황을 보는 앱을 만들어줘.	대규모 enrichment 작업의 생명주기를 관리합니다. 레코드를 배치로 제출하고 각 항목의 submitted, processing, done 상태를 표시합니다.
시장 매핑 도구	업종과 매출 구간별로 세그먼트의 회사를 매핑하는 앱을 만들어줘.	Clay 회사 데이터로 시장 세그먼트를 탐색합니다. 구조화된 필터로 회사를 검색하고 firmographic 속성별로 결과를 시각화합니다.
Clay 테이블 뷰어	내 Clay 테이블의 행을 상태별로 필터링해 보여주는 내부 페이지를 만들어줘.	팀에 맞춤형 Clay 테이블 보기를 제공합니다. 구조화된 필터로 테이블을 조회하고 팀에 필요한 필드만 표시합니다.

Clay 연결하기

Clay 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 달라집니다. 연결 및 클라이언트를 만들 수 있는 사용자를 참고하세요.

서로 다른 API 키로 여러 Clay 연결을 만들 수 있어 개발·프로덕션 환경을 분리하거나 다른 Clay 워크스페이스를 연결할 때 유용합니다.

연결을 만든 후 사용할 프로젝트에 연결할 수 있습니다. 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 프로젝트와의 연결을 요청할 수 있습니다.

사전 준비

Clay를 연결하기 전에 다음을 준비하세요:

연결할 워크스페이스에 접근할 수 있는 Clay 계정
Clay Public API 키
Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)

이 커넥터의 검색과 routine 실행은 Clay 크레딧을 소비하고 Clay 플랜의 속도 제한에 포함됩니다. 요금은 Lovable이 아닌 Clay에서 직접 처리합니다.

1단계: Clay API 키 가져오기

Clay Public API 키를 사용하면 Lovable 앱이 Clay Public API에 인증할 수 있습니다.

Clay API 키를 만들려면 다음 단계를 따르세요:

Clay 계정 열기

워크스페이스에 접근할 수 있는 계정으로 Clay에 로그인합니다.

API 키 열기

**Settings → Account → API keys (beta)**로 이동합니다.

키 만들기

새 API 키를 만들고 Lovable integration처럼 알아보기 쉬운 이름을 지정합니다.

키 복사하기

키를 복사하여 안전하게 보관합니다.

API 키는 비밀번호처럼 작동합니다. 안전하게 보관하고 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.

이 커넥터에는 **API keys (beta)**에서 만든 Public API key가 필요합니다. Clay의 기존 workspace API key는 사용할 수 없습니다.

자세한 내용은 Clay 인증 문서를 참고하세요.

2단계: Clay를 Lovable에 연결하기

서로 다른 API 키를 사용해 여러 연결을 만들 수 있습니다.

Connectors에서 Clay 열기

Connectors로 이동하여 Clay를 선택합니다.

연결 추가하기

Add connection을 클릭합니다.

연결 구성하기

Display name: 연결 이름을 지정합니다(예: Clay Prod).
API key: Clay Public API 키를 붙여넣습니다.

이 연결을 사용할 사용자 선택하기

Who can use this connection에서 워크스페이스 내 연결 사용자를 결정합니다. 처음에는 본인만 접근할 수 있습니다:

Only you(기본값): 본인만 연결과 관련 데이터를 사용할 수 있습니다.
Invite specific people: 이메일로 추가한 멤버만 함께 사용할 수 있습니다.
Invite entire workspace: 워크스페이스 전체가 사용할 수 있게 합니다.

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

연결하기

Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Clay에서 키를 확인합니다.

연결되면 프로젝트에서 빌드하는 사용자는 연결 수준 접근 권한에 따라 채팅에서 Lovable에 프로젝트와 Clay의 연결을 요청할 수 있습니다. 이후 앱에서 사람과 회사를 검색하고 routine을 실행하고 테이블을 조회할 수 있습니다.

Routine 및 테이블 활용하기

Routine은 비동기로 실행됩니다. 앱은 레코드를 제출한 뒤 Clay가 처리하는 동안 결과를 폴링합니다. 즉시 응답을 기대하지 말고 submitted, processing, done 생명주기에 맞춰 흐름을 설계하세요. 실행에는 Clay 크레딧이 사용되므로 대량 실행 전에 예상 처리량을 표시하세요.
테이블에는 table id가 필요합니다. Clay Public API에는 테이블 목록 엔드포인트가 없습니다. 테이블을 조회하려면 Clay URL의 /tables/ 뒤에 있는 id를 프롬프트에 입력하세요.
테이블 조회에는 Clay Enterprise가 필요합니다. 테이블 엔드포인트는 Clay Enterprise 플랜에서만 제공됩니다. 사람·회사 검색과 routine은 다른 플랜에서도 작동합니다.

제한 사항

Clay 워크스페이스가 Clay Enterprise 플랜이 아니면 테이블을 조회할 수 없습니다.
Clay webhook이나 실시간 이벤트를 수신할 수 없습니다.
Clay 속도 제한이나 크레딧 소비를 우회할 수 없습니다.
API 키를 자동 교체할 수 없습니다. Clay에서 새 키를 생성하고 Lovable 연결을 업데이트하세요.
최종 사용자별 Clay 로그인을 지원하지 않습니다. 각 연결은 연결된 모든 프로젝트에서 공유하는 하나의 Clay 워크스페이스를 나타냅니다.

Clay 연결 관리하기

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

특정 프로젝트의 Clay 접근만 제거하고 다른 프로젝트에서는 연결을 계속 사용하려면 Unlink projects를 사용합니다. 단계는 연결에서 프로젝트 연결 해제를 참고하세요.
워크스페이스에서 연결을 완전히 제거하려면 Delete the connection을 사용합니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 인증 정보가 제거되고 새 연결을 추가할 때까지 관련 앱 기능이 중단됩니다. 연결 삭제에서 단계와 권한을 확인하세요.