Mage

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

Mage von Claude, ChatGPT, Grok und Cursor aus verwenden

Verbinde Claude, ChatGPT, Claude Code, Grok oder Cursor über den Mage-MCP-Server mit deinem Mage-Konto und bitte dann deinen Assistenten, Bilder, Videos und Audio zu erzeugen, bezahlt in Gems.

Der Mage-MCP-Server verbindet KI-Assistenten mit deinem Mage-Konto. Sobald er verbunden ist, kannst du Claude, ChatGPT, Claude Code, Grok oder Cursor bitten, ein Modell auszuwählen, den Preis zu nennen, ein Bild, ein Video oder einen Audioclip zu erzeugen und das Ergebnis zurückzubringen. Er liest außerdem deinen Generierungsverlauf und deine gespeicherten Kreationen und verwendet deine gespeicherten Charaktere und Referenzen.

https://mcp.mage.space/mcp

[!WARNING]

Jede Generierung, die dein Assistent startet, wird in Gems von deinem Konto bezahlt. Dein Assistent kann den Preis vorher prüfen, und du kannst die Verbindung jederzeit trennen.

Deinen Assistenten verbinden

Claude

Funktioniert in Claude im Web, in der Desktop-App, in den mobilen Apps und in Cowork.

1. Öffne Mage mit Claude verbinden. Der Name des Connectors und die URL sind bereits ausgefüllt. Wähle Hinzufügen.
2. Wähle Verbinden. Eine Mage-Seite öffnet sich und bittet dich, dich anzumelden, falls du es noch nicht bist.
3. Prüfe, ob die Seite die App nennt, die du verbindest, und wähle dann Verbinden. Du kehrst zu Claude zurück.
4. Aktiviere in einem Chat den Mage-Connector über das Menü + unter Connectoren und frage nach dem, was du erstellen möchtest.

In einem Team- oder Enterprise-Tarif fügt zuerst ein Eigentümer den Connector unter Organisationseinstellungen → Connectoren hinzu. Der Free-Tarif erlaubt einen benutzerdefinierten Connector.

ChatGPT

Füge Mage als persönliches Plugin über die Plugins-Seite von ChatGPT hinzu.

1. Öffne ChatGPT Plugins.
2. Klicke auf Hinzufügen und wähle dann MCP-App erstellen.
3. Gib Mage als Name, https://mcp.mage.space/mcp als Server-URL ein und wähle OAuth für Authentifizierung. Lass die Erweiterten OAuth-Einstellungen leer; es werden keine Client-ID und kein Client-Secret benötigt. Das Symbol und die Beschreibung sind optional.
4. Lies den Hinweis, setze das Häkchen bei Ich verstehe und möchte fortfahren und klicke dann auf Erstellen.
5. Melde dich auf der sich öffnenden Seite bei Mage an, prüfe den Namen der App und wähle Verbinden.
6. Installiere Mage aus deinen persönlichen Plugins, starte einen Work-Chat und erwähne @Mage.

[!NOTE]

Wenn MCP-App erstellen fehlt, aktiviere den Entwicklermodus in den Einstellungen → Sicherheit und Anmeldung von ChatGPT und kehre dann zu Plugins zurück. Weitere Details findest du in ChatGPTs Einrichtungsanleitung.

Claude Code

Füge den Server hinzu und melde dich dann aus Claude Code an:

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

Führe /mcp in Claude Code aus, wähle mage und authentifiziere dich. Eine Browserseite öffnet sich, auf der du dich bei Mage anmeldest und Verbinden wählst.

Um statt der Anmeldung einen API-Schlüssel zu verwenden:

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

Grok

Füge Mage als benutzerdefinierten MCP-Connector hinzu.

1. Öffne Grok-Connectoren, wähle Neuer Connector und dann Benutzerdefiniert.
2. Gib https://mcp.mage.space/mcp ein und führe die Authentifizierungsschritte aus, um dein Mage-Konto zu verbinden.
3. Starte eine Unterhaltung und bitte Grok, Mage zu verwenden, um ein Bild, ein Video oder Audio zu erstellen.

In Grok Business oder Enterprise muss zuerst ein Team-Administrator den Connector in der Cloud-Konsole bereitstellen.

Cursor

Die Schaltfläche installiert Mage mit seiner öffentlichen OAuth-Client-ID; melde dich bei Mage an, wenn du dazu aufgefordert wirst. Wenn Mage bereits installiert ist, ersetze seine bestehende Konfiguration durch die aus diesem Link. Wenn die Schaltfläche nichts bewirkt, öffne stattdessen den Web-Installationslink: Er öffnet Cursor aus dem Browser und zeigt dieselbe Konfiguration zum manuellen Hinzufügen.

Für die manuelle Einrichtung füge diesen Eintrag zu ~/.cursor/mcp.json hinzu:

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

Die Client-ID ist öffentlich und benötigt kein Client-Secret. Cursor verwendet eine statische OAuth-Konfiguration, um Mage's Zustimmungsseite zu öffnen.

Du kannst dich auch mit einem API-Schlüssel verbinden:

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

Wenn sich eine App durch Anmelden verbindet, zeigt Mage, wer fragt, bevor etwas geteilt wird: den Namen der App, die Website, von der sie stammt, und wohin du danach zurückkehrst. Eine Gastsitzung kann keine App verbinden; melde dich zuerst mit deinem Mage-Konto an.

Was dein Assistent tun kann

Tool	Was es tut
list_models	Listet die empfohlenen Modelle mit ihren Preisen, wofür jedes am besten geeignet ist und seine Kompromisse auf; die übrigen auf Anfrage.
get_model	Beschreibt ein Modell: seine Felder, erlaubten Werte, Standardwerte, Regeln und den Preis.
estimate_cost	Berechnet den Preis einer Generierung, bevor sie beginnt. Es wird nichts berechnet.
create_upload	Ruft einen signierten Link zum Hochladen einer Datei von deinem Computer ab, für Assistenten, die Befehle ausführen können.
generate	Startet eine Generierung, bezahlt in Gems.
get_request	Wartet, bis eine Generierung abgeschlossen ist, und gibt den Ergebnislink zurück.
cancel_request	Stoppt eine laufende Generierung. Gems werden nicht erstattet.
get_account	Zeigt das verbundene Konto und sein Gems-Guthaben.
list_characters	Listet deine Charaktere und ihre @handles auf.
create_character	Speichert einen privaten Charakter aus einem Bildlink, optional mit einem Audioclip.
delete_character	Löscht einen deiner Charaktere.
list_references	Listet deine Outfits, Posen, Orte, Objekte und Audioclips auf, alle oder eine Art.
create_reference	Speichert eine private Referenz aus einem Bild- oder Audiolink.
delete_reference	Löscht eine deiner Referenzen.
list_history	Listet deine Generierungen der letzten 30 Tage auf, einschließlich derer, die du selbst in Mage erstellt hast.
search_creations	Durchsucht die von dir gespeicherten Kreationen nach dem, was sie zeigen, nach Sammlung oder nach Datum.

Erwähne einen gespeicherten Charakter oder eine Referenz in einer Anfrage mit ihrem Handle, zum Beispiel „Erstelle ein Porträt von @ana, das @red-coat trägt“, und dein Assistent übergibt sie an das Modell.

Skills

Mage-Skills bringen deinem Assistenten vollständige Aufgaben zusätzlich zu diesen Tools bei: Produktfotoshootings, Marketplace-Listings, Anzeigenvarianten, UGC- und Faceless-Videos, YouTube-Thumbnails und die Mage-Apps, von Face Swaps und Relighting bis hin zu Videobearbeitungen und Lip Sync. Füge sie mit npx skills add mage-space/skills hinzu oder durchstöbere sie mit Beispielen unter mage.space/skills.

Welches Modell dein Assistent verwendet

Wenn du kein Modell nennst, erstellt dein Assistent Bilder mit Mango 3, Videos mit Cherry 2 Pro und Audio mit Seed Audio. Er nennt dir das Modell und den Preis, bevor er beginnt, und schlägt nach einem Ergebnis möglicherweise eine Alternative vor, wenn deren Kompromiss zu dem passt, was du vorhast.

	Bilder	Video
Standard	Mango 3	Cherry 2 Pro
Gleiche Familie	Mango 3S (günstiger, bis 3K), Mango 2 (bis 4K), Mango	Cherry Pro (4K), Cherry, Cherry Mini (das günstigste Cherry)
Ebenfalls empfohlen	Guava 2 Pro und Guava 2 (fotorealistisch), GPT Image 2.5 Flare (Text und präzise Bearbeitungen)	Lemon (erstes und letztes Frame, Clips bis 30 Sekunden)

Jedes andere Modell läuft nur, wenn du es namentlich anforderst, zum Beispiel „erstelle es mit Melon“ oder „verwende Nano Banana 2“. Dein Assistent kann eines vorschlagen, wenn es besser zu einer Anfrage passt, etwa ein Anime-Modell für einen Anime-Clip, und wartet auf deine Antwort. Welches Modell sollte ich verwenden? vergleicht sie alle.

Cherry 2 Pro ist Mage's leistungsfähigstes und teuerstes Videomodell, und sein Preis steigt mit Auflösung und Länge steil an. Frage nach Cherry Mini oder Lemon, während du entwirfst.

Wie Generierungen funktionieren

1. Dein Assistent wählt ein Modell mit list_models wie oben und liest seine Felder mit get_model.
2. Er prüft den Preis mit estimate_cost, was auch eine Anfrage erkennt, die das Modell ablehnen würde. Der Preis eines Videos hängt von seiner Länge ab: Mage misst ein Video, das bereits auf Mage liegt, etwa eine hochgeladene Datei oder ein früheres Ergebnis, wenn es den Preis nennt, und ein von einer anderen Website verlinktes Video erst, wenn die Generierung beginnt.
3. Er startet die Generierung mit generate, was deine Gems berechnet. Jede Generierung trägt einen Schlüssel, den dein Assistent erzeugt, sodass ein erneuter Versuch nach einer unterbrochenen Verbindung dieselbe Generierung zurückgibt, statt doppelt zu bezahlen.
4. Er wartet mit get_request, bis das Ergebnis bereit ist, und gibt dir den Link.

Ergebnisse bleiben 30 Tage lang verfügbar: Lade herunter, was du behalten möchtest, oder speichere es in Mage. Ein Ergebnis, das von der Moderation als NSFW gekennzeichnet wurde, wird als solches markiert. Siehe Anfragen für die Zustände, die eine Generierung durchläuft, und Abrechnung dafür, wie Gems berechnet werden.

Bilder und Dateien

Medien-Eingaben wie ein erstes Frame, ein Referenzbild oder ein zu bearbeitendes Video sind Links: ein öffentlicher https-Link zur Datei selbst oder eine Daten-URL von bis zu etwa 3 MB.

• Claude Code, Cursor und andere Assistenten, die Befehle ausführen, können eine Datei von deinem Computer hochladen: Sie rufen mit create_upload einen signierten Upload-Link ab, senden die Datei dorthin und verwenden den neuen Link der Datei wie jeden anderen. Eine Datei kann bis zu 100 MB groß sein und wird nach 30 Tagen gelöscht. Jeder Upload enthält eine Datei: Eine korrigierte Datei wird als neuer Upload hochgeladen, da der alte Link bis zu 4 Stunden lang weiterhin die erste Datei anzeigen kann.
• Claude-, ChatGPT- und Grok-Chats können eine Datei, die du an den Chat anhängst, nicht an Mage weitergeben. Teile stattdessen einen direkten Link zur Datei oder verwende eine bereits auf Mage vorhandene Kreation.
• Ein Link zu einer Webseite, etwa einem YouTube- oder TikTok-Video, ist keine Datei und wird abgelehnt.

Verbundene Apps verwalten

Jede App, die du verbunden hast, ist unter MCP → Verbundene Apps aufgeführt, mit dem Zeitpunkt der Verbindung und der letzten Verwendung. Wähle Trennen, um eine App sofort zu stoppen; sie kann dein Konto nicht mehr nutzen und keine Gems mehr ausgeben, bis du sie erneut verbindest. Öffne MCP in der schwebenden Navigation und wähle dann Verbundene Apps.

Limits

• Bis zu 20 Generierungen können gleichzeitig für dein Konto laufen, wie bei der API.
• Eine App kann bis zu 120 Tool-Aufrufe pro Minute ausführen.
• get_request wartet pro Aufruf bis zu 2 Minuten; dein Assistent ruft es bei längeren Generierungen erneut auf.

Fehlerbehebung

• Cursor meldet „Incompatible auth server: does not support dynamic client registration“: Aktualisiere den bestehenden Mage-Eintrag in ~/.cursor/mcp.json um den auth-Block aus der Cursor-Einrichtung oben und verbinde dich dann erneut. Eine reine Server-URL enthält nicht Mage's vorregistrierte Cursor-Client-ID.

• „Couldn't reach the MCP server“: Prüfe, ob die URL genau https://mcp.mage.space/mcp lautet, entferne dann den Connector und füge ihn erneut hinzu.

• Die Verbindung bittet dich, dich erneut anzumelden: Die Verbindung dauert bis zu 180 Tage, danach bittet dich die App erneut um Zustimmung. Das Trennen in Mage beendet sie ebenfalls.

• Eine Generierung ist mit insufficient_gems fehlgeschlagen: Füge Gems unter API → Abrechnung hinzu und versuche es erneut.

Diese Dokumentation wird auf Mintlify erstellt und gehostet, einer Plattform für Entwicklerdokumentation.