AI 에이전트 및 API 이해하기
Claude, ChatGPT, Claude Code, Codex, Cursor와 같은 AI 에이전트가 Clevera 워크스페이스에서 수행할 수 있는 작업, 연결 방법, 플랜(Pro 이상), 제한 사항, 역할, 비용 및 안전성에 대해 알아보세요.
AI 에이전트 및 API를 사용하면 Claude, ChatGPT, Claude Code, Codex, Cursor와 같은 AI 앱과 직접 만든 스크립트가 Clevera 워크스페이스에서 작동할 수 있습니다. 녹화본 찾기, 동영상·소셜 클립·아티클 요청, 동영상 내보내기, 문서 사이트 작업 등이 가능합니다. 각 에이전트가 수행할 수 있는 작업, 사용할 수 있는 크레딧, 사람이 승인해야 하는 시점을 직접 결정할 수 있습니다.
에이전트가 할 수 있는 작업
| 영역 | 에이전트가 할 수 있는 작업 |
|---|---|
| 동영상 | 녹화본, 동영상, 아티클 및 트랜스크립트 목록 조회 및 읽기; 녹화본을 활용한 하우투, 제품 데모, 정리 및 스타일 지정 동영상, 소셜 클립, 아티클 및 동영상 번역 요청; 최대 4K MP4 내보내기; 업로드 항목에 이미지, 동영상 및 PDF 추가. |
| 문서 사이트 | 문서 사이트 페이지 및 변경 로그 읽기, 초안 작성, 구성, 번역 및 게시; 게시된 페이지에 대한 독자 질문 답변; 독자 인사이트 읽기; 사이트 설정 변경 또는 사이트 생성. |
에이전트는 아직 웹사이트 조사나 녹화된 워크스루를 실행할 수 없습니다.
에이전트가 요청을 하면 Clevera의 자체 AI가 앱에서 직접 시작할 때와 동일한 방식으로 동영상이나 아티클을 생성합니다. 에이전트는 토큰 소유자가 볼 수 있는 범위 내에서만 정보를 확인합니다. 토큰 소유자에게 접근 권한이 없는 비공개 컬렉션의 녹화본은 에이전트에게도 표시되지 않습니다.
연결 방법
| 방법 | 대상 | 설정 위치 |
|---|---|---|
| API 토큰 | Claude Code, Codex CLI, Cursor, 모든 MCP 클라이언트 및 REST API를 사용하는 직접 만든 스크립트 | 토큰 → 새 토큰. API 토큰 만들기를 참조하세요. |
| 연결된 앱 | 사용자 지정 커넥터로서의 Claude(claude.ai) 및 ChatGPT; 토큰 없이 로그인하여 사용 | 연결된 앱의 커넥터 URL을 사용하는 앱. AI 앱 및 에이전트 연결하기를 참조하세요. |
| REST API | 스크립트 및 백엔드 서비스 | API 토큰. REST API 사용하기를 참조하세요. |
MCP 서버는 https://app.clevera.ai/mcp이며, REST API는 https://app.clevera.ai/api/v1 아래에 있습니다.
페이지 찾기
워크스페이스 메뉴를 열고 AI 에이전트 및 API를 선택하세요. 문서 사이트의 경우, Docs 홈 페이지와 사이트의 설정 메뉴에서도 찾을 수 있습니다. 해당 페이지("Claude, Codex, ChatGPT 및 스크립트가 이 워크스페이스에서 작업하도록 허용하세요.")에는 각각 개수가 표시된 5개의 탭이 있습니다.
| 탭 | 내용 |
|---|---|
| 토큰 | API 토큰; 소유자와 관리자는 모든 토큰을 볼 수 있습니다. API 토큰 관리 |
| 연결된 앱 | 커넥터 URL 및 사용자가 연결한 앱. AI 앱 및 에이전트 연결하기 |
| 에이전트 요청 | 사람이 승인하기를 기다리는 유료 작업(개수 배지 포함) 및 기록. 에이전트 지출 및 승인 제어 |
| 웹훅 | 자체 시스템으로 보내는 서명된 알림. 웹훅 설정하기 |
| 활동 | 에이전트가 수행한 작업. 에이전트 활동 읽기 |
플랜
AI 에이전트 및 API는 Pro, 비즈니스 및 사용자 지정 플랜에서 제공됩니다. 여기에는 API 토큰, Claude 및 ChatGPT용 커넥터, 웹훅이 포함됩니다.
Free 및 Starter 플랜에서는 페이지에 "AI 에이전트 및 API는 Pro에 포함되어 있습니다"라고 표시됩니다: "Claude, ChatGPT 및 스크립트가 이 워크스페이스에서 작업할 수 있도록 업그레이드하세요. 기존 토큰과 앱은 업그레이드 전까지 작동이 중단되지만, 여기서 취소할 수는 있습니다." Pro로 업그레이드를 클릭하세요. 잠긴 컨트롤에는 "API 및 에이전트 액세스는 Pro 이상에서 제공됩니다.", "Claude.ai 및 ChatGPT 커넥터는 Pro 이상에서 제공됩니다." 또는 "웹훅은 Pro 이상에서 제공됩니다."라는 메시지가 표시됩니다.
| 제한 | Pro, 비즈니스, 사용자 지정 |
|---|---|
| 워크스페이스당 활성 API 토큰 | 50 |
| 사용자당 연결된 앱 | 20 |
| 워크스페이스당 웹훅 | 10 |
| 아래에서 자동 승인 최대치 | Pro 및 비즈니스: 500 크레딧. 사용자 지정: 1,000 크레딧. |
워크스페이스가 Pro 플랜을 종료하는 경우
데이터는 삭제되지 않지만, 다시 업그레이드할 때까지 모든 기능이 일시 중지됩니다:
| Starter 또는 Free로 이동 후 | |
|---|---|
| API 토큰 | 목록에 유지되며 취소할 수 있습니다. 모든 호출이 거부됩니다: "에이전트 API는 이 워크스페이스의 플랜에 포함되어 있지 않습니다. Pro 이상에서 제공됩니다." 토큰을 다시 생성할 수 없습니다(시크릿 다시 생성을 누르면 업그레이드 대화 상자가 열립니다). |
| 연결된 앱 | 목록에 유지되며 연결을 해제할 수 있습니다. 호출이 실패하며, Claude나 ChatGPT는 연결할 수 없다는 메시지만 표시할 수 있습니다. |
| 웹훅 | 목록에 유지되지만 아무것도 전송되지 않습니다. 테스트 이벤트 보내기 및 다시 전달을 누르면 "웹훅은 현재 플랜에 포함되어 있지 않습니다."라고 표시됩니다. |
| 에이전트 요청 | 승인을 누르면 "API 및 에이전트 액세스는 현재 플랜에 포함되어 있지 않습니다."라고 표시됩니다. 거부는 계속 작동합니다. |
| 새 토큰 | "API 및 에이전트 액세스는 현재 플랜에 포함되어 있지 않습니다." |
다시 Pro로 업그레이드하면 토큰, 앱 및 웹훅이 다시 작동합니다. 토큰은 원래 만료일에 만료됩니다.
역할별 권한
에이전트는 해당 토큰을 생성하거나 연결한 사람의 권한 범위 내에서 행동합니다. 에이전트는 해당 사용자가 앱에서 할 수 있는 작업 이상을 수행할 수 없으며, 모든 호출 시 역할이 확인되므로 역할 변경 사항은 즉시 적용됩니다.
| 작업 | 소유자 | 관리자 | 편집자 | 콘텐츠 제작자 |
|---|---|---|---|---|
| 본인을 위한 토큰 생성 및 앱 연결 | 예 | 예 | 예 | 예 |
| 워크스페이스의 모든 토큰 및 앱 보기/취소 | 예 | 예 | 본인만 | 본인만 |
| 에이전트에게 동영상 요청 및 크레딧 사용 권한 부여 | 예 | 예 | 아니요 | 예 |
| 에이전트에게 문서 사이트 게시 권한 부여 | 예 | 예 | 예 | 아니요 |
| 에이전트가 요청한 유료 작업 승인 | 예 | 예 | 아니요 | 아니요 |
| 웹훅 관리 | 예 | 예 | 아니요 | 아니요 |
전체 목록은 에이전트 권한에서 확인할 수 있습니다.
비용
- API 및 MCP 호출은 무료입니다: 읽기, 검색, 인용 및 작업 확인은 크레딧을 소모하지 않습니다. 동영상 내보내기도 마찬가지입니다.
- AI를 사용하는 작업은 앱에서 시작할 때와 동일하게 크레딧이 소모됩니다: 동영상, 소셜 클립, 녹화본 기반 아티클, 번역 및 AI 생성 사이트 페이지.
- 에이전트는
credits:spend이 있는 토큰으로만 유료 작업을 시작할 수 있습니다. 모든 작업은 시작 전 견적이 산출되고 토큰의 지출 한도 내에 있는지 확인되며, 토큰의 아래에서 자동 승인 기준 미만인 경우를 제외하고는 사람이 승인해야 합니다. 에이전트 지출 및 승인 제어를 참조하세요.
Clevera의 에이전트 안전 관리
- 토큰은 항상 만료됩니다: 7일, 30일, 90일 또는 1년 후 만료됩니다. "만료 없음" 설정은 없습니다.
- 시크릿은 한 번만 표시됩니다. Clevera는 지문(fingerprint)만 저장하며 마지막 4자만 표시합니다.
- 최소 권한 원칙. 각 토큰은 사용자가 선택한 권한, 문서 사이트 및 IP 주소만 가집니다.
- 사람이 비용을 승인합니다. 에이전트는 자신의 지출을 직접 승인할 수 없으며, 워크스페이스 소유자나 관리자만 승인할 수 있습니다.
- 유출된 토큰은 취소됩니다. 공개 GitHub 저장소에서 발견된 Clevera 토큰은 자동으로 취소됩니다.
- 비정상적인 활동은 중단됩니다. 거부된 호출이 급증하면 토큰이 취소됩니다. 변경이나 지출이 급증하면 토큰이 일시 중지되고 소유자에게 알림이 전송됩니다.
- 모든 활동은 기록됩니다. 활동 탭에 13개월간 보관됩니다. 에이전트의 문서 사이트 편집 기록은 페이지 기록에 "에이전트 이름 (토큰)"으로 표시됩니다.