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 계정이 필요해요. 게스트 세션으로는 앱을 연결할 수 없어요.
서버 추가하기
터미널에서 이 명령어를 실행하세요.
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 어시스턴트 어디에서나 사용할 수 있어요
Claude에서 Mage 사용하기
웹, 데스크톱 앱, 모바일 앱, Cowork의 Claude에서 이미지, 영상, 오디오를 생성하세요.
ChatGPT에서 Mage 사용하기
개인 MCP 앱으로 ChatGPT에서 이미지, 영상, 오디오를 생성하세요.
Grok의 Mage
Grok에서 커스텀 커넥터로 이미지, 영상, 오디오를 생성해 보세요.
Cursor의 Mage
Cursor 에이전트 모드에서 이미지, 영상, 오디오를 생성해 보세요.
FAQ
자주 묻는 질문
Claude Code로 프로젝트에 쓸 이미지를 생성할 수 있나요?
Claude Code에서는 OAuth와 API 키 중 무엇을 써야 하나요?
Mage MCP 서버는 무엇인가요?
MCP 서버를 사용하려면 API 키가 필요한가요?
비용은 얼마인가요?
어시스턴트는 어떤 모델을 사용하나요?
Mage 계정을 연결해도 안전한가요?
Mage로 지금 시작하세요
계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.