GenPresso MCP
Claude·ChatGPT 같은 AI 어시스턴트를 GenPresso에 연결하세요. 대화하던 창에서 바로 이미지·영상을 생성하고, 결과물은 GenPresso 캔버스에 쌓여 스튜디오에서 이어서 편집할 수 있습니다.
MCP 연동이란?
MCP(Model Context Protocol)는 AI 어시스턴트가 외부 서비스를 '도구'로 쓰게 해 주는 공개 표준입니다. GenPresso MCP 서버를 연결하면, 쓰던 AI 채팅 안에서 GenPresso의 생성 기능을 자연어로 부릴 수 있습니다.
- 대화로 생성 — "골목을 걷는 소녀 이미지를 만들어 줘"라고 말하면 어시스턴트가 GenPresso 도구를 호출합니다.
- 결과는 캔버스로 — 생성물이 GenPresso 캔버스에 노드로 추가되어, 스튜디오에서 업스케일·편집·타임라인 작업을 이어갈 수 있습니다.
- API 키 없음 — 연결할 때 브라우저에서 GenPresso 계정으로 한 번 로그인하면 끝입니다. 크레딧도 그 계정에서 차감됩니다.
Claude에 연결하기
claude.ai(웹)와 Claude Desktop은 커스텀 커넥터로 연결합니다. 커넥터 기능이 제공되는 플랜이어야 합니다.
- ① Claude 설정(Settings) → 커넥터(Connectors)로 이동합니다.
- ② '커스텀 커넥터 추가(Add custom connector)'를 누르고 이름에 GenPresso, URL에 아래 주소를 입력합니다.
- ③ 브라우저 창이 열리면 GenPresso 계정으로 로그인하고 연결을 승인합니다.
- ④ 대화에서 도구 아이콘에 GenPresso가 보이면 완료 — "GenPresso로 노을 지는 바다 이미지를 만들어 줘"처럼 바로 요청하세요.
https://genpresso.ai/api/mcpClaude Code(터미널)에서는 명령 한 줄로 추가합니다. 첫 도구 호출 때 브라우저 로그인이 열립니다.
claude mcp add --transport http genpresso https://genpresso.ai/api/mcpChatGPT에 연결하기
- ① ChatGPT 설정 → 커넥터(Connectors)에서 개발자 모드(Developer mode)를 켭니다.
- ② '만들기(Create)'로 새 커넥터를 추가하고, MCP 서버 URL에 위와 같은 주소를 입력합니다.
- ③ 인증 방식은 OAuth를 선택하고, 안내에 따라 GenPresso 계정으로 로그인·승인합니다.
- ④ 대화에서 커넥터를 켜고 GenPresso 도구를 요청하면 됩니다.
로그인과 보안
연결은 OAuth 2.1 표준으로 동작합니다. 커넥터를 추가하면 브라우저에서 GenPresso 로그인·동의 화면이 열리고, 승인하면 클라이언트가 접근 토큰을 받아 보관합니다. API 키를 발급받거나 붙여넣을 일이 없습니다.
- 토큰은 해시로만 저장됩니다 — GenPresso 서버에 원문 토큰이 남지 않습니다.
- 접근 토큰은 1시간, 갱신 토큰은 30일 유효하며 클라이언트가 자동으로 갱신합니다.
- 연결을 끊으려면 클라이언트(Claude/ChatGPT)에서 커넥터를 삭제하세요. 갱신 토큰은 만료 후 재로그인 전까지 다시 쓸 수 없습니다.
제공 도구
연결된 어시스턴트가 쓸 수 있는 도구는 다음과 같습니다. 보통은 도구 이름을 직접 부를 필요 없이, 원하는 결과를 말하면 어시스턴트가 알아서 조합해 호출합니다.
| 도구 | 설명 |
|---|---|
| get_credit_balance | 현재 크레딧 잔액 조회 |
| list_models | 사용 가능한 이미지·영상 모델 목록 |
| list_canvases | 내 캔버스(프로젝트) 목록 |
| create_canvas | 새 캔버스 만들기 |
| generate_image | 캔버스에 이미지 생성 — 베이스 이미지·참조 이미지(asset_id) 입력 지원 |
| generate_video | 캔버스에 영상 생성 — 시작 프레임·참조 이미지(asset_id) 입력 지원 |
| check_generation | 생성 작업 상태·결과 확인 — 이미지 결과는 썸네일 미리보기 동봉 |
| jobs_wait | 여러 생성 작업의 완료를 서버에서 대기(폴링 불필요) |
| list_assets | 생성 자산 목록 — 영구 asset_id + 다운로드 URL |
| get_asset | 자산 다운로드 URL 재발급 + 이미지 미리보기 |
크레딧과 한도
- 생성 비용은 스튜디오에서 직접 생성할 때와 동일하며, 로그인한 본인 계정의 크레딧에서 차감됩니다.
- 생성이 실패하면 차감된 크레딧은 자동으로 환불됩니다.
- 남용 방지를 위해 생성 요청은 분당 30회로 제한되고, 플랜별 동시 실행 상한이 함께 적용됩니다.
- 잔액은 대화에서 get_credit_balance로 물어보거나 스튜디오 우측 상단에서 확인할 수 있습니다.
결과물은 캔버스로
MCP로 만든 생성물은 항상 캔버스 위의 노드로 만들어집니다. 어시스턴트가 기존 캔버스 목록에서 고르거나 새 캔버스를 만든 뒤 거기에 생성하며, 응답에 포함된 링크로 해당 캔버스를 바로 열 수 있습니다.
- 생성은 비동기입니다 — 어시스턴트가 jobs_wait/check_generation으로 완료를 확인해 알려 줍니다(영상은 수 분 걸릴 수 있습니다).
- 캔버스를 열어 두었다면 완료 시 자동으로 반영되고, 나중에 열어도 결과가 채워져 있습니다.
- 만들어진 노드는 일반 노드와 동일합니다 — 업스케일 버튼, @요소 참조, 타임라인 배치 모두 그대로 쓸 수 있습니다.
- 다운로드 URL은 genpresso.ai 도메인에서 제공됩니다 — 이그레스 허용목록이 있는 환경(에이전트 샌드박스·사내망)에서는 genpresso.ai 하나만 허용하면 됩니다.
문제 해결
- 연결 실패·인증 오류(401): 클라이언트에서 커넥터를 삭제하고 다시 추가해 재로그인하세요.
- 도구가 목록에 안 보임: 클라이언트를 재시작하거나 커넥터를 껐다 켜 보세요.
- 생성이 오래 걸림: 정상일 수 있습니다 — 영상 모델은 수 분이 걸립니다. 어시스턴트에게 상태 확인을 요청하세요.
- 크레딧 부족 오류: 스튜디오의 요금제·충전 페이지에서 크레딧을 충전한 뒤 다시 시도하세요.
코드에서 직접 호출하는 REST API가 필요하다면 API 문서를 참고하세요(우측 상단 버튼). 그 밖의 문의는 푸터의 고객센터로 보내 주시면 됩니다.