본문으로 건너뛰기

Claude Code용 Mage

Claude Code에서 이미지, 영상, 오디오 생성하기

터미널과 에디터의 Claude Code에 Mage를 연결하고 쉬운 말로 이미지, 영상, 오디오를 요청해 보세요. Claude Code가 모델을 고르고, 가격을 알려 주고, 결과물을 가져다줍니다.

https://mcp.mage.space/mcp

한눈에 보기

Claude Code에서 Mage를 사용하려면 Mage MCP 서버(https://mcp.mage.space/mcp)를 추가하고 Mage 계정으로 로그인하세요. 그러면 Claude Code가 Mango 4로 이미지를, Cherry 2 Pro로 동영상을, Seed Audio로 오디오를 만들 수 있고, 이름만 말하면 37개 Mage 모델 중 어떤 것이든 사용할 수 있어요. 생성할 때마다 Gems로 결제돼요.

  • 16MCP 도구
  • 37이미지·동영상·오디오 모델
  • 5지원하는 어시스턴트
  • $0연결하려면

설정

Mage를 Claude Code에 연결하는 방법

Mage 계정이 필요해요. 게스트 세션으로는 앱을 연결할 수 없어요.

  1. 서버 추가하기

    터미널에서 이 명령어를 실행하세요.

    claude mcp add --transport http mage https://mcp.mage.space/mcp
  2. 인증하기

    Claude Code에서 /mcp를 실행하고 mage를 선택한 다음 인증하세요. 브라우저 페이지가 열리면 Mage에 로그인하고 연결을 선택하면 됩니다.

  3. 또는 API 키 사용하기

    브라우저 로그인을 건너뛰려면 헤더에 키를 넣어 서버를 추가하세요.

    claude mcp add --transport http mage https://mcp.mage.space/mcp \
      --header "Authorization: Bearer $MAGE_API_KEY"

사용해 보기

Claude Code에서 Mage를 쓰는 프롬프트 예시

  • 이 블로그 글에 쓸 1200×630 Open Graph 이미지를 생성해서 public/og.png로 저장해 줘.
  • 우리 브랜드 색상으로 랜딩 페이지의 세 섹션에 들어갈 히어로 일러스트를 만들어 줘.
  • assets/demo.mp4를 업로드해서 수채화 애니메이션 스타일로 바꿔 줘.
  • 홈페이지 배경으로 쓸 5초짜리 반복 재생 영상을 만들어 줘.

도구

어시스턴트가 호출할 수 있는 16가지 도구

도구기능
list_models추천 모델을 가격, 용도별 강점, 단점과 함께 보여 줍니다.
get_model모델 하나의 입력 항목, 허용 값, 기본값, 규칙, 가격을 설명합니다.
estimate_cost생성을 시작하기 전에 가격을 계산합니다. 요금은 청구되지 않습니다.
create_upload명령을 실행할 수 있는 어시스턴트가 로컬 파일을 업로드할 수 있도록 서명된 링크를 받아옵니다.
generate이미지, 동영상 또는 오디오 생성을 시작합니다.
get_request생성이 끝날 때까지 기다린 뒤 결과 링크를 돌려줍니다.
cancel_request진행 중인 생성을 중지합니다.
get_account연결된 계정과 Gems 잔액을 보여 줍니다.
list_characters저장한 캐릭터와 @handle 목록을 보여 줍니다.
create_character이미지로 비공개 캐릭터를 저장합니다. 원하면 음성도 함께 저장할 수 있습니다.
delete_character내 캐릭터 하나를 삭제합니다.
list_references저장한 의상, 포즈, 장소, 사물, 음성 클립 목록을 보여 줍니다.
create_reference이미지 또는 오디오 링크로 비공개 레퍼런스를 저장합니다.
delete_reference내 레퍼런스 하나를 삭제합니다.
list_history앱에서 만든 것을 포함해 최근 30일간의 생성 내역을 보여 줍니다.
search_creations저장한 작품을 담긴 내용, 컬렉션, 날짜로 검색합니다.

더 많은 어시스턴트

Mage는 주요 AI 어시스턴트 어디에서나 사용할 수 있어요

  • Claude에서 Mage 사용하기

    웹, 데스크톱 앱, 모바일 앱, Cowork의 Claude에서 이미지, 영상, 오디오를 생성하세요.

  • ChatGPT에서 Mage 사용하기

    개인 MCP 앱으로 ChatGPT에서 이미지, 영상, 오디오를 생성하세요.

  • Grok의 Mage

    Grok에서 커스텀 커넥터로 이미지, 영상, 오디오를 생성해 보세요.

  • Cursor의 Mage

    Cursor 에이전트 모드에서 이미지, 영상, 오디오를 생성해 보세요.

FAQ

자주 묻는 질문

Claude Code로 프로젝트에 쓸 이미지를 생성할 수 있나요?
네. Mage MCP 서버를 사용하면 Claude Code가 이미지, 영상, 오디오를 생성하고 결과물을 저장소에 바로 다운로드할 수 있습니다. create_upload로 편집할 클립 같은 프로젝트 파일을 업로드할 수도 있습니다.
Claude Code에서는 OAuth와 API 키 중 무엇을 써야 하나요?
둘 다 가능합니다. OAuth는 브라우저로 로그인하므로 셸에 시크릿을 둘 필요가 없습니다. API 키는 CI나 헤드리스 환경에 알맞으며, Authorization: Bearer 헤더로 전달하세요.
Mage MCP 서버는 무엇인가요?
https://mcp.mage.space/mcp의 원격 Model Context Protocol 서버로, AI 어시스턴트가 내 Mage 계정으로 이미지, 영상, 오디오를 생성할 수 있게 해 줍니다. 어시스턴트는 도구 16개로 모델 선택, 가격 확인, 생성, 결과 대기를 하고 저장된 캐릭터, 레퍼런스, 기록도 사용할 수 있습니다.
MCP 서버를 사용하려면 API 키가 필요한가요?
아니요. Claude, ChatGPT, Grok, Cursor, Claude Code는 OAuth로 Mage에 로그인하면 바로 연결됩니다. API 키는 CI 같은 헤드리스 환경에서만 선택적으로 사용하면 됩니다.
비용은 얼마인가요?
연결은 무료이며, 먼저 계정에서 Gem 팩이나 플랜 중 하나로 결제를 한 번 완료해야 해요. 가입 보너스 Gem은 Mage 앱에서만 사용할 수 있어요. 어시스턴트가 시작하는 생성은 건마다 모델의 표시 가격대로 Mage 계정의 Gem으로 결제돼요. 어시스턴트는 시작하기 전에 estimate_cost로 가격을 알려줄 수 있어요.
어시스턴트는 어떤 모델을 사용하나요?
모델을 지정하지 않으면 어시스턴트가 이미지는 Mango 4, 영상은 Cherry 2 Pro, 오디오는 Seed Audio로 만들어요. 다른 Mage 모델도 이름으로 요청하면 쓸 수 있어요.
Mage 계정을 연결해도 안전한가요?
Mage는 어떤 정보가 공유되기 전에 앱 이름, 사이트, 돌아갈 위치를 보여 주고, 각 연결은 사용자가 직접 승인해요. 연결된 앱은 언제든 MCP → 연결된 앱에서 해제할 수 있어요.

Mage로 지금 시작하세요

계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.

Characters커뮤니티