연동
어떤 API든 연결하기
커넥터 카탈로그에 없는 서비스도 쓸 수 있어요. 누구나 쓰는 공개 API부터 키가 필요한 서비스까지, 그리고 AI가 활용할 수 있는 나만의 커넥터를 만드는 방법까지 알려 드려요.
커넥터 카탈로그에는 100개가 넘는 서비스가 있어요. 하지만 API(다른 소프트웨어가 서비스와 대화하는 통로)가 있는 서비스라면, 앱에서 거의 다 쓸 수 있어요. 이 페이지에서는 가장 빠른 방법부터 가장 오래 쓸 수 있는 방법까지, 세 가지를 알려 드려요.
| 내 상황 | 할 일 |
|---|---|
| API가 공개되어 있고 키가 필요 없어요 | 채팅에서 요청하세요 |
| API에 키가 필요하고, 앱 하나에서만 쓸 거예요 | AI가 키를 물어보면 알려 주세요. 그 앱의 비밀 값으로 저장돼요 |
| 여러 앱에서 쓸 서비스이거나, AI가 서비스를 잘 이해하길 바라요 | 커넥터 페이지에서 나만의 커넥터를 만드세요 |
어떤 방법을 고르든 키는 앱의 서버 코드에서만 쓰여요. 그래서 방문자의 브라우저에는 키가 남지 않아요.
공개 API 사용하기
날씨, 공휴일, 공공 데이터 같은 서비스는 대부분 키가 전혀 필요 없어요. 서비스 이름과 가져오고 싶은 내용을 말해 주세요.
홈 화면에 방문자가 있는 도시의 5일 날씨 예보를 보여 줘. Open-Meteo API를 사용해 줘.
AI가 잘 모르는 API라서 자세한 내용이 필요하다면, 문서에서 관련 부분을 채팅에 붙여 넣어 주세요. 예를 들어 요청 예시 하나와 그 결과를 붙여 넣거나, 문서를 파일로 첨부하면 돼요. 이미지와 파일 추가하기를 참고하세요.
키가 필요한 API 사용하기
카탈로그에 없는 서비스의 키가 기능에 필요하면, AI가 채팅에 키 카드를 보여 줘요. 카드에는 AI가 쓸 이름이 적혀 있어요. 예를 들면 ACME_API_KEY 같은 이름이에요. 키를 붙여 넣고 저장을 누르세요. 키 없이 계속 진행하려면 건너뛰기를 누르세요.
카드에도 분명하게 적혀 있어요. 키는 안전하게 암호화되어 저장되고, 채팅이나 앱 코드에는 절대 나타나지 않아요. 나중에 관리 → 비밀 값에서 바꿀 수도 있어요. 팀원에게는 프로젝트 소유자가 바꿀 수 있다고 안내돼요.
문의 양식을 추가해 줘. 양식을 보내면 우리 CRM의 API로 새 고객 정보가 만들어지게 해 줘. API 키는 나한테 물어봐 줘.
요청하기 전에 직접 키를 추가해 둘 수도 있어요. 관리 탭을 열고 비밀 값을 고른 다음, 새 비밀 값 추가에서 추가하세요. 미리보기는 바뀐 내용을 자동으로 반영해요. 게시한 앱은 다음에 게시할 때 반영돼요. 비밀 값과 API 키를 참고하세요.
키를 채팅 메시지에 입력하지 마세요. 채팅 메시지는 프로젝트와 함께 저장돼요. 대신 키 카드나 관리 → 비밀 값을 사용하세요.
나만의 커넥터 만들기
한 서비스를 앱 여러 개에서 쓰거나, AI가 그 API를 제대로 이해하길 바란다면 나만의 커넥터로 추가하세요. API는 한 번만 설명해 두면 돼요. 그다음부터는 카탈로그의 커넥터처럼 쓸 수 있어요. 내 키로 연결하고, 앱마다 켜거나 끌 수 있고, AI가 앱을 만들면서 그 커넥터를 사용하고 내용을 읽을 수도 있어요.
커넥터 페이지에서 내 커넥터까지 내려가 커넥터 만들기를 누르세요. 서비스의 API 문서를 열어 두세요. API 주소와 키를 보내는 방식을 알아야 하거든요. 설명 자체에는 키를 넣지 않아요. 키는 마지막에 연결할 때 입력해요.
세부 정보
이름을 정해 주세요. 카드에 보일 짧은 설명과 하는 일은 선택으로 적을 수 있어요. 하는 일을 적어 두면 AI가 언제 이 커넥터를 쓰면 되는지 알기 쉬워요. 그다음 카테고리를 고르고, 원하면 API 문서 링크를 넣고, 색상을 고르세요. 코드 이름은 앱이 읽는 설정 이름을 정해요. 예를 들면
ACME_CRM_API_KEY같은 이름이에요. 코드 이름은 나중에 바꿀 수 없어요.로그인 방식
모든 요청이 시작되는 API 주소를 입력하세요. 반드시
https://로 시작해야 해요. 그다음 서비스는 어떻게 사용자를 확인하나요? 에 답하세요. Bearer 토큰, 헤더에 담는 API 키, 주소에 넣는 API 키, 사용자 이름과 비밀번호 중에서 고르면 돼요. 계정 ID처럼 서비스에 값이 하나 이상 필요하다면 값이 하나 이상 필요한가요? 에서 추가하세요. 미리보기에서 요청은 이렇게 생겼어요를 볼 수 있어요.테스트 요청
읽기만 하고 키가 필요한 요청을 고르세요. "내 정보 보기"나 "내 항목 목록 보기" 같은 요청이에요. Buildliy는 키를 저장하기 전에 이 요청을 보내서 키가 맞는지 확인해요. 그래서 아무것도 바꾸지 않는 요청이어야 해요. 직접 해보기 (선택) 에서 키를 붙여 넣고 테스트 요청 보내기를 누르면 결과를 볼 수 있어요. 이 키는 테스트에만 쓰이고, 나중에 그 키로 연결하지 않으면 저장되지 않아요.
데이터를 볼 수 있는 사람
받은 편지함, 메모, 은행 정보처럼 개인 계정의 데이터라면 나만 볼 수 있어요 (개인용) 를 고르세요. 상품 목록이나 공개된 목록처럼 모두를 위한 데이터라면 내 앱을 쓰는 누구나 (공유용) 를 고르세요.
AI를 위한 메모
AI가 알아야 할 API 문서의 일부를 붙여 넣을 수 있어요. 엔드포인트, 요청 예시, 결과 예시 같은 내용이에요. 이 단계는 선택이에요. 메모마다 파일 이름을 정하고, 원하면 AI가 언제 읽으면 될까요? 도 적어 주세요. 메모는 최대 10개까지 추가할 수 있고, 하나당 최대 20,000자까지 쓸 수 있어요. AI는 각 메모의 앞부분을 보고, 나머지는 필요할 때 읽어요. 여기에는 절대 키를 붙여 넣지 마세요.
커넥터 만들기를 누르세요. 이어서 연결 창이 열려요. 직접 해보기 (선택) 에 키를 입력했다면 그 키가 이미 채워져 있어요. 필요하면 키를 입력하고 연결을 누르세요. Buildliy는 키를 저장하기 전에 그 키로 테스트 요청을 보내 보고, 그다음 암호화해서 보관해요. 이 키는 앱의 서버 코드에서만 쓰여요.
내 Acme CRM 커넥터를 사용해서 대시보드 페이지에 최근 연락처 20개를 보여 줘. 검색창도 넣어 줘.
나만의 커넥터마다 카드가 있고, 카드에는 연결(연결한 뒤에는 관리, 키가 더 이상 작동하지 않으면 다시 연결), 수정, 삭제 버튼이 있어요. 삭제하면 커넥터와 그 커넥터에 저장해 둔 키가 지워져요. 그 커넥터를 쓰던 앱은 다시 추가하기 전까지 그 서비스에 연결할 수 없어요. 나만의 커넥터는 최대 25개까지 만들 수 있어요.
나만 볼 수 있어요 (개인용) 를 골랐다면, AI는 그 서비스에서 가져온 모든 정보를 앱의 로그인 뒤에 둬요. 연결하고 나면 출시 체크리스트가 확인해요. 앱 코드가 그 커넥터를 쓰는데 앱에 로그인이 없으면 게시할 수 없어요. 앱에 로그인이 있다면, 체크리스트가 나만(또는 내가 정한 사람만) 로그인할 수 있는지 꼭 확인하라고 알려 줘요. 누구나 가입할 수 있으면 아무나 그 데이터를 볼 수 있기 때문이에요.
서비스에서 이벤트 받기
어떤 서비스는 새 주문이나 결제 완료처럼 무슨 일이 생기면 앱에 메시지를 보내 줄 수 있어요. 이런 메시지를 흔히 웹훅이라고 불러요. 앱에 이 메시지를 받을 곳을 추가해 달라고 AI에게 요청하세요. 메시지가 진짜인지 확인하도록 서비스가 서명 비밀 값을 준다면, AI가 키 카드로 그 값을 물어봐요.
우리 물류 시스템에서 보내는 새 주문 이벤트를 받는 웹훅 엔드포인트를 추가해 줘. 받은 주문은 하나씩 데이터베이스에 저장해 줘.
서비스에는 미리보기 주소가 아니라 게시한 앱의 주소를 알려 주세요. 미리보기는 항상 켜져 있지는 않기 때문이에요. 앱 게시하기를 참고하세요.