한눈에 보기
Cursor에서 Mage를 사용하려면 Mage MCP 서버(https://mcp.mage.space/mcp)를 추가하고 Mage 계정으로 로그인하세요. 그러면 Cursor가 Mango 3로 이미지를, Cherry 2 Pro로 영상을, Seed Audio로 오디오를 생성할 수 있어요. 직접 지정한 28개 Mage 모델 중 무엇이든 쓸 수 있고, 생성할 때마다 Gems로 결제돼요.
16
MCP 도구
28
이미지·동영상·오디오 모델
5
지원하는 어시스턴트
$0
연결하려면
설정
Mage를 Cursor에 연결하는 방법
Mage 계정이 필요해요. 게스트 세션으로는 앱을 연결할 수 없어요.
클릭 한 번으로 설치
"Cursor에 Mage 추가"를 선택하면 공개 OAuth 클라이언트 ID와 함께 서버가 설치돼요. Mage가 이미 설치되어 있다면 기존 설정을 교체하세요.
또는 mcp.json에 추가
수동으로 설정하려면 ~/.cursor/mcp.json에 아래 항목을 추가하세요. 클라이언트 ID는 공개 값이라 시크릿이 필요 없어요.
{ "mcpServers": { "mage": { "url": "https://mcp.mage.space/mcp", "auth": { "CLIENT_ID": "https://cursor.com/mcp", "scopes": [ "mage", "offline_access" ] } } } }로그인하고 요청하기
안내가 나오면 Mage 계정으로 인증한 다음, Agent 모드의 Cursor에 프로젝트에 필요한 미디어를 생성해 달라고 요청하세요.
사용해 보기
Cursor에서 Mage를 쓸 때 쓸 만한 프롬프트 예시
- 시드 데이터에 쓸 임시 제품 사진을 생성해서 /public/products에 저장해 줘.
- 앱 아이콘을 세 가지 스타일로 만들어서 design 폴더에 추가해 줘.
- 빈 화면에 들어갈 짧은 온보딩 영상을 만들어 줘.
도구
어시스턴트가 호출할 수 있는 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
자주 묻는 질문
Cursor에서 OAuth 대신 API 키를 쓸 수 있나요?
네. 서버 항목을 URL과 headers: { "Authorization": "Bearer ${env:MAGE_API_KEY}" }로 설정하고, 키는 환경 변수에 보관하세요.
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 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.