개발자 문서

MCP · AI 에이전트

크레딧 사용 확인

에이전트는 여러분의 크레딧으로 생성합니다. 그래서 언제 먼저 물어볼지를 여러분이 정합니다. 기본은 ‘처음 한 번만 묻기’입니다.

확인 모드

모드크레딧을 쓰는 생성삭제 · 관리자 변경 · 결제 · 계정 변경
once (기본)계정마다 처음 한 번만 확인. 승인하면 그다음부터 묻지 않음매번 확인
ask매번 확인매번 확인
yolo확인 없이 진행확인 없이 진행

조회(목록·상태·견적)와 내 데이터 정리(폴더 만들기·이름 바꾸기·업로드)는 어떤 모드에서도 묻지 않습니다.

바꾸기

모드는 사용자가 터미널에서만 바꿀 수 있습니다. 에이전트에게는 모드를 바꾸는 도구를 주지 않습니다.

터미널
aimz agent                 # 지금 상태 (모드 · 상한 · 동의 기록)
aimz agent mode yolo       # 묻지 않고 진행
aimz agent mode ask        # 매번 묻기
aimz agent mode once       # 기본으로 되돌리기
aimz agent limit 500       # 한 번에 500 크레딧 넘으면 모드와 관계없이 확인
aimz agent limit off       # 상한 끄기
aimz agent reset           # 크레딧 사용 동의 기록 삭제 → 다음 생성 때 다시 확인
yolo 모드
에이전트가 확인 없이 크레딧을 쓰고, 삭제·관리자 변경도 바로 실행합니다. 믿을 수 있는 작업에만 켜고, aimz agent limit 으로 1회 상한을 함께 거는 것을 권합니다.

MCP 에서 묻는 방법

승인 창 (지원하는 클라이언트)

모델 이름, 예상 최대 크레딧, 프롬프트를 담은 승인 창이 뜹니다. 승인하면 실행되고, 거절하면 실행하지 않으며 에이전트에게 “같은 요청을 반복하지 말라”고 알립니다. once 모드라면 승인이 기록돼 그다음부터는 묻지 않습니다.

채팅으로 묻기 (승인 창이 없는 클라이언트)

도구가 “사용자 확인 필요”와 일회용 확인 표(confirm_token)를 돌려줍니다. 에이전트는 내용을 여러분에게 보여 주고, 승인한 경우에만 같은 요청에 표를 붙여 다시 보냅니다. 표는 정확히 그 요청(같은 모델·같은 입력)에만 맞고, 10분 동안 한 번만 쓸 수 있습니다.

CLI 에서 묻는 방법

  • 터미널에서 직접 실행하면 계속할까요? [y/N] 로 묻습니다.
  • 에이전트가 셸로 실행해 물어볼 수 없으면, 실행하지 않고 종료 코드 3 과 함께 “사용자 확인 필요”를 출력합니다. 사용자가 승인한 경우에만 --yes 를 붙여 다시 실행합니다.
터미널
aimz generate nanobanana --prompt "..."          # 확인 필요 → 종료 코드 3
aimz generate nanobanana --prompt "..." --yes    # 사용자가 승인한 경우

서버 쪽 한도는 그대로입니다

이 확인 정책은 여러분 PC 에서 실수로 크레딧을 쓰는 것을 막는 장치입니다. 그와 별개로 서버는 언제나 다음을 지킵니다.

  • 잔액이 모자라면 생성을 접수하지 않습니다.
  • 생성 요청은 계정당 분당 30회까지입니다(관리자 계정 제외).
  • 공급사 오류로 실패한 생성은 크레딧이 정산(환불)됩니다.
  • 관리자가 생성을 멈추면 대기 중인 작업도 실행되지 않습니다.
참고
정책은 에이전트의 실수를 막기 위한 것입니다. 셸 권한을 가진 에이전트가 일부러 우회하는 것까지 막지는 못합니다. 중요한 계정은 에이전트에게 맡기는 범위를 신중히 정하세요.