Wan 3.0 로고Wan 3.0

MCP 서버

AI 에이전트로 동영상 만들기

명령어 한 줄로 Codex, Claude Code, Grok CLI를 Wan 3.0에 연결하세요. 브라우저에서 한 번 승인한 뒤 원하는 영상을 말로 설명하면, 에이전트가 생성을 시작하고 렌더링을 기다렸다가 MP4를 건네줍니다.

명령어 받기API 문서
codex mcp add wan3 --url https://wan3.video/mcp실제 녹화 화면입니다. 명령어 한 줄, 브라우저에서 클릭 한 번, 그리고 5초 720P 동영상. 기다리는 구간은 빠르게 재생됩니다.

명령어 한 줄로 설치

복사할 키가 없습니다. 사용하는 에이전트의 명령어를 실행한 뒤, 브라우저에서 wan3.video에 로그인하고 허용을 누르세요.

Codex
codex mcp add wan3 --url https://wan3.video/mcp

브라우저가 바로 열립니다. 허용을 누른 다음 codex를 실행해 동영상을 요청하세요.

Claude Code
claude mcp add --scope user --transport http wan3 https://wan3.video/mcp

Claude Code를 실행하고 /mcp를 입력한 뒤 wan3를 골라 Authenticate를 선택하세요.

Grok CLI
grok mcp add --transport http wan3 https://wan3.video/mcp

grok을 실행하고 /mcps를 입력한 뒤 wan3를 선택하고 i를 누르세요.

이용 방법

  1. wan3 추가

    명령어가 서버 주소 https://wan3.video/mcp를 에이전트 설정에 저장합니다.

  2. 브라우저에서 허용

    wan3.video에 로그인하고 허용을 누르세요. 에이전트는 자기 이름이 붙은 전용 API 키를 받으며, 이 키는 언제든 폐기할 수 있습니다.

  3. 동영상 요청

    원하는 장면을 설명하세요. 에이전트가 생성을 시작하고 MP4가 준비될 때까지 확인하며, 보통 몇 분이면 끝납니다.

동영상은 웹사이트와 같은 가격으로 크레딧이 차감되며, 생성에 실패하면 크레딧이 자동으로 환불됩니다. 요금 안내를 확인하세요.

에이전트가 할 수 있는 일

REST API와 같은 작업을 하는 도구 6개입니다. 크레딧을 쓰는 도구는 generate_video뿐입니다.

MCP 도구
get_account무료크레딧 잔액, 멤버십, 렌더링 중인 동영상 수를 확인합니다.
list_models무료모델별 해상도, 길이, 5초당 크레딧을 보여줍니다.
generate_video크레딧 사용내 크레딧으로 텍스트-동영상, 이미지-동영상, 동영상 편집을 시작합니다.
get_video무료렌더링을 최대 45초 기다리고, 끝나면 다운로드 링크를 돌려줍니다.
list_videos무료내 동영상을 최신순으로 보여줍니다.
create_upload무료로컬 이미지나 동영상 업로드를 준비하고 바로 실행할 수 있는 curl 명령어를 돌려줍니다.

API 키로 연결하기

CI 작업이나 브라우저가 없는 머신에서는 API 키 페이지에서 키를 만들어 WAN3_API_KEY로 내보낸 뒤, 그 키로 서버를 추가하세요.

Codex
codex mcp add wan3 --url https://wan3.video/mcp \
  --bearer-token-env-var WAN3_API_KEY
Claude Code
claude mcp add --scope user --transport http wan3 https://wan3.video/mcp \
  --header "Authorization: Bearer $WAN3_API_KEY"
Grok CLI
grok mcp add --transport http wan3 https://wan3.video/mcp \
  --header "Authorization: Bearer $WAN3_API_KEY"

Codex는 시작할 때마다 환경 변수에서 키를 읽습니다. Claude Code와 Grok CLI는 펼쳐진 키를 각자의 설정 파일에 저장하므로, 이 파일들도 키처럼 안전하게 보관하세요.

자주 묻는 질문

어떤 AI 에이전트가 Wan 3.0을 쓸 수 있나요?

Streamable HTTP로 원격 서버에 연결하는 MCP 클라이언트라면 모두 가능합니다. Codex, Claude Code, Grok CLI는 브라우저로 로그인해 승인하고, 다른 클라이언트는 Authorization 헤더에 API 키를 담아 https://wan3.video/mcp에 연결하면 됩니다.

비용은 어떻게 되나요?

연결은 무료입니다. 동영상마다 웹사이트와 같은 크레딧이 차감됩니다. 에이전트는 list_models로 가격을 확인할 수 있고, 생성에 실패하면 크레딧이 자동으로 환불됩니다.

에이전트가 내 계정으로 무엇을 할 수 있나요?

내 크레딧으로 동영상을 생성하고, 동영상과 잔액, 멤버십을 확인하고, 생성에 쓸 파일을 업로드할 수 있습니다. 결제 정보는 볼 수 없고 요금제도 바꿀 수 없습니다. 자동 충전을 켜 두었다면 웹사이트에서 쓸 때와 마찬가지로 에이전트의 사용도 충전을 일으킬 수 있습니다.

내 이미지로 동영상을 만들 수 있나요?

네. 로컬 이미지를 움직이게 해 달라고 요청하면, 에이전트가 create_upload를 호출하고 돌려받은 curl 명령어로 파일을 올린 뒤 이미지-동영상 생성을 시작합니다.

만든 동영상은 어디에 있나요?

에이전트가 만든 동영상은 모두 wan3.video의 기록에도 나타납니다. 바로 받을 수 있는 MP4 링크가 있으면 에이전트가 그 링크를 주고, 없으면 기록 페이지로 안내해 그곳에서 보고 다운로드할 수 있습니다.

에이전트 연결은 어떻게 끊나요?

API 키 페이지에서 해당 키를 폐기하세요. 키에는 “Codex · MCP”처럼 에이전트 이름이 붙어 있습니다. 에이전트에서 서버까지 지우려면 codex mcp remove wan3, claude mcp remove --scope user wan3, grok mcp remove wan3 중 하나를 실행하세요.

다음 동영상은 한 문장이면 됩니다

에이전트에 wan3를 추가하거나, 같은 모델로 브라우저에서 직접 만들어 보세요.

명령어 받기브라우저에서 만들기