Claude Code·Cursor·VS Code에서 이미지·동영상 만들기

모든 제품은 디자이너가 생기기 전부터 그림이 필요해요. 랜딩 페이지의 히어로 이미지, 빈 상태 화면, 시드 데이터베이스용 아바타, README용 데모 클립, 온보딩 흐름의 음성 안내까지요. 코딩 에이전트는 그 파일들이 어디에 들어가야 하는지 이미 알고 있어요. eroq의 MCP 서버를 연결하면 직접 만들 수도 있어요. 스튜디오와 같은 모델, 같은 크레딧 가격이고, 설정 파일에 API 키를 넣어 둘 필요도 없어요.

Claude Code

명령어 하나면 돼요.

claude mcp add --transport http eroq https://eroq.ai/mcp

--scope user를 붙이면 모든 프로젝트에서 eroq를 쓸 수 있어요. 그다음 Claude Code 세션에서 /mcp를 입력하고 eroq를 선택한 뒤 Authenticate(인증)를 고르세요. 브라우저에서 eroq가 열리면 로그인하고 Allow(허용)를 클릭하세요. Claude Code는 전용 키를 저장하고, 이 키는 대시보드에 Claude Code (connected)라는 이름으로 표시돼요.

플러그인이 더 편한가요? eroq는 자체 사이트에서 Claude Code 마켓플레이스를 제공해요.

/plugin marketplace add https://eroq.ai/claude-code/marketplace.json
/plugin install eroq@eroq

플러그인은 같은 서버와 함께, Claude Code에게 eroq 사용법을 가르치는 스킬도 선언해요. 크레딧을 쓰기 전에 list_models를 확인할 것, 동영상이 끝났다고 가정하지 말고 상태를 폴링할 것, 서명된 링크가 만료되기 전에 내려받을 것 같은 내용이요. 그래서 세션마다 일일이 설명할 필요가 없어요.

Cursor

eroq의 Cursor 페이지에서 Cursor에 추가를 누르고 확인하세요. 서버가 MCP 설정에 ‘Needs login’(로그인 필요) 표시와 함께 추가돼요. 그걸 클릭하고 eroq에 로그인한 다음 Allow를 누르면 끝이에요. 같은 설정을 ~/.cursor/mcp.json에 직접 쓴다면 URL 하나뿐이에요.

{ "mcpServers": { "eroq": { "url": "https://eroq.ai/mcp" } } }

VS Code

eroq의 VS Code 페이지에서 VS Code에 설치를 누르면 서버가 등록돼요. VS Code가 물어보면 서버를 시작하고 브라우저에서 로그인하세요. Copilot Chat의 에이전트 모드 도구 목록에 나타나요. 워크스페이스용 설정은 이래요.

{ "servers": { "eroq": { "type": "http", "url": "https://eroq.ai/mcp" } } }

무엇을 요청할까

에이전트는 막연한 요청을 제대로 된 호출로 바꾸는 데 능해요. 잘 통하는 예시 몇 가지를 소개할게요. 한국어로 요청해도 똑같이 작동해요.

Generate a 16:9 hero image for the pricing page: a calm desk at dawn, soft
window light, lots of negative space on the left for the headline. Save it
to public/images/pricing-hero.png.

Make 8 square avatars for the seed users in db/seed.ts — varied faces,
neutral studio background, photographic. Name the files after the usernames.

Record the onboarding line "Welcome back — your drafts are where you left
them" with a warm voice, and put the MP3 in assets/audio/.

그림은 링크와 함께 에이전트에게 돌아오고, 에이전트가 파일을 저장소에 내려받아요. 링크는 서명되어 있고 30분 뒤에 만료돼요. 그래서 플러그인의 스킬이 Claude Code에게 바로 저장하라고 알려 주는 거예요. 모든 렌더는 eroq 라이브러리에도 남아요.

채팅 없이 파일만 다루는 작업이라면, eroq CLI가 렌더를 디스크에 바로 써 주는 로컬 MCP 서버를 실행해요. npx -y @eroq/cli mcp(EROQ_API_KEY를 읽어요). Codex CLI는 이 방식으로 써요.

비용

스튜디오와 같은 가격이고, 같은 지갑에서 차감돼요.

• Krea 2 이미지 1장에 10 크레딧(레퍼런스 사진을 최대 10장까지 받는 Eroq One은 20 크레딧).
• 5초짜리 Seedance 2.0 Mini 클립에 45 크레딧.
• Voice One 음성 100자당 3 크레딧.
• enhance_prompt, list_models, 상태 확인, 모든 조회: 무료.

실패한 렌더는 자동으로 환불돼요. 에이전트가 생성을 반복하며 루프에 빠지더라도, 키별 요청 한도와 워크스페이스의 월간 크레딧 상한(대시보드에서 멤버별로 설정)이 브레이크 역할을 해요.

키와 보안

• 클라이언트마다 로그인을 통해 앱 이름이 붙은 전용 키를 받고, 개발자 → API 키에서 폐기할 수 있어요. 실수로 커밋될 키가 없어요.
• 같은 앱을 다시 연결하면 키가 추가되는 게 아니라 교체돼요.
• 고정 키가 필요한 스크립트는 여전히 Authorization: Bearer eroq_sk_…를 보낼 수 있어요. 스크립트용 전용 키를 따로 만드세요.

자주 묻는 질문

에이전트가 자기가 생성한 이미지를 볼 수 있나요?

네. generate_image는 링크와 함께 그림 자체를 돌려주기 때문에, 에이전트가 다음으로 넘어가기 전에 요청 내용과 맞는지 확인할 수 있어요.

README 데모용 동영상도 만들 수 있나요?

클립 생성을 시작할 수 있어요. 렌더에 1~5분이 걸리기 때문에, 에이전트가 get_video_status를 폴링하다가 MP4가 완성되면 내려받아요.

Claude, ChatGPT 커넥터와는 다른가요?

서버와 도구는 같아요. 차이는 결과물이 가는 곳이에요. 코딩 에이전트에서는 결과물이 프로젝트 안의 파일이 돼요.

원클릭 버튼은 모두 eroq.ai/mcp에 있어요.