MCP und KI-Agenten

Mit KI-Agenten verwenden#

Verwenden Sie MCP-Server, wenn ein Assistent Medien für Sie erstellen soll, etwa im Chat von Claude Code oder Cursor. Verwenden Sie Agent Skill, wenn ein Agent Code für die API schreibt. Beides funktioniert zusammen: Bei Verbindung bevorzugt der Skill die MCP-Tools.

Server-URL und Anmeldung#

• Transport: Streamable HTTP, zustandslos. Funktioniert mit Clients der MCP-Protokollversionen 2025 und 2026-07-28.
• Anmeldung: OAuth 2.1 gemäß der MCP-Autorisierungsspezifikation. Bei der ersten Verbindung öffnet sich die Seite CheaperGen im Browser. Melden Sie sich an und genehmigen Sie die App. Genehmigte Apps finden Sie unter Dashboard → API-Schlüssel → Verbundene Apps; dort können Sie jederzeit die Verbindung trennen.
• Headless und CI: Senden Sie stattdessen einen API-Schlüssel als Authorization: Bearer cg_live_…. Siehe API-Schlüssel verwenden.

Client verbinden#

Claude (claude.ai und Claude Desktop)#

1. Öffnen Sie Customize → Connectors und fügen Sie einen benutzerdefinierten Konnektor hinzu.
2. Geben Sie ihm den Namen CheaperGen, fügen Sie die URL von oben ein und wählen Sie Add.
3. Wählen Sie Verbinden, melden Sie sich bei CheaperGen an und genehmigen Sie die Verbindung. Aktivieren Sie den Konnektor anschließend im Chat über das Werkzeugmenü.

Bei Team- und Enterprise-Tarifen muss ein Inhaber den Connector möglicherweise zuerst für die Organisation hinzufügen. Connectoren, die Sie auf claude.ai hinzufügen, werden auch in Claude Desktop angezeigt.

Claude Code#

claude mcp add --transport http cheapergen https://cheapergen.com/api/mcp

Führen Sie dann /mcp aus, wählen Sie cheapergen und anschließend Authenticate (oder führen Sie claude mcp login cheapergen im Terminal aus). Ihr Browser öffnet sich zur Anmeldung und Genehmigung. Fügen Sie --scope user hinzu, damit der Konnektor in allen Projekten verfügbar ist. Oder installieren Sie das Plugin, das den Server und Agent Skill in einem Schritt hinzufügt:

/plugin marketplace add CheaperGen/skills
/plugin install cheapergen@cheapergen

ChatGPT#

Desktop-App (macOS und Windows). Im Work- oder Codex-Modus verwendet die ChatGPT-Desktop-App dieselben MCP-Einstellungen wie Codex CLI, sodass auch codex mcp add verbunden ist. Oder richten Sie es in der App ein:

1. Öffnen Sie Settings → MCP servers → Add server.
2. Geben Sie ihm den Namen cheapergen, wählen Sie Streamable HTTP, fügen Sie die URL von oben ein und speichern Sie.
3. Wählen Sie „Neustart“, dann „Authenticate“, und melden Sie sich bei CheaperGen an, um die Verbindung zu bestätigen. Geben Sie /mcp in das Eingabefeld ein, um sie zu prüfen.

chatgpt.com. Benutzerdefinierte MCP-Server werden zu Plugins und sind in ChatGPT-Arbeitsbereichen mit Business, Enterprise und Edu verfügbar (bei Business müssen Administratoren oder Inhaber sie hinzufügen). Richten Sie sie im Web ein, nicht in der mobilen App:

1. Öffnen Sie Plugins → + → Add custom MCP server.
2. Geben Sie ihm den Namen CheaperGen, fügen Sie die URL von oben ein und wählen Sie OAuth als Authentifizierungsmethode.
3. Aktivieren Sie I understand and want to continue, wählen Sie Create as a plugin und installieren Sie das Plugin. Melden Sie sich anschließend an und genehmigen Sie die Verbindung.
4. Geben Sie in einem Chat @ ein und wählen Sie das Plugin aus. ChatGPT fragt vor der Ausführung von generate oder add_credits nach.

Codex#

codex mcp add cheapergen --url https://cheapergen.com/api/mcp

Dadurch wird der Server zu ~/.codex/config.toml hinzugefügt und Ihr Browser zur Anmeldung geöffnet. Schritt übersprungen? Führen Sie codex mcp login cheapergen aus. Die Codex CLI, die Codex-IDE-Erweiterung (Zahnradmenü → MCP-Server) und die ChatGPT-Desktop-App lesen alle dieselbe Datei. Eine Einrichtung reicht für alle. Codex-Cloud-Aufgaben lesen diese Datei nicht. So bearbeiten Sie sie manuell:

[mcp_servers.cheapergen]
url = "https://cheapergen.com/api/mcp"

Cursor#

Fügen Sie dies zu ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt) hinzu. Öffnen Sie dann Anpassen → MCPs und verbinden Sie cheapergen. In der Cursor CLI führen Sie cursor-agent mcp enable cheapergen und anschließend cursor-agent mcp login cheapergen aus.

{
  "mcpServers": {
    "cheapergen": {
      "url": "https://cheapergen.com/api/mcp"
    }
  }
}

VS Code (GitHub Copilot)#

Fügen Sie dies zu .vscode/mcp.json hinzu oder führen Sie MCP: Add Server… aus und wählen Sie HTTP. VS Code fordert Sie bei der ersten Serververbindung zur Anmeldung auf. Verwenden Sie danach die Tools im Agentenmodus des Copilot-Chats.

{
  "servers": {
    "cheapergen": {
      "type": "http",
      "url": "https://cheapergen.com/api/mcp"
    }
  }
}

Weitere Clients#

Remote-Clients mit OAuth benötigen nur die URL (manche verwenden "serverUrl" statt "url"). Clients, die nur lokale Server über stdio ausführen, können die mcp-remote-Bridge nutzen. Dafür sind Node.js und eine Anmeldung erforderlich.

{
  "mcpServers": {
    "cheapergen": {
      "type": "http",
      "url": "https://cheapergen.com/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "cheapergen": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cheapergen.com/api/mcp"
      ]
    }
  }
}

API-Schlüssel verwenden (Headless, CI)#

Wenn keine Anmeldung über einen Browser möglich ist, wie etwa in CI, senden Sie einen API-Schlüssel aus Dashboard → API keys. Erstellen Sie pro Agent einen separaten Schlüssel, damit Sie ihn einzeln widerrufen können. Speichern Sie ihn wie unten gezeigt in einer Umgebungsvariablen: Einfache Anführungszeichen enthalten den Variablennamen, nicht den Schlüssel selbst. Beim Verbinden liest der Client den Wert aus. Claude Code ersetzt außerdem ${CHEAPERGEN_API_KEY} in einer committeten .mcp.json durch den Wert aus der Umgebung des jeweiligen Entwicklers.

claude mcp add --transport http cheapergen https://cheapergen.com/api/mcp \
  --header 'Authorization: Bearer ${CHEAPERGEN_API_KEY}'

codex mcp add cheapergen --url https://cheapergen.com/api/mcp \
  --bearer-token-env-var CHEAPERGEN_API_KEY

gemini mcp add --transport http cheapergen https://cheapergen.com/api/mcp \
  -H 'Authorization: Bearer ${CHEAPERGEN_API_KEY}'

{
  "mcpServers": {
    "cheapergen": {
      "type": "http",
      "url": "https://cheapergen.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${CHEAPERGEN_API_KEY}"
      }
    }
  }
}

npx @modelcontextprotocol/inspector --cli https://cheapergen.com/api/mcp --transport http \
  --header "Authorization: Bearer $CHEAPERGEN_API_KEY" --method tools/list

Werkzeuge#

Jedes Tool verwendet denselben Code wie die REST-API (API-Referenz); Preise, Validierung und Fehler stimmen daher überein. Ergebnisse sind kompaktes JSON. Ein fertiges Bild kommt zusätzlich als kleine eingebettete Vorschau zurück, damit der Chat es zeigt und der Agent es prüfen kann, und jede Ausgabedatei als Ressourcenlink zum Anzeigen oder Herunterladen.

Bilder sind meist mit einem einzigen Aufruf von generate fertig. Videos dauern ein bis mehrere Minuten. Der Agent sendet den Auftrag ab und ruft anschließend get_generation mit dem Parameter wait_seconds auf, bis der Auftrag abgeschlossen ist. Bei Erfolg liefert der Aufruf von generate:

{
  "id": "gen_8c2QmX1nq0k4Lw7Z",
  "status": "succeeded",
  "endpoint": "bytedance/seedream-5.0-lite/text-to-image",
  "outputs": [
    "https://cdn.cheapergen.com/outputs/gen_8c2QmX1nq0k4Lw7Z.png"
  ],
  "cost": {
    "amount_usd": 0.0303,
    "official_usd": 0.035,
    "list_price_source": "official",
    "list_price_label": "Offiziell",
    "saved_usd": 0.0047,
    "final": true
  },
  "created_at": "2026-10-16T09:12:43.545Z",
  "completed_at": "2026-10-16T09:12:49.058Z",
  "outputs_expire_at": "2026-10-17T09:12:49.058Z",
  "next": "Fertig. Zeigen oder laden Sie die Ausgabe-URLs herunter, bevor outputs_expire_at eintritt."
}

Beispielprompts#

• “Welche CheaperGen-Videomodelle akzeptieren Referenzvideos und was kosten jeweils 5 Sekunden in 720p?”
• “Erzeuge mit Seedance 2.0 Fast ein 5-Sekunden-Video in 720p: Ein Papierboot treibt eine regennasse Neonstraße entlang, langsame Kamerafahrt nach vorn. Nenne mir zuerst den Preis.”
• “Erstelle mit Seedream 5.0 Lite vier Produktaufnahmen dieser Tasse, jede unter $0.05: https://example.com/mug.png”
• “Verwandle dieses Foto mit Wan 3.0 in einen 6-sekündigen Hochformat-Clip: https://example.com/portrait.jpg”
• “Verwandle das Foto auf meinem Schreibtisch (~/Desktop/beach.jpg) mit Kling 3.0 in einen 5-sekündigen Clip. Nenn mir zuerst den Preis.”
• “Referenzvideo mit Seedance 2.0: @Image1 ist die Figur, @Image2 die Straße; bewege die Kamera wie bei @Video1. Hier sind die URLs: …”
• “Wie hoch ist mein CheaperGen-Guthaben und für wie viele 10-Sekunden-Clips in 1080p mit Seedance 2.0 reicht es?”

Agent Skill#

Der CheaperGen-Skill ist eine einzelne SKILL.md im Format Agent Skills. Er vermittelt den gesamten Ablauf: Modell wählen, Schema lesen, Preis abfragen, Auftrag absenden, Status abfragen oder Webhooks prüfen, Referenzen angeben, Dateien hochladen sowie Preise und Fehler behandeln. Agenten laden ihn nur bei Bedarf. Für REST-Aufrufe liest er den Schlüssel aus CHEAPERGEN_API_KEY und bevorzugt verbundene MCP-Tools. Quellcode: github.com/CheaperGen/skills.

/plugin marketplace add CheaperGen/skills
/plugin install cheapergen@cheapergen

npx skills add CheaperGen/skills

mkdir -p ~/.claude/skills/cheapergen
curl -fsSL https://cheapergen.com/skills/cheapergen/SKILL.md -o ~/.claude/skills/cheapergen/SKILL.md

mkdir -p .claude/skills/cheapergen
curl -fsSL https://cheapergen.com/skills/cheapergen/SKILL.md -o .claude/skills/cheapergen/SKILL.md

Die Skills-CLI installiert ihn in Claude Code, Cursor, Codex, Gemini CLI und weiteren Agenten (-a wählt einen aus, -g installiert ihn für alle Projekte). In Claude-Apps können Sie den Ordner cheapergen als ZIP-Datei hochladen und als eigenen Skill einrichten.

Limits und Abrechnung#

• Dieselben Ratenlimits-Limits wie bei der REST-API gelten pro verbundener App oder API-Schlüssel (jeder MCP-Aufruf zählt). Zusätzlich gilt das Kontolimit für gleichzeitig laufende Generierungen.
• Der Preis wird reserviert, wenn generate den Auftrag absendet, und bei einem Fehlschlag oder Abbruch der Generierung vollständig erstattet. Siehe Abrechnung & Guthaben.
• Über MCP erstellte Generierungen erscheinen im Dashboard und in GET /api/v1/generations mit source: "mcp".
• Anmeldetokens sind eine Stunde gültig; der Client erneuert sie automatisch. Wenn Sie die App im Dashboard trennen, endet ihr Zugriff sofort.
• Ausgabe-URLs sind öffentlich und laufen mit der Aufbewahrungsfrist Ihrer API ab (standardmäßig nach einem Tag). Laden Sie herunter, was Sie behalten möchten.

Fehlerbehebung#

• Der Client meldet, dass der Server eine Authentifizierung benötigt: Schließen Sie die begonnene Anmeldung ab (in Claude Code: /mcp → cheapergen → Authentifizieren). Wenn Sie die App getrennt oder 90 Tage lang nicht verwendet haben, melden Sie sich erneut an.
• Auf der Anmeldeseite steht, dass die App nicht registriert ist, oder die Weiterleitungsadresse stimmt nicht überein: Entfernen Sie den Server aus dem Client und fügen Sie ihn erneut hinzu, damit der Client ihn neu registriert.
• Ein Tool-Aufruf läuft in einen Timeout: verringern Sie wait_seconds. Die Generierung läuft trotzdem weiter; rufen Sie sie später mit get_generation ab.
• invalid_request: Die Eingabe entspricht nicht dem Schema des Endpunkts. Die Fehlermeldung nennt das Feld in param; bitten Sie den Agenten, zuerst get_model aufzurufen.