Click: 앱에 연결하는 관리형 AI 에이전트 API

Click은 무엇을 하는 서비스인가요?

Click은 개발자가 자신의 앱에 AI 에이전트를 넣을 때 사용하는 관리형 API입니다. 모델 키, 지시사항, 허용할 도구를 제공하면 Click이 모델과 도구 호출, 대화 기록, 실행 복구를 관리합니다. 앱은 API 조회, 이벤트 스트림, Webhook으로 결과를 받습니다.

예를 들어 매출 CSV를 분석해 보고서를 만드는 도우미를 제품에 연결할 수 있습니다. 화면, 사용자 인증, 데이터 접근과 승인은 앱이 담당하고 Click은 에이전트 실행을 맡습니다. 운영사는 Click AI Labs, Inc.입니다. 여러 단계의 작업과 백그라운드 처리에 적합하며, 백엔드 연동과 결과 검토가 필요합니다.

첫 API 연동과 작업 결과 확인

1. Click 플랫폼 API 키와 지원되는 모델 제공업체의 키를 준비합니다. 문서상 리소스 생성·변경 전에 카드 인증이 필요하며 기존 계정은 면제될 수 있습니다. 인증 자체가 결제나 유료 구독을 시작하지는 않습니다.
2. POST /credentials로 모델 키를 저장하고 반환된 자격 증명 ID를 보관합니다. 두 키 모두 백엔드에 둡니다.
3. GET /models에서 해당 제공업체와 일치하는 모델을 선택합니다.
4. POST /agents로 모델, 지시사항, 도구 권한을 설정합니다. latest_version.id를 저장한 뒤 POST /sessions로 세션을 만듭니다.
5. POST /sessions/{session_id}/submissions로 작업을 보냅니다. request_id를 지정하면 재시도 시 원래 제출을 돌려받습니다.
6. done, cancelled, failed 중 최종 상태를 확인합니다. 성공하면 지정된 답변 항목을 읽고, 나머지는 이유를 살핍니다.

HTTP 202는 입력 저장을 뜻하며 작업 성공을 보장하지 않습니다. 세션 ID를 자체 문서나 티켓에 연결하면 같은 기록으로 후속 요청을 보낼 수 있습니다. 데이터를 반환하기 전에는 사용자 접근 권한을 확인해야 합니다.

MCP 도구와 파일 처리 연결

MCP Streamable HTTP 서버와 자체 HTTP 엔드포인트를 공개 HTTPS로 연결할 수 있습니다. 연결을 만든 뒤 사용할 도구를 명시적으로 허용합니다. HTTP 도구는 JSON Schema로 인자를 정의하고 JSON POST를 받으며 문서상 제한 시간은 120초입니다.

고객 티켓 조회 도구라면 엔드포인트에서 해당 사용자로 범위를 제한한 단기 토큰을 검증할 수 있습니다. 사용자 인증, 예산, 업무 승인과 결과 검사는 앱 책임입니다.

기본 기능에는 웹 검색, 브라우저 자동화, 샌드박스 파일·셸 작업이 있습니다. 문서는 Blaxel, Daytona 샌드박스와 자체 Browserbase 자격 증명도 안내합니다. 외부 서비스의 조건과 비용은 별도로 확인하세요.

파일 작업에는 Click 관리형 샌드박스를 사용합니다. POST /files로 입력을 올리고 작업에 파일 ID를 포함한 다음, 에이전트가 publish_file로 결과를 게시하게 합니다. artifacts를 조회하고 GET /files/{file_id}로 내려받을 수 있습니다. 샌드박스 작업 파일과 지속적으로 보관되는 게시 결과는 구분해야 하며 내용 검토도 필요합니다.

이벤트 스트림과 백그라운드 작업

GET /sessions/{session_id}/events는 전체 snapshot 다음에 텍스트, 도구, 상태 업데이트를 보냅니다. 재연결하면 새 snapshot으로 로컬 상태를 교체합니다. 스트림 연결이 끊겨도 작업은 계속되며 standby에 들어가면 스트림이 닫힙니다.

오래 걸리는 작업은 서명된 submission.updated, artifact.created Webhook으로 결과를 받을 수 있습니다. 알림 후 관련 리소스를 조회해 현재 상태를 확인하고 화면이나 업무 시스템에 반영합니다.

무료 한도와 Pro 요금의 범위

2026년 11월 3일 공식 요금 페이지에서 확인한 미국 달러 월 요금입니다. 원화 최종 결제액이나 국내 세금·결제 지원을 확정한 금액은 아닙니다.

• Free: 월 US$0. 동시 상주 세션 2개, 파일 공간 100 MB. 매월 관리형 샌드박스 1시간, 브라우저 1시간, 검색 100회입니다.
• Pro: 월 US$199. 동시 상주 세션 50개, 10 GB. 매월 샌드박스 100시간, 브라우저 100시간, 검색 5,000회입니다.
• Enterprise: 가격과 용량을 개별 협의합니다.

BYOK 방식이므로 모델 제공업체 요금은 따로 계산해야 합니다. 직접 연결한 외부 서비스도 별도 요금이 있을 수 있습니다. 저장 공간은 현재 용량 한도이며 매달 추가되는 양이 아닙니다. 관리형 할당량은 테넌트 전체가 공유합니다. Free는 UTC 기준 월별, Pro는 결제한 구독 기간별로 초기화됩니다.

실행 환경을 가진 활성·유휴 세션은 동시 수에 포함되고 standby는 제외됩니다. 할당량이 소진되면 도구 접근이 거절되거나 작업이 멈출 수 있습니다. 문서는 자동 초과 요금이 없다고 설명합니다.

개인정보와 도구 권한 확인

개인정보 처리 설명은 지시사항, 메시지, 파일, 도구 요청·결과와 자격 증명을 다룹니다. 작업 실행을 위해 모델·도구 제공업체에 데이터가 전달될 수 있으며 해당 업체의 정책도 적용될 수 있습니다.

Click 직원은 도입 지원, 고객 지원, 문제 해결, 개선을 위해 내용에 접근할 수 있습니다. 보관은 합리적 필요에 따르며 일괄적인 고정 기간은 제시하지 않습니다. 미국과 다른 국가에서 처리될 수 있으므로 국내 처리, 무보관, 일괄적인 학습 미사용을 보장한다고 해석하면 안 됩니다.

비밀 키는 지정된 자격 증명 설정에 넣고 메시지나 파일에 쓰지 마세요. 정책은 규제 대상의 매우 민감한 정보를 제출하지 않도록 요청합니다.

자주 묻는 질문

Click을 무료로 쓸 수 있나요?

Free 한도 내에서 가능합니다. 모델 제공업체 비용은 별도로 생길 수 있고, 리소스 생성에는 보통 카드 인증이 필요합니다.

모델 API 키를 따로 준비해야 하나요?

네. 공식 절차는 제공업체 키를 저장하고 GET /models에서 호환 모델을 선택합니다. Click 키와 모델 키는 역할이 다르며 모두 백엔드에 보관합니다.

기존 MCP 서버나 업무 API를 연결할 수 있나요?

가능합니다. MCP 또는 자체 HTTPS 도구에 명시적인 권한을 부여합니다. 고객 접근 통제와 중요한 동작의 업무 승인은 앱이 담당합니다.

공식 개발자 자료

• API 참조 문서: 도구, 이벤트, Webhook, 파일 규격.
• 빠른 시작: 첫 에이전트와 세션 구성.
• 이용약관과 지원 정보: 호스팅 서비스 조건과 공식 지원 경로.