한눈에 보기
Claude Code에서 Mage를 사용하려면 Mage MCP 서버(https://mcp.mage.space/mcp)를 추가하고 Mage 계정으로 로그인하세요. 그러면 Claude Code가 Mango 3로 이미지를, Cherry 2 Pro로 영상을, Seed Audio로 오디오를 생성할 수 있고, 직접 지정한 28개 Mage 모델 중 어떤 것이든 사용할 수 있습니다. 비용은 생성할 때마다 Gems로 결제됩니다.
16
MCP 도구
28
이미지·동영상·오디오 모델
5
지원하는 어시스턴트
$0
연결하려면
설정
Mage를 Claude Code에 연결하는 방법
Mage 계정이 필요해요. 게스트 세션으로는 앱을 연결할 수 없어요.
서버 추가하기
터미널에서 이 명령어를 실행하세요.
claude mcp add --transport http mage https://mcp.mage.space/mcp인증하기
Claude Code에서 /mcp를 실행하고 mage를 선택한 다음 인증하세요. 브라우저 페이지가 열리면 Mage에 로그인하고 연결을 선택하면 됩니다.
또는 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 어시스턴트 어디에서나 사용할 수 있어요
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 같은 헤드리스 환경에서만 선택적으로 사용하면 됩니다.
비용은 얼마인가요?
연결은 무료예요. 어시스턴트가 시작하는 생성은 모델에 표시된 가격만큼 Mage 계정의 Gems로 결제되며, 어시스턴트가 시작하기 전에 estimate_cost로 가격을 알려 줄 수 있어요.
어시스턴트는 어떤 모델을 사용하나요?
모델을 따로 지정하지 않으면 어시스턴트는 이미지는 Mango 3, 영상은 Cherry 2 Pro, 오디오는 Seed Audio로 만들어요. 다른 Mage 모델도 이름을 말하면 사용할 수 있어요.
Mage 계정을 연결해도 안전한가요?
Mage는 어떤 정보가 공유되기 전에 앱 이름, 사이트, 돌아갈 위치를 보여 주고, 각 연결은 사용자가 직접 승인해요. 연결된 앱은 언제든 MCP → 연결된 앱에서 해제할 수 있어요.
Mage로 지금 시작하세요
계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.