빠른 시작
AI 도구를 연결하고 첫 이미지를 만드는 순서입니다.연결하기
외부 AI 도구(MCP 클라이언트)를 내 스튜디오 계정에 붙이는 순서입니다. 서버 주소와 설정 코드는 클라이언트마다 달라서 이 문서에 적지 않습니다. 설정 화면이 고른 클라이언트에 맞춰 만들어 주는 코드를 그대로 복사하세요.
- 설정의 AI 도구 연결 화면(
/settings/connections)을 엽니다. - 사용하는 클라이언트를 고릅니다.
- 연결 이름을 정하고, 이 도구가 쓸 기능만 체크합니다.
- 연결 키를 만듭니다. 키는 만든 직후 한 번만 보입니다. 닫으면 다시 볼 수 없습니다.
- 화면이 보여 주는 설정 코드를 클라이언트에 붙여 넣습니다. 키는 코드에 직접 쓰지 않고 환경변수로 넘깁니다.
클라이언트별 안내
연결 화면이 안내하는 클라이언트는 Claude Code, Claude 앱 커스텀 커넥터, Codex, Cursor, Devin Desktop, Gemini CLI, Hermes입니다. 그 밖의 MCP 클라이언트도 HTTP로 붙는 MCP 서버를 지원하면 같은 방식으로 연결할 수 있습니다. 이때는 화면에서 가장 가까운 클라이언트의 코드를 참고해 주소와
Authorization: Bearer 헤더를 맞춥니다.통합 엔드포인트(
/mcp) 하나로 연결하면 허용한 기능의 도구가 모두 한 서버로 보입니다. 기능별 주소로 따로 연결할 수도 있습니다. 둘의 차이는 도구와 안전장치에 정리했습니다.접근 허용하기
OAuth 로그인을 지원하는 클라이언트는 처음 연결할 때 브라우저로 동의 화면이 열립니다. 화면이 보여 주는 기능 목록을 확인하고, 필요한 것만 남겨 허용합니다. 허용하지 않은 기능은 그 연결로 열리지 않습니다.
브라우저를 열 수 없는 환경은 기기 코드로 허용합니다. 클라이언트가 보여 주는 코드를
/oauth/device 화면에 입력해 승인합니다. 자세한 방식은 로그인과 키에 있습니다.첫 이미지 만들기
연결이 끝났으면 클라이언트에 이렇게 요청해 봅니다.
첫 요청 예시 — text
도구는 먼저 견적을 내고, 금액과 잔액을 보여 준 뒤 동의를 받고 접수합니다. 이미지 생성은 체리를 씁니다. 접수하는 순간 견적 금액이 보류되고, 작업이 끝나면 정산됩니다. 대기 중에 취소하면 환불됩니다.
기능이 켜져 있어야 합니다. 이미지 생성은 연결할 때 이미지 생성 기능을 허용했을 때만 보입니다.
문제 해결
| 증상 | 확인 | 조치 |
|---|---|---|
| 도구가 하나도 안 보임 | 연결 화면에서 허용한 기능 | 필요한 기능을 허용한 새 연결을 만듭니다. |
| 401 오류 | 키가 폐기됐거나 만료됐는지 | 연결 화면의 키 목록에서 상태를 확인하고 새로 만듭니다. |
| 일부 기능만 안 보임 | 팀 전용·준비 중인 기능인지 | 캐릭터챗 저작은 팀 전용입니다. 만화 저작은 만화 작업실이 열린 환경에서만 보입니다. |
| 접수가 승인 대기에서 멈춤 | 영수증의 승인 링크 | 링크를 열어 웹에서 승인합니다. 승인은 10분 안에 해야 합니다. |
| 잔액 부족으로 거절됨 | 견적 금액과 잔액 | 체리를 충전한 뒤 같은 요청을 다시 보냅니다. |
| 한도 초과(429) | 응답의 재시도 대기 시간 | 대기 시간이 지난 뒤 다시 보냅니다. 한도 표는 도구와 안전장치에 있습니다. |
더 많은 증상은 문제 해결에 있습니다.