Mage

npx add-mcp 'https://mcp.mage.space/mcp'

Mage'ı Claude, ChatGPT, Grok ve Cursor'dan Kullanın

Claude, ChatGPT, Claude Code, Grok veya Cursor'ı Mage MCP sunucusu üzerinden Mage hesabınıza bağlayın, ardından asistanınızdan Gems ile ödenen görsel, video ve ses üretmesini isteyin.

Mage MCP sunucusu, yapay zeka asistanlarını Mage hesabınıza bağlar. Bağlandıktan sonra Claude, ChatGPT, Claude Code, Grok veya Cursor'dan bir model seçmesini, fiyat teklifi vermesini, bir görsel, video veya ses klibi üretmesini ve sonucu geri getirmesini isteyebilirsiniz. Ayrıca üretim geçmişinizi ve kaydedilmiş eserlerinizi okur, kaydedilmiş karakterlerinizi ve referanslarınızı kullanır.

https://mcp.mage.space/mcp

[!WARNING]

Asistanınızın başlattığı her üretim, hesabınızdan Gems ile ödenir. Asistanınız önce fiyatı kontrol edebilir ve bağlantıyı istediğiniz zaman kesebilirsiniz.

Asistanınızı bağlayın

Claude

Web'de Claude, masaüstü uygulaması, mobil uygulamalar ve Cowork içinde çalışır.

1. Connect Mage to Claude sayfasını açın. Bağlayıcı adı ve URL'si sizin için doldurulur. Add seçeneğini seçin.
2. Connect seçeneğini seçin. Bir Mage sayfası açılır ve henüz oturum açmadıysanız sizden oturum açmanızı ister.
3. Sayfanın bağladığınız uygulamayı adlandırdığını kontrol edin, ardından Connect seçeneğini seçin. Claude'a geri dönersiniz.
4. Bir sohbette, Connectors altındaki + menüsünden Mage bağlayıcısını açın ve ne yapmak istediğinizi sorun.

Team veya Enterprise planında, bir sahip önce bağlayıcıyı Organization settings → Connectors altında ekler. Free planı bir özel bağlayıcıya izin verir.

ChatGPT

Mage'ı ChatGPT'nin Plugins sayfasından kişisel bir eklenti olarak ekleyin.

1. ChatGPT Plugins sayfasını açın.
2. Add seçeneğine tıklayın, ardından Create MCP App seçeneğini seçin.
3. Name için Mage, Server URL için https://mcp.mage.space/mcp girin ve Authentication için OAuth seçin. Advanced OAuth settings alanını boş bırakın; istemci kimliği veya istemci sırrı gerekmez. Simge ve açıklama isteğe bağlıdır.
4. Bildirimi inceleyin, I understand and want to continue kutusunu işaretleyin, ardından Create seçeneğine tıklayın.
5. Açılan sayfada Mage'a oturum açın, uygulamanın adını kontrol edin ve Connect seçeneğini seçin.
6. Personal eklentilerinizden Mage'ı yükleyin, bir Work sohbeti başlatın ve @Mage ifadesinden bahsedin.

[!NOTE]

Create MCP App seçeneği yoksa, ChatGPT'nin Settings → Security and login bölümünde Developer mode seçeneğini açın, ardından Plugins bölümüne dönün. Daha fazla ayrıntı için ChatGPT'nin kurulum kılavuzuna bakın.

Claude Code

Sunucuyu ekleyin, ardından Claude Code'dan oturum açın:

claude mcp add --transport http mage https://mcp.mage.space/mcp

Claude Code'da /mcp komutunu çalıştırın, mage seçeneğini seçin ve kimlik doğrulaması yapın. Mage'a oturum açmanız ve Connect seçeneğini seçmeniz için bir tarayıcı sayfası açılır.

Oturum açmak yerine bir API anahtarı kullanmak için:

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

Grok

Mage'ı bir özel MCP bağlayıcısı olarak ekleyin.

1. Grok connectors sayfasını açın, New Connector seçeneğini seçin, ardından Custom seçeneğini seçin.
2. https://mcp.mage.space/mcp girin ve Mage hesabınızı bağlamak için kimlik doğrulama istemlerini tamamlayın.
3. Bir konuşma başlatın ve Grok'tan Mage'ı kullanarak bir görsel, video veya ses oluşturmasını isteyin.

Grok Business veya Enterprise'da, bir ekip yöneticisinin önce bağlayıcıyı bulut konsolunda sağlaması gerekir.

Cursor

Düğme, Mage'ı genel OAuth istemci kimliğiyle yükler; istendiğinde Mage'a oturum açın. Mage zaten yüklüyse, mevcut yapılandırmasını bu bağlantıdakiyle değiştirin. Düğme hiçbir şey yapmıyorsa, bunun yerine web yükleme bağlantısını açın: tarayıcıdan Cursor'ı açar ve elle eklemek için aynı yapılandırmayı gösterir.

Manuel kurulum için, bu girdiyi ~/.cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com/mcp",
        "scopes": [
          "mage",
          "offline_access"
        ]
      }
    }
  }
}

İstemci kimliği geneldir ve istemci sırrı gerektirmez. Cursor, Mage'ın onay sayfasını açmak için statik OAuth yapılandırmasını kullanır.

Ayrıca bir API anahtarı ile de bağlanabilirsiniz:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "headers": { "Authorization": "Bearer ${env:MAGE_API_KEY}" }
    }
  }
}

Bir uygulama oturum açarak bağlandığında, Mage herhangi bir şey paylaşılmadan önce kimin sorduğunu gösterir: uygulamanın adı, geldiği site ve sonrasında nereye döndüğünüz. Bir konuk oturumu bir uygulamayı bağlayamaz; önce Mage hesabınızla oturum açın.

Asistanınızın yapabilecekleri

Araç	Ne yapar
list_models	Önerilen modelleri fiyatlarıyla, her birinin en iyi olduğu şeyle ve ödünleşimleriyle listeler; geri kalanları istek üzerine.
get_model	Bir modeli tanımlar: alanları, izin verilen değerleri, varsayılanları, kuralları ve fiyatı.
estimate_cost	Bir üretimi başlamadan önce fiyatlandırır. Hiçbir ücret alınmaz.
create_upload	Komut çalıştırabilen asistanlar için bilgisayarınızdan bir dosya yüklemek üzere imzalı bir bağlantı alır.
generate	Gems ile ödenen bir üretim başlatır.
get_request	Bir üretimin bitmesini bekler ve sonuç bağlantısını döndürür.
cancel_request	Çalışan bir üretimi durdurur. Gems iade edilmez.
get_account	Bağlı hesabı ve Gems bakiyesini gösterir.
list_characters	Karakterlerinizi ve @handle değerlerini listeler.
create_character	Bir görsel bağlantısından, isteğe bağlı olarak bir ses klibiyle birlikte özel bir karakter kaydeder.
delete_character	Karakterlerinizden birini siler.
list_references	Kıyafetlerinizi, pozlarınızı, konumlarınızı, nesnelerinizi ve ses kliplerinizi, hepsini veya tek bir türü listeler.
create_reference	Bir görsel veya ses bağlantısından özel bir referans kaydeder.
delete_reference	Referanslarınızdan birini siler.
list_history	Son 30 gündeki üretimlerinizi, Mage'da kendiniz yaptıklarınız dahil, listeler.
search_creations	Kaydettiğiniz eserleri, ne gösterdiklerine, koleksiyona veya tarihe göre arar.

Bir istekte kaydedilmiş bir karakterden veya referanstan tanıtıcısıyla bahsedin, örneğin "@ana'nın @red-coat giydiği bir portre yap" ve asistanınız bunu modele iletir.

Yetenekler

Mage yetenekleri, asistanınıza bu araçların üzerinde eksiksiz işler öğretir: ürün çekimleri, pazar yeri listeleri, reklam varyasyonları, UGC ve yüzsüz videolar, YouTube küçük resimleri ve Mage uygulamaları; yüz değiştirmeden yeniden aydınlatmaya, video düzenlemeden dudak senkronizasyonuna kadar. Bunları npx skills add mage-space/skills ile ekleyin veya mage.space/skills adresinde örneklerle göz atın.

Asistanınızın hangi modeli kullandığı

Bir model belirtmediğiniz sürece, asistanınız görselleri Mango 3, videoları Cherry 2 Pro ve sesleri Seed Audio ile oluşturur. Başlamadan önce size modeli ve fiyatı söyler ve bir sonuçtan sonra, ödünleşimi yaptığınız işe uyduğunda bir alternatif önerebilir.

	Görseller	Video
Varsayılan	Mango 3	Cherry 2 Pro
Aynı aile	Mango 3S (daha ucuz, 3K'ya kadar), Mango 2 (4K'ya kadar), Mango	Cherry Pro (4K), Cherry, Cherry Mini (en ucuz Cherry)
Ayrıca önerilen	Guava 2 Pro ve Guava 2 (fotogerçekçi), GPT Image 2.5 Flare (metin ve hassas düzenlemeler)	Lemon (ilk ve son kareler, 30 saniyeye kadar klipler)

Diğer tüm modeller yalnızca adlarıyla istediğinizde çalışır, örneğin "Melon ile yap" veya "Nano Banana 2 kullan". Asistanınız bir isteğe daha iyi uyduğunda, örneğin bir anime klibi için bir anime modeli gibi, bir model önerebilir ve yanıtınızı bekler. Hangi modeli kullanmalıyım? hepsini karşılaştırır.

Cherry 2 Pro, Mage'ın en yetenekli ve en pahalı video modelidir ve fiyatı çözünürlük ve uzunlukla dik bir şekilde artar. Taslak hazırlarken Cherry Mini veya Lemon isteyin.

Üretimler nasıl çalışır

1. Asistanınız, yukarıdaki gibi list_models ile bir model seçer ve alanlarını get_model ile okur.
2. Fiyatı estimate_cost ile kontrol eder; bu aynı zamanda modelin reddedeceği bir isteği de yakalar. Bir videonun fiyatı uzunluğuna bağlıdır: Mage, fiyat teklifi verirken Mage'da zaten bulunan bir videoyu, örneğin yüklenmiş bir dosya veya daha önceki bir sonucu ölçer; başka bir siteden bağlantı verilen bir videoyu ise yalnızca üretim başladığında ölçer.
3. Üretimi generate ile başlatır; bu, Gems'inizden ücret alır. Her üretim, asistanınızın uydurduğu bir anahtar taşır, böylece bağlantı koptuktan sonra yapılan bir yeniden deneme iki kez ödemek yerine aynı üretimi döndürür.
4. Sonuç hazır olana kadar get_request ile bekler ve size bağlantıyı verir.

Sonuçlar 30 gün boyunca kullanılabilir kalır: saklamak istediklerinizi indirin veya Mage'da kaydedin. Moderasyon tarafından NSFW olarak işaretlenen bir sonuç böyle işaretlenir. Bir üretimin geçtiği durumlar için Requests ve Gems'in nasıl ücretlendirildiği için Billing bölümüne bakın.

Görseller ve dosyalar

Medya girdileri, örneğin bir ilk kare, bir referans görseli veya düzenlenecek bir video, bağlantılardır: dosyanın kendisine bir genel https bağlantısı veya yaklaşık 3 MB'a kadar bir veri URL'si.

• Claude Code, Cursor ve komut çalıştıran diğer asistanlar bilgisayarınızdan bir dosya yükleyebilir: create_upload ile imzalı bir yükleme bağlantısı alırlar, dosyayı ona gönderirler ve dosyanın yeni bağlantısını diğerleri gibi kullanırlar. Bir dosya 100 MB'a kadar olabilir ve 30 gün sonra silinir. Her yükleme bir dosya tutar: düzeltilmiş bir dosya yeni bir yükleme olarak yüklenir, çünkü eski bağlantı ilk dosyayı 4 saate kadar göstermeye devam edebilir.
• Claude, ChatGPT ve Grok sohbetleri sohbete eklediğiniz bir dosyayı Mage'a iletemez. Bunun yerine dosyaya doğrudan bir bağlantı paylaşın veya Mage'da zaten bulunan bir eseri kullanın.
• Bir web sayfasına, örneğin bir YouTube veya TikTok videosuna verilen bağlantı bir dosya değildir ve reddedilir.

Bağlı uygulamaları yönetin

Bağladığınız her uygulama, ne zaman bağladığınız ve en son ne zaman kullanıldığıyla birlikte MCP → Connected apps bölümünde listelenir. Bir uygulamayı hemen durdurmak için Disconnect seçeneğini seçin; yeniden bağlayana kadar hesabınızı kullanamaz veya Gems'inizi harcayamaz. Yüzen gezinmede MCP seçeneğini açın, ardından Connected apps seçeneğini seçin.

Sınırlar

• API ile olduğu gibi, hesabınız için aynı anda 20 üretime kadar çalışabilir.
• Bir uygulama dakikada 120 araç çağrısına kadar yapabilir.
• get_request çağrı başına 2 dakikaya kadar bekler; daha uzun üretimler için asistanınız onu tekrar çağırır.

Sorun giderme

• Cursor "Incompatible auth server: does not support dynamic client registration" diyor: ~/.cursor/mcp.json dosyasındaki mevcut Mage girdisini, yukarıdaki Cursor kurulumundaki auth bloğunu içerecek şekilde güncelleyin, ardından yeniden bağlanın. Yalnızca bir sunucu URL'si, Mage'ın önceden kaydedilmiş Cursor istemci kimliğini içermez.

• "Couldn't reach the MCP server": URL'nin tam olarak https://mcp.mage.space/mcp olduğunu kontrol edin, ardından bağlayıcıyı kaldırın ve yeniden ekleyin.

• Bağlantı sizden tekrar oturum açmanızı istiyor: bağlantı 180 güne kadar sürer, sonrasında uygulama sizden tekrar onaylamanızı ister. Mage'da bağlantıyı kesmek de onu sonlandırır.

• Bir üretim insufficient_gems ile başarısız oldu: API → Billing bölümünde Gems ekleyin ve tekrar deneyin.

Bu belge, bir geliştirici belgelendirme platformu olan Mintlify üzerinde oluşturulur ve barındırılır.