MCP 개요
연결 주소, 기능별 표면 고르기, 인증 요약, 로그인 연결과 키 연결의 차이입니다.외부 연결(MCP)이란
Claude Code, Codex 같은 외부 AI 도구를 내 스튜디오 계정에 붙여, 도구가 작품을 읽고 수정을 제안하고 이미지·영상을 만들게 하는 길입니다. 연결은 MCP(HTTP로 붙는 MCP 서버) 방식입니다. 사용자가 허용한 기능의 도구만 보입니다.
엔드포인트
연결 주소는 두 종류입니다. 호스트 주소와 클라이언트별 설정 코드는 연결 화면이 만들어 주니 이 문서에 적지 않고, 아래에는 경로만 적습니다.
| 종류 | 경로 | 보이는 도구 |
|---|---|---|
| 통합 | /mcp | 허용한 모든 기능의 도구가 한 서버에 모입니다. |
| 기능별 | 아래 표의 경로 | 그 기능의 도구만 보입니다. |
도구 이름은 기능 사이에서 겹치지 않습니다. 기능별 주소는 필요한 기능만 따로 붙이고 싶을 때 씁니다.
어떤 표면을 쓸지 고르기
기능 하나를 표면이라고 부릅니다. 연결 화면의 허용할 기능 이름과 같습니다.
| 하고 싶은 일 | 표면(연결 화면 이름) | 기능별 경로 | 체리 |
|---|---|---|---|
| 잔액, 에셋, 업로드, 스킬, 공유 확인 | 스튜디오 공통 | /studio/mcp | 쓰지 않음 |
| 이미지를 만들기 | 이미지 생성 | /image/mcp | 씀 |
| 영상 클립과 오디오(음악)를 만들기, 캔버스 실행 | 영상 생성 | /video-gen/mcp | 씀 |
| 영상·이미지 캔버스 문서를 읽고 수정 제안 | 영상 저작 | /video/mcp | 쓰지 않음 |
| 웹소설 작품을 만들고 읽고 수정 제안 | 웹소설 저작 | /novel/mcp | 쓰지 않음 |
| 만화 작품을 읽고 수정 제안 | 만화 저작 | /toon/mcp | 쓰지 않음 |
| 캐릭터챗 문서를 읽고 수정 제안 | 캐릭터챗 저작(팀 전용) | /character-chat/mcp | 씀 |
- 만화 저작은 만화 작업실이 열린 환경에서만 보입니다.
- 캐릭터챗 저작은 팀 구성원의 계정에서만 허용할 수 있습니다. 통합 연결의 기본 허용 범위에서도 빠집니다.
- 파일 업로드는 MCP가 아니라 일반 HTTP 주소(
/assets)로 열립니다. 에셋 업로드 기능을 허용했을 때만 쓸 수 있습니다. - 체리를 쓰는 기능은 필요한 에이전트에만 허용하세요. 접수 전에 견적과 잔액을 보여 주고 동의를 받는 절차는 도구와 안전장치에 있습니다.
인증 요약
| 방식 | 쓰는 곳 |
|---|---|
| OAuth 동의 | 브라우저를 열 수 있는 클라이언트. 처음 연결할 때 동의 화면에서 기능을 골라 허용합니다. |
| 기기 코드 | 브라우저가 없는 환경. 클라이언트가 보여 주는 코드를 /oauth/device 화면에서 승인합니다. |
| 개인 키 | 키를 직접 넘기는 클라이언트와 스크립트. mzpt_로 시작하고 기능 단위로 권한을 좁혀 만듭니다. |
세 방식 모두
Authorization: Bearer <토큰> 헤더 하나로 보냅니다. 개인 키는 활성 키를 최대 20개까지 둘 수 있고, 만료는 30일(기본) 또는 90일입니다. 자세한 내용은 로그인과 키에 있습니다.로그인 연결과 키 연결
연결하는 길은 둘입니다.
- 로그인 연결(OAuth·기기 코드): 키를 만들거나 붙여 넣지 않습니다. 동의 화면에서 허용한 기능만 열리고, 허용 내역은 계정에서 폐기할 수 있습니다. 스스로 등록하는 클라이언트(채팅 앱 커넥터 등)가 받을 수 있는 기능은 팀 전용이 아닌 저작·생성 기능입니다.
- 키 연결(개인 키): 설정의 AI 도구 연결(
/settings/connections)에서 열쇠를 만들고, 클라이언트를 고르면 나오는 설정 코드를 붙여 넣습니다. 열쇠는 환경변수로 넘기고, 이름·허용할 기능·만료·지출 한도(선택)를 정합니다. 팀 전용 기능이나 지출 한도가 필요하면 이 길을 씁니다.
단계별 순서는 빠른 시작에 있습니다.