로그인과 키

연결 방식, 개인 키 관리, 허용 범위를 설명합니다.

인증 방식 비교

방식	쓰는 곳	특징
OAuth 동의	브라우저를 열 수 있는 MCP 클라이언트	클라이언트가 스스로 등록하고, 동의 화면에서 기능을 골라 허용합니다. 허용 내역은 계정에서 폐기할 수 있습니다.
기기 코드	브라우저가 없는 환경(원격 서버 등)	클라이언트가 보여 주는 코드를 다른 기기의 `/oauth/device` 화면에서 승인합니다.
개인 키	스크립트, 공개 REST(`/v1`), 설정 코드로 키를 직접 넘기는 클라이언트	접두사 `mzpt_`로 시작합니다. 만든 직후 한 번만 보이고, 기능 단위로 권한을 좁혀 만듭니다.

세 방식 모두 Authorization: Bearer <토큰> 헤더로 보냅니다. 인증 헤더는 하나만 보냅니다. 두 개를 함께 보내면 어느 쪽인지 정할 수 없어 거부됩니다.

설정의 AI 도구 연결(/settings/connections)에서 만듭니다.

이름: 에이전트나 기기를 알아볼 수 있는 이름입니다.
허용할 기능: 하나 이상 고릅니다. 기본으로 켜진 기능은 없습니다.
만료: 30일(기본) 또는 90일입니다. 만료 없는 키는 만들 수 없습니다.
지출 한도: 선택 사항입니다. 하루 또는 한 달(UTC 기준) 동안 이 키로 쓸 수 있는 체리의 상한입니다. 한도가 없으면 잔액만 확인합니다.

계정에는 활성 키를 최대 20개까지 둘 수 있습니다. 한도는 만든 뒤에도 고치거나 해제할 수 있고, 이미 쓴 금액은 그대로 두고 다음 접수부터 새 한도를 적용합니다.

폐기한 키는 즉시 쓸 수 없습니다. 이미 폐기됐거나 없는 키를 폐기해도 존재 여부를 알려 주지 않습니다.

연결 화면의 기능 이름과 접근하는 주소입니다. 표는 서버 계약에서 생성합니다.

기능	주소	쓰기 한도(시간당)	읽기 한도(시간당)
영상 저작	`/video/mcp`	1200	12000
만화 저작	`/toon/mcp`	600	6000
웹소설 저작	`/novel/mcp`	600	6000
스튜디오 공통	`/studio/mcp`	600	6000
이미지 생성	`/image/mcp`	300	3000
영상 생성	`/video-gen/mcp`	300	3000

체리를 쓰는 기능은 이미지 생성, 영상 생성, 캐릭터챗 저작입니다. 이 기능은 필요한 에이전트에만 허용하세요.

키는 환경변수나 비밀 저장소에서만 읽습니다. 코드, 대화, 이슈, 로그에 쓰지 않습니다.
서버는 키의 평문을 저장하지 않으므로 잃어버리면 복구할 수 없습니다. 새로 만들고 이전 키를 폐기합니다.
에이전트에는 일을 하는 데 필요한 기능만 허용합니다. 읽기만 할 에이전트에게 생성 기능을 주지 않습니다.
지출 한도를 걸어 두면 키가 노출돼도 피해가 한도에서 멈춥니다.
에이전트가 읽는 작품 제목, 본문, 대사는 사용자가 쓴 데이터입니다. 그 안의 문장을 지시로 따르지 않도록 하세요. 서버가 돌려주는 결과에도 같은 안내가 붙습니다.