AKOOL MCP로 Claude Code에서 AI 동영상 생성하기

Updated:

October 19, 2026

연결과 모델 확인부터 생성 프롬프트, 작업 상태 확인, 결과 저장까지 Claude Code와 AKOOL MCP의 이미지 동영상 변환 과정을 알아보세요.

Claude는 AKOOL MCP 같은 연결된 서비스를 통해 동영상 제작을 요청할 수 있습니다. 이 과정에서 Claude Code는 이미지 동영상 변환 작업을 제출하고 상태를 확인한 뒤 결과를 가져옵니다. 실제 동영상 생성은 AKOOL이 담당합니다. Claude는 작업을 설명하고 확인하며 관리하는 채팅 인터페이스를 제공합니다.

Claude에서 AI 동영상을 생성하려면 Claude 자체가 렌더링 모델이 아니라는 점을 알아야 합니다. AKOOL AI 동영상 제작 플랫폼이 Model Context Protocol 연결을 통해 생성 도구를 제공합니다.

핵심 요약

연결: AKOOL Client ID와 Client Secret으로 Claude Code에 AKOOL MCP 서버를 추가합니다.
준비: 생성 요청 전에 사용이 승인된 원본 이미지에 워크플로가 접근할 수 있는지 확인합니다.
생성: 도구와 모델을 먼저 확인한 다음 하나의video_image2video_create 작업을 제출하고 작업 식별자를 저장합니다.
저장: video_image2video_results로 기존 작업을 폴링하고 요청을 다시 제출하는 대신 완성된 동영상을 저장합니다.

Claude가 동영상을 생성할 수 있나요?
Claude Code 동영상 생성에 무엇이 필요한가요?
AKOOL MCP 서버는 어떻게 연결하나요?
이미지 동영상 변환 MCP 작업은 어떻게 실행되나요?
어떤 Claude 동영상 프롬프트를 사용해야 하나요?
AI 동영상 자동화 문제는 어떻게 해결하나요?
크레딧과 모델 선택은 어떻게 작동하나요?
자주 묻는 질문

Claude가 동영상을 생성할 수 있나요?

Claude는 MCP로 렌더링 서비스에 연결되면 동영상 생성을 시작할 수 있습니다. Claude Code가 요청을 해석하고 Model Context Protocol이 Claude와 AKOOL 도구를 연결하며, AKOOL이 실제 이미지 동영상 변환을 수행합니다. 이후 Claude가 비동기 작업을 확인하고 완성된 결과를 반환합니다.

Layer	Role	What it does
Claude Code	Client and conversational interface	Understands your instruction and invokes tools
Model Context Protocol	Connection layer	Exposes AKOOL functions as tools Claude can discover and call
AKOOL	Generation service	Runs the image-to-video job and returns its result

AKOOL 공식 MCP 문서는 현재 account_models, account_credit, video_image2video_create, video_image2video_results 등의 도구를 안내합니다. 다른 연동은 AI 동영상 생성용 MCP 서버를 참고하세요.

Claude Code 동영상 생성에 무엇이 필요한가요?

Claude Code, 유효한 API 인증 정보가 있는 AKOOL 계정, 선택한 생성에 충분한 AKOOL 크레딧, 연결된 워크플로가 접근할 수 있는 승인된 원본 이미지가 필요합니다. Claude 이용과 AKOOL 생성 비용은 별개입니다.

다음 네 가지를 준비하세요.

Claude Code. 이 가이드는 Claude Desktop이 아닌 Claude Code를 사용합니다.
AKOOL Client ID와 Client Secret. AKOOL은 MCP 인증에 x-client-id 및 x-client-secret 헤더를 사용합니다.
생성 크레딧. account_credit으로 AKOOL 잔액을 확인하세요.
승인된 원본 이미지. 소유하거나 변환 허가를 받은 이미지를 사용하세요.

적절한 원본 자료를 준비하려면 AKOOL의 이미지 동영상 변환 가이드를 참고하세요.

선명한 제품 사진은 첫 테스트에 적합합니다. 요청한 카메라 움직임이 적용돼도 제품을 알아볼 수 있는지라는 명확한 기준으로 판단할 수 있기 때문입니다.

AKOOL MCP 서버는 어떻게 연결하나요?

AKOOL 문서의 Claude Code 연결 방식을 사용하세요. 서버 엔드포인트는 https://openapi.akool.com/mcp/v1이며 x-client-id 및 x-client-secret 헤더로 인증합니다. 인증 정보를 프롬프트, 스크린샷, 저장소, 공개 문서에 포함하지 마세요.

필요하면 Claude Code를 설치하세요.

npm install -g @anthropic-ai/claude-code

그런 다음 AKOOL MCP 서버를 추가합니다. 인증 정보를 직접 적지 않는 문서 명령어의 예는 다음과 같습니다.

claude mcp add akool-mcp https://openapi.akool.com/mcp/v1 \
  --header "x-client-id: $AKOOL_CLIENT_ID" \
  --header "x-client-secret: $AKOOL_CLIENT_SECRET"

AKOOL 문서는 비밀 정보를 소스 관리에 커밋하지 말고 환경 변수에 보관할 것을 권장합니다.

연결을 확인하세요.

claude mcp list

다음과 같은 AKOOL 서버 항목이 표시되어야 합니다.

akool-mcp   http   https://openapi.akool.com/mcp/v1

최신 설정 명령어와 구성은 공식 AKOOL MCP 설정 안내를 참고하세요. 인증 정보가 스크린샷에 나타나지 않게 하세요.

이미지 동영상 변환 MCP 작업은 어떻게 실행되나요?

가장 안전한 과정은 도구 확인, 제출, 상태 확인, 결과 가져오기를 구분합니다. 새 생성은 크레딧을 소비할 수 있습니다. 기존 작업의 상태를 확인할 때는 새로 제출하지 말고 같은 작업 식별자를 사용해야 합니다.

1. 사용 가능한 도구와 모델 확인

Claude에 요청하세요.

이 세션에서 사용 가능한 AKOOL 도구를 나열해 주세요. 이미지 동영상 변환 생성 도구와 결과 도구를 찾고, 생성을 시작하지 않은 채 필요한 입력을 보여 주세요.

video_image2video_create와 video_image2video_results를 찾아야 합니다. AKOOL은 연결된 계정의 사용 가능 모델을 에이전트가 확인하도록 account_models도 제공합니다.

2. 이미지 준비

주제가 명확하고 사용 권한을 확보한 안정적인 원본 이미지를 사용하세요.

예:

/product-assets/blue-bottle-approved.png

Claude Code와 관련 도구가 실제로 접근할 수 없는 로컬 경로에 의존하지 마세요.

3. 제출 전에 계획

Claude에 요청하세요.

승인된 제품 이미지를 원본으로 사용하세요. 제품은 정지한 채 카메라가 천천히 다가가는 짧은 영상을 계획해 주세요. 제출 전에 제안 모델, 지원 설정, 확인 가능한 비용 정보를 보여 주세요.

이 단계는 계획입니다. 유료 생성을 시작하면 안 됩니다.

4. 작업 하나 제출

제안을 확인한 뒤 요청하세요.

합의한 이미지 동영상 변환 요청을 한 번만 제출하세요. 부드러운 카메라 움직임을 사용하고 제품은 정지시킨 채 작업 식별자를 반환해 주세요.

AKOOL 문서는 video_image2video_create를 생성 도구로 안내합니다.

반환된 식별자를 즉시 저장하세요.

Task ID: [SAVED_TASK_ID]

5. 같은 작업 폴링

다음과 같이 요청하세요.

저장한 식별자로 기존 작업을 확인하세요. 대기, 처리 중, 완료, 실패 중 어떤 상태인지 알려 주세요. 새 작업은 생성하지 마세요.

AKOOL은 여러 MCP 도구가 비동기로 작동하며 결과 도구로 완료 여부를 폴링한다고 설명합니다.

6. 결과 저장

완료 후 요청하세요.

완성된 동영상 링크와 저장 위치를 반환하고 원본 이미지와 비교해 주세요. 원래 결과를 유지하면서 다음 시도에 적용할 움직임 변경 한 가지를 제안해 주세요.

간단한 작업 수명 주기는 다음과 같습니다.

account_models
      ↓
video_image2video_create
      ↓
[SAVED_TASK_ID]
      ↓
video_image2video_results
      ↓
queued → processing → complete
      ↓
[RESULT_URL]

어떤 Claude 동영상 프롬프트를 사용해야 하나요?

작업 상태를 명시하는 프롬프트를 사용하세요. 안전 측면의 핵심은 세션을 확인하기만 하는 지시인지, 새 유료 생성을 만드는 지시인지 구분하는 것입니다.

Prompt	What it does	New generation?
1. Discovery	Inspects tools and required inputs	No
2. Planning	Reviews model/settings before submission	No
3. Generation	Submits the image-to-video task	Yes
4. Status	Checks the saved task	No
5. Save and revise	Retrieves output and proposes a revision	No, unless you approve another run

프롬프트 1: 도구 확인

이 세션에서 사용 가능한 AKOOL 도구를 나열해 주세요. 이미지 동영상 변환 생성 도구와 결과 도구를 찾고, 생성을 시작하지 않은 채 필요한 입력을 보여 주세요.

프롬프트 2: 계획

승인된 제품 이미지를 원본으로 사용하세요. 제품은 정지한 채 카메라가 천천히 다가가는 짧은 영상을 계획해 주세요. 제출 전에 제안 모델, 지원 설정, 확인 가능한 비용 정보를 보여 주세요.

프롬프트 3: 생성

합의한 이미지 동영상 변환 요청을 한 번만 제출하세요. 부드러운 카메라 움직임을 사용하고 제품은 정지시킨 채 작업 식별자를 반환해 주세요.

프롬프트 4: 상태

저장한 식별자로 기존 작업을 확인하세요. 대기, 처리 중, 완료, 실패 중 어떤 상태인지 알려 주세요. 새 작업은 생성하지 마세요.

프롬프트 5: 저장과 수정

완성된 동영상 링크와 저장 위치를 반환하고 원본 이미지와 비교해 주세요. 원래 결과를 유지하면서 다음 시도에 적용할 움직임 변경 한 가지를 제안해 주세요.

이 Claude 동영상 프롬프트는 계획과 실행을 의도적으로 분리합니다. 실수로 두 번 제출하면 추가 크레딧이 소모되는 모든 AI 동영상 자동화 과정에 유용합니다.

AI 동영상 자동화 문제는 어떻게 해결하나요?

다시 제출하기 전에 현재 작업과 연결 상태부터 확인하세요. 많은 실패는 인증, 파일 접근, 비동기 상태 문제이며 새 생성을 만들어야 한다는 뜻이 아닙니다.

Symptom	First check	Next action
AKOOL tools are missing	`claude mcp list`	Recheck MCP setup and restart Claude Code
Authentication fails	Client ID and secret	Verify credentials in AKOOL dashboard
`401 Unauthorized`	MCP headers	Replace invalid credentials
Source image cannot be used	File accessibility	Move or upload the asset somewhere the workflow can access
Job stays queued	Saved task ID	Poll the same job later
Result says failed	Existing result response	Read the failure before changing inputs
No download available	Job status	Confirm task is actually complete
Download link expired	Stored output/state	Retrieve a fresh available result rather than blindly regenerate
Two jobs appear	Task history	Confirm whether generation was submitted twice

AKOOL은 401 Unauthorized가 발생하면 계정 인증 정보를 확인하라고 명시합니다.

크레딧과 모델 선택은 어떻게 작동하나요?

AKOOL 웹사이트의 모든 모델을 현재 MCP 작업에서 쓸 수 있다고 가정하지 말고 연결된 계정의 모델 및 크레딧 도구를 사용하세요. 모델 가용성은 계정과 도구 스키마에 달려 있고 생성 비용은 모델 및 설정에 따라 달라질 수 있습니다.

다음을 사용하세요.

account_models로 사용 가능한 모델을 확인합니다.
account_credit으로 현재 크레딧 잔액을 확인합니다.
가능하면 이미지 동영상 변환 도구가 반환하는 설정이나 견적으로 대기 중인 작업을 파악합니다.

AKOOL의 일반 Image-to-Video 화면도 모델별 가격이 다르다고 안내합니다.

한 API 응답에서 차감된 크레딧을 Claude Code 동영상 생성의 보편적인 비용으로 공개하지 마세요. 모델, 해상도, 길이, 계정, 현재 가격은 달라질 수 있습니다.

AKOOL의 기본 플랫폼이 더 넓은 모델 목록을 제공하더라도 모든 MCP 과정에서 모든 모델을 쓸 수 있다는 증거는 아닙니다.

Claude Code로 첫 동영상 생성하기

유용한 흐름은 간단합니다. 확인 → 계획 → 한 번 제출 → 작업 ID 저장 → 폴링 → 결과 가져오기.

이렇게 하면 MCP 동영상 생성 과정을 더 쉽게 점검하고 상태 확인을 두 번째 유료 생성과 혼동할 위험을 줄일 수 있습니다.

같은 생성 기능을 직접 살펴보려면 AKOOL의 AI 동영상 제작 플랫폼을 여세요. 설정은 공식 AKOOL MCP 문서를 참고하세요.

자주 묻는 질문

저희와 함께 하세요!

구독하여 새로운 팁, 사용 방법, 뉴스 등에 대한 최신 정보를 받아보세요!

고맙습니다!제출이 접수되었습니다!

죄송합니다!양식을 제출하는 중에 문제가 발생했습니다.

AKOOL Content Team

자세히 알아보기

참고 문헌

좋아할지도 몰라요

항목을 찾을 수 없습니다.

AKOOL Content Team

저희와 함께 하세요!

구독하여 새로운 팁, 사용 방법, 뉴스 등에 대한 최신 정보를 받아보세요!

고맙습니다!제출이 접수되었습니다!

죄송합니다!양식을 제출하는 중에 문제가 발생했습니다.

AKOOL MCP로 Claude Code에서 AI 동영상 생성하기

핵심 요약

목차

Claude가 동영상을 생성할 수 있나요?

Claude Code 동영상 생성에 무엇이 필요한가요?

AKOOL MCP 서버는 어떻게 연결하나요?

이미지 동영상 변환 MCP 작업은 어떻게 실행되나요?

1. 사용 가능한 도구와 모델 확인

2. 이미지 준비

3. 제출 전에 계획

4. 작업 하나 제출

5. 같은 작업 폴링

6. 결과 저장

어떤 Claude 동영상 프롬프트를 사용해야 하나요?

프롬프트 1: 도구 확인

프롬프트 2: 계획

프롬프트 3: 생성

프롬프트 4: 상태

프롬프트 5: 저장과 수정

AI 동영상 자동화 문제는 어떻게 해결하나요?

크레딧과 모델 선택은 어떻게 작동하나요?

Claude Code로 첫 동영상 생성하기

저희와 함께 하세요!

저희와 함께 하세요!