MCP-Server: Bilder, Video und Sprache in KI-Apps

Gib Claude, ChatGPT, Cursor, VS Code und anderen KI-Apps Zugriff auf die Bild-, Video- und Sprachmodelle von Zurelay. Verbinde den MCP-Server einmal, melde dich an und frag im Chat nach einem Bild, Clip oder Voiceover: Es wird mit Nano Banana, GPT Image, Seedance, Kling, Wan oder Gemini TTS erstellt und über dein Zurelay-Guthaben bezahlt – zu denselben Preisen wie über die API.

https://api.zurelay.com/mcp

Der Server läuft remote (Streamable HTTP), du musst also nichts installieren. Melde dich über die App an oder sende einen API-Schlüssel. In der offiziellen MCP Registry ist er als com.zurelay/mcp gelistet.

Was du damit machen kannst

Chatmodelle sind hier keine Tools: Eine App, die auf einem Modell läuft, hat bereits eins. Um Claude Code, Cursor oder eine andere App mit den Chatmodellen von Zurelay zu nutzen, ändere stattdessen ihre Basis-URL (siehe Integrationen).

Verbinde deine App

Alle Apps unten können sich anmelden: Du bestätigst sie einmal auf zurelay.com und musst keinen Schlüssel einfügen. Apps, die sich nicht anmelden können, oder Setups, die keinen Browser öffnen sollen (Server, CI), verwenden stattdessen einen API-Schlüssel.

Claude (Web, Desktop und Mobilgeräte)

Zurelay zu Claude hinzufügen öffnet das bereits ausgefüllte Formular. Oder manuell:

1. Gehe zu Anpassen, dann zu Connectors, wähle Hinzufügen und dann Benutzerdefinierten Connector hinzufügen.
2. Nenne ihn Zurelay und füge https://api.zurelay.com/mcp als MCP-Server-URL ein. Beide Optionen für den OAuth-Client funktionieren: Veröffentlichte Identität von Claude verwenden oder Automatisch registrieren. Füge ihn hinzu.
3. Wähle Verbinden. Zurelay öffnet sich: Melde dich an, lege ein tägliches Ausgabenlimit fest und wähle Zulassen.
4. Öffne in einem Chat +, dann Connectors, aktiviere Zurelay und beschreibe, was du möchtest: „Erstelle ein Poster im Format 16:9 von …“, „Animiere das als 5-Sekunden-Clip“, „Lies das mit ruhiger Stimme vor“.

Connectors funktionieren im Web, in der Desktop-App und auf deinem Smartphone – mit jedem Tarif (Free erlaubt einen benutzerdefinierten Connector). Bei Team und Enterprise fügt ein Owner Zurelay unter Organisationseinstellungen, Connectors hinzu (Hinzufügen, Benutzerdefiniert, Web); danach verbindet jedes Mitglied sein eigenes Zurelay-Konto.

Claude Code

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp

Gib dann /mcp in Claude Code ein, wähle zurelay und melde dich im geöffneten Browser an (oder führe claude mcp login zurelay aus). Mit einem API-Schlüssel brauchst du keinen Browser:

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp \
  --header "Authorization: Bearer $ZURELAY_API_KEY"

--scope user fügt es für jeden Ordner hinzu. Ohne diese Option erscheint es nur, wenn Claude Code in dem Ordner läuft, aus dem du es hinzugefügt hast; mit --scope project teilst du es stattdessen über .mcp.json des Projekts (halte Schlüssel aus geteilten Dateien heraus: .mcp.json liest ${ZURELAY_API_KEY} aus der Umgebung). Führe den Befehl in einem normalen Terminal aus, nicht innerhalb von Claude Code, und starte Claude Code neu, falls es bereits geöffnet war.

ChatGPT

1. Aktiviere unter Einstellungen, Sicherheit und Anmeldung den Entwicklermodus (Plus, Pro, Business, Enterprise und Edu; möglicherweise muss ein Workspace-Admin ihn freigeben).
2. Öffne ChatGPT Plugins und klicke auf +. Nenne es Zurelay und gib https://api.zurelay.com/mcp als Verbindungs-URL ein, mit OAuth.
3. Melde dich bei Zurelay an und wähle Zulassen. Öffne in einem Chat +, wähle Entwicklermodus und dann Zurelay.

ChatGPT kann sich nur anmelden: Es kann keinen API-Schlüssel senden.

Cursor

Zurelay zu Cursor hinzufügen, dann wähle in den MCP-Einstellungen von Cursor daneben Verbinden, um dich anzumelden. Oder füge es zu ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt) hinzu:

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

VS Code

Zurelay zu VS Code hinzufügen, oder füge es in deinem Projekt zu .vscode/mcp.json hinzu (oder führe MCP: Server hinzufügen über die Befehlspalette aus und wähle HTTP). VS Code bittet dich um die Anmeldung, wenn Copilots Agentenmodus es zum ersten Mal nutzt. Bei einem API-Schlüssel fragt VS Code einmal nach dem Schlüssel und speichert ihn verschlüsselt:

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

KI-Agenten

Dauerhaft aktive und persönliche Agenten fügen den Server genauso hinzu: Grok Bot und Meta Muse, wenn du eine entsprechende Nachricht einfügst, OpenAI dots über die Plugins von ChatGPT sowie Gemini Spark, Manus und Perplexity in ihren Connector-Einstellungen. OpenClaw und Hermes Agent können ihn ebenfalls nutzen – oder den Skill von Zurelay, über den sie mit einem von dir bestätigten Link einen eigenen Schlüssel erhalten. Die Schritte für jeden Agenten findest du unter KI-Agenten.

Codex, Gemini CLI und andere Apps

Jede App, die MCP über Streamable HTTP unterstützt, funktioniert. Codex meldet sich mit codex mcp login zurelay an und Gemini CLI mit /mcp auth zurelay; für einen Schlüssel akzeptieren die meisten Apps einen Authorization-Header:

# or: codex mcp add zurelay --url 'https://api.zurelay.com/mcp' --bearer-token-env-var ZURELAY_API_KEY
[mcp_servers.zurelay]
url = "https://api.zurelay.com/mcp"
bearer_token_env_var = "ZURELAY_API_KEY"

Anmeldung oder API-Schlüssel

Die Anmeldung ist einfacher und sicherer. Die App öffnet zurelay.com. Dort meldest du dich mit einem Code per E-Mail an, wählst den Workspace, dessen Guthaben sie nutzt, legst ein tägliches Ausgabenlimit fest und erteilst die Freigabe. Zurelay fügt dann auf deiner Schlüsselseite einen nach der App benannten Schlüssel hinzu, etwa „Claude (MCP)“, mit diesem Limit. Die App sieht nie einen API-Schlüssel: Sie erhält ein Token, das eine Stunde gültig ist, und ein Refresh-Token, das sich bei jeder Verwendung ändert. Beide funktionieren nur am MCP-Server, nicht für die übrige API. Ändere das Limit auf der Schlüsselseite oder widerrufe dort den Schlüssel, um die App zu trennen.

Ein API-Schlüssel kommt in den Authorization: Bearer zr_live_…-Header. Alle Einstellungen des Schlüssels gelten: Budgets, Ratenlimit, erlaubte Modelle und erlaubte IP-Adressen. Erstelle einen eigenen Schlüssel für die App mit einem täglichen Budget, damit ein aktiver Agent nicht mehr ausgeben kann als geplant (siehe Schlüssellimits und Regeln). Apps wie Claude und ChatGPT senden Anfragen von ihren eigenen Servern. Lass deshalb bei einem Schlüssel für diese Apps die Liste erlaubter IP-Adressen leer.

Preise, Links und Wartezeiten

• Es gelten dieselben Preise wie für die API: Sieh dir die Modelle auf der Modellseite an oder bitte die KI, list_models aufzurufen. Fehlgeschlagene Anfragen werden nicht berechnet, und ein Video wird erst berechnet, wenn es fertig ist.
• Ein Tool antwortet innerhalb von etwa 35 Sekunden. Bilder und Sprache sind dann meist fertig. Was länger dauert (vor allem Videos), liefert eine ID zurück. Die KI ruft dann get_result auf und wartet damit jedes Mal bis zu 45 Sekunden länger.
• Die Ergebnisse sind Links zu unserem Speicher und 24 Stunden gültig. Bilder und Videos bleiben 30 Tage in deiner Bibliothek. Jede Anfrage erscheint wie gewohnt auf deiner Anfragenseite.
• Bilder werden auch als kleine Vorschau zurückgegeben. So kann die KI sehen, was sie erstellt hat, und es anpassen. Bitte sie, Vorschauen wegzulassen, um Kontext zu sparen.

Dateien von deinem Computer

Um ein Bild zu bearbeiten oder ein Einzelbild zu animieren, braucht das Modell einen Link zur Datei. Für Dateien, die bereits online sind, kannst du ihre https-Links angeben. Bei Dateien auf deinem Computer nutzen Apps, die Befehle ausführen können (Claude Code, Cursor, Codex), create_upload_link: eine PNG-, JPEG-, WebP-, MP4-, MOV-, MP3- oder WAV-Datei mit bis zu 20 MB, die innerhalb von 15 Minuten hochgeladen wird. Der zurückgegebene Link funktioniert 2 Stunden lang. Die Datei wird nach 2 Tagen gelöscht. Für Upload-Links brauchst du Guthaben auf deinem Konto.

# 1. The agent calls create_upload_link and gets a one-time URL.
# 2. It uploads the file with curl:
curl -sS -T ./product-photo.png 'https://api.zurelay.com/mcp/uploads/…'
# {"url":"https://…/inputs/2026-10-05/….png","type":"image/png","bytes":482113,…}
# 3. It passes that url to generate_image's reference_images or generate_video's first_frame.

Sicherheit

• Die Anmeldung folgt der MCP-Spezifikation: OAuth 2.1 mit PKCE (nur S256), ausschließlich registrierte Weiterleitungsadressen und einmalig verwendbare Codes, die 5 Minuten gültig sind. Wird ein Code zweimal verwendet, wird das widerrufen, wofür er eingetauscht wurde.
• Tokens werden zufällig erzeugt und nur als SHA-256-Hashes gespeichert. Access-Tokens sind eine Stunde gültig und funktionieren nur am MCP-Server. Refresh-Tokens wechseln bei jeder Verwendung. Wird eines nach mehr als einer Minute erneut verwendet, gilt es als kopiert: Die Verbindung wird getrennt und ihr Schlüssel widerrufen.
• Jede Verbindung hat einen eigenen Schlüssel auf deiner Schlüsselseite mit einem eigenen Tageslimit. Mitglieder deines Workspace können ihn sehen. Wenn du den Schlüssel widerrufst oder den Workspace verlässt, wird die App getrennt.
• Die Zustimmungsseite lässt sich nicht in eine andere Website einbetten. Sie zeigt dir, wenn Zurelay eine App nicht erkennt und wohin du danach zurückgeleitet wirst.
• Upload-Links sind signiert, gelten für eine Datei und laufen nach 15 Minuten ab. Hochgeladene Dateien werden nach 2 Tagen gelöscht.
• Jeder Schlüssel und jeder Workspace hat ein eigenes Ratenlimit für MCP-Aufrufe. Jeder Aufruf in einem Batch zählt mit.

Für Entwickler

Der Server unterstützt MCP 2025-11-25 (sowie 2025-06-18, 2025-03-26 und 2024-11-05) über Streamable HTTP: Sende JSON-RPC per POST an https://api.zurelay.com/mcp und erhalte JSON zurück. Er speichert keine Sitzungen. Deshalb gibt es keine Server-Sent Events und GET antwortet mit 405. Ohne Token antwortet er mit 401 und WWW-Authenticate verweist auf https://api.zurelay.com/.well-known/oauth-protected-resource/mcp. Die Metadaten des Autorisierungsservers findest du unter https://api.zurelay.com/.well-known/oauth-authorization-server; dynamische Client-Registrierung wird unterstützt.

curl https://api.zurelay.com/mcp \
  -H "Authorization: Bearer $ZURELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "A lighthouse at dusk, oil painting", "model": "nano-banana-pro" }
    }
  }'

Fehlerbehebung

• zurelay erscheint nicht in Claude Codes /mcp: Es wurde für einen anderen Ordner hinzugefügt oder Claude Code lief bereits. Beende Claude Code, führe den Befehl oben (mit --scope user) in einem normalen Terminal aus und starte Claude Code neu. claude mcp list zeigt an, dass eine Authentifizierung nötig ist, bis du dich anmeldest.
• Die App fordert dich immer wieder zur Anmeldung auf: Ihr Schlüssel wurde widerrufen oder die Anmeldung wurde ein Jahr lang nicht genutzt. Verbinde die App erneut.
• „Dein Zurelay-Guthaben ist aufgebraucht“ oder „Tagesbudget erreicht“: Lade auf der Abrechnungsseite Guthaben auf oder erhöhe das Limit des Schlüssels auf der Schlüsselseite.
• „Dieses Token gehört zu einer App, die über den MCP-Server von Zurelay verbunden ist“: Du hast das Token einer App an die API gesendet. Verwende dort einen API-Schlüssel.
• Ein Video scheint festzustecken: Bitte die KI, get_result erneut aufzurufen. Videos dauern 1 bis 5 Minuten, manchmal länger, wenn ein Modell ausgelastet ist.