AI 에이전트를 위한 API 토큰 만들기

API 토큰을 사용하면 Claude Code, Codex, Cursor 또는 직접 작성한 스크립트가 사용자가 선택한 권한 범위 내에서 워크스페이스 내에서 사용자 대신 작업을 수행할 수 있습니다. 4단계 마법사(용도, 권한, 제한, 검토)를 통해 토큰을 만들 수 있으며, Clevera는 토큰을 한 번만 표시합니다.

시작하기 전에#

• AI 에이전트 및 API는 Pro, Business 및 Custom 플랜에서 제공됩니다. 다른 플랜에서는 새 토큰 버튼에 "API 및 에이전트 액세스는 Pro 플랜 이상에서 제공됩니다."라는 메시지가 표시됩니다.
• 모든 워크스페이스 멤버는 자신의 토큰을 만들 수 있습니다. 토큰은 사용자의 역할이 허용하는 권한만 가질 수 있습니다. 에이전트 권한을 참조하세요.
• 워크스페이스당 최대 50개의 활성 토큰을 가질 수 있습니다. 제한에 도달하면 새 토큰 버튼이 비활성화되며 "워크스페이스의 활성 토큰 제한(50개)에 도달했습니다. 먼저 하나를 취소하세요."라는 메시지가 표시됩니다.
• 에이전트나 스크립트당 하나의 토큰을 사용하여 각 토큰의 활동을 추적하고 다른 토큰에 영향을 주지 않고 개별적으로 취소할 수 있도록 하세요.

토큰 만들기#

1. 토큰 탭 열기#

   워크스페이스 메뉴를 열고 AI 에이전트 및 API를 선택합니다. 토큰 탭에서 새 토큰을 클릭합니다.

2. 용도: 이름 지정 및 용도 선택#

   토큰 목록과 활동 로그에서 알아볼 수 있도록 최대 100자까지 이름을 지정하세요(예: "문서 작성자 (Claude Code)"). 어떤 용도인가요? 아래에서 사전 설정을 선택합니다. 선택한 작업에 필요한 권한이 자동으로 체크되며, 다음 단계에서 세부적으로 조정할 수 있습니다.

   

   사전 설정	용도
   작성자	"에이전트가 초안을 작성하고 사람이 검토 및 게시." 문서 사이트 초안.
   게시자	"독자가 보는 내용을 변경할 수 있는 신뢰할 수 있는 자동화." 게시를 포함한 문서 사이트.
   고객 지원 어시스턴트	"게시된 문서에서 답변 제공. 그 외 기능 없음." 헬프 봇.
   읽기 전용	"조사, 감사 및 번역 확인."
   분석가	"콘텐츠와 독자 신호를 읽어 수정 제안."
   프로듀서	"콘텐츠 초안 작성 및 지출 한도 내에서 유료 작업 시작." 동영상, 클립 및 기사 요청.
   워크스페이스 에이전트	"지출 한도 내에서 에이전트가 이 워크스페이스에서 수행할 수 있는 모든 작업."

   회색으로 표시된 사전 설정은 사용자의 역할로 부여할 수 없는 권한을 포함하고 있습니다: "사용자의 역할로는 이 사전 설정의 모든 기능을 부여할 수 없습니다."

3. 권한: 각 권한 확인#

   이 단계에서는 문서, 동영상, 워크스페이스별로 그룹화된 모든 권한과 각 권한이 허용하는 작업 및 배지(읽음, 편집, 게시, 관리 또는 크레딧 사용)를 나열합니다. 원하는 대로 체크하거나 해제하세요. 사전 설정의 기본값을 변경하면 제목에 사용자 지정됨이 표시되며, 다음으로 재설정 사전 설정을 클릭하여 변경 사항을 되돌릴 수 있습니다.

   

   각 권한이 허용하는 작업: 에이전트 권한.

4. 제한: 만료, 사이트, 지출 및 주소 설정#

   

   아래의 제한 옵션을 참조하세요.

5. 검토 및 만들기#

   검토 단계에서는 토큰이 수행할 수 있는 작업(읽기 가능, 생성 및 편집 가능, 게시 가능, 사이트 관리 가능, 크레딧 사용 가능)과 제한 사항을 명확한 언어로 설명합니다. "이 토큰은 사용자의 역할이 허용하는 범위 내에서 사용자 대신 작동합니다." 토큰 만들기를 클릭하세요.

   

6. 토큰 복사#

   토큰 생성됨 화면에 clv_agent_로 시작하는 토큰이 표시됩니다: "지금 복사하세요. 다시는 볼 수 없습니다." 토큰을 보안 저장소나 환경 변수에 복사하세요. 아래의 에이전트 연결에는 Claude Code, Codex CLI, .mcp.json, curl 및 Claude.ai, ChatGPT를 위한 준비된 설정 방법이 있습니다. 완료되면 저장했습니다를 클릭하세요.

   

뒤로를 클릭하면 입력한 모든 내용이 유지됩니다. 변경 사항이 있는 상태에서 마법사를 닫으면 "이 토큰을 삭제할까요?"라는 메시지가 표시됩니다: "시작한 설정이 손실됩니다. 토큰이 생성되지 않습니다."

제한 옵션#

지출은 토큰에 credits:spend 권한이 있는 경우에만 표시됩니다(프로듀서 및 워크스페이스 에이전트 사전 설정). 한도와 승인이 함께 작동하는 방식: 에이전트 지출 및 승인 제어.

다음 단계#

• 토큰은 MCP(https://app.clevera.ai/mcp) 및 REST API를 통해 즉시 작동합니다.
• 워크스페이스 소유자와 관리자에게 "워크스페이스에 대한 새 API 토큰 이름이 생성되었습니다"라는 알림이 전송되며, 설정한 사람과 액세스 권한이 포함됩니다.
• 토큰은 토큰 탭에 마지막 4자리(예: clv_agent_…k7Qe)로 표시되며, 사용할 때마다 마지막 사용 시간이 업데이트됩니다.
• 토큰을 만든 후에는 권한과 제한을 변경할 수 없습니다. 변경하려면 새 토큰을 만들고 이전 토큰을 취소하세요. API 토큰 관리를 참조하세요.

문제 해결#

관련 항목#