MCP-server: afbeeldingen, video en spraak in AI-apps

Geef Claude, ChatGPT, Cursor, VS Code en andere AI-apps toegang tot de beeld-, video- en spraakmodellen van Zurelay. Verbind de MCP-server één keer, log in en vraag in de chat om een afbeelding, een clip van een voice-over: die wordt gemaakt met Nano Banana, GPT Image, Seedance, Kling, Wan of Gemini TTS en betaald vanuit je Zurelay-tegoed, tegen dezelfde prijzen als de API.

https://api.zurelay.com/mcp

Het is een externe server (Streamable HTTP), dus je hoeft niets te installeren. Log in vanuit de app of stuur een API-sleutel mee. Je vindt de server in het officiële MCP Registry als com.zurelay/mcp.

Wat je ermee kunt

Chatmodellen zijn hier geen tools: een app die op een model draait, heeft er al een. Wil je Claude Code, Cursor of een andere app met de chatmodellen van Zurelay gebruiken, pas dan de basis-URL aan (zie Integraties).

Verbind je app

Met elke app hieronder kun je inloggen: je geeft één keer toestemming op zurelay.com en hoeft nooit een sleutel te plakken. Apps waarmee je niet kunt inloggen, van omgevingen die geen browser mogen openen (servers, CI), sturen in plaats daarvan een API-sleutel mee.

Claude (web, desktop en mobiel)

Zurelay toevoegen aan Claude opent het formulier met alles al ingevuld. Of doe het handmatig:

1. Ga naar Aanpassen, dan naar Connectors, kies Toevoegen en daarna Aangepaste connector toevoegen.
2. Geef de connector de naam Zurelay en plak https://api.zurelay.com/mcp als de URL van de MCP-server. Beide OAuth-clientopties werken: De gepubliceerde identiteit van Claude gebruiken of Automatisch registreren. Voeg de connector toe.
3. Kies Verbinden. Zurelay opent: log in, kies een dagelijkse bestedingslimiet en kies Toestaan.
4. Open in een chat +, ga naar Connectors, schakel Zurelay in en vraag wat je wilt: “Maak een 16:9-poster van…”, “Animeer dit tot een clip van 5 seconden”, “Lees dit voor met een rustige stem”.

Connectors werken op het web, in de desktopapp en op je telefoon, met elk abonnement (Free staat één aangepaste connector toe). Bij Team en Enterprise voegt een eigenaar Zurelay toe onder Organisatie-instellingen, Connectors (Toevoegen, Aangepast, Web); daarna verbindt elk lid zijn eigen Zurelay-account.

Claude Code

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

Typ daarna /mcp in Claude Code, kies zurelay en log in via de browser die wordt geopend (of voer claude mcp login zurelay uit). Met een API-sleutel heb je geen browser nodig:

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

--scope user voegt de server toe voor elke map. Laat je dit weg, dan is de server alleen beschikbaar als Claude Code draait in de map van waaruit je hem hebt toegevoegd; gebruik --scope project om hem in plaats daarvan te delen via .mcp.json van het project (zet geen sleutels in gedeelde bestanden: .mcp.json leest ${ZURELAY_API_KEY} uit de omgevingsvariabelen). Voer de opdracht uit in een gewone terminal, niet binnen Claude Code, en start Claude Code opnieuw als het al openstond.

ChatGPT

1. Schakel onder Instellingen, Beveiliging en inloggen de Ontwikkelaarsmodus in (Plus, Pro, Business, Enterprise en Edu; mogelijk moet een werkruimtebeheerder dit toestaan).
2. Open ChatGPT Plugins en druk op +. Geef de verbinding de naam Zurelay en vul https://api.zurelay.com/mcp in als verbindings-URL, met OAuth.
3. Log in bij Zurelay en kies Toestaan. Open in een chat +, kies Ontwikkelaarsmodus en selecteer Zurelay.

ChatGPT werkt alleen via inloggen: het kan geen API-sleutel meesturen.

Cursor

Zurelay toevoegen aan Cursor, kies daarna Verbinden naast Zurelay in de MCP-instellingen van Cursor om in te loggen. Of voeg de server toe aan ~/.cursor/mcp.json (elk project) of .cursor/mcp.json (één project):

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

VS Code

Zurelay toevoegen aan VS Code, of voeg de server toe aan .vscode/mcp.json in je project (of voer MCP: Add Server uit via het opdrachtenpalet en kies HTTP). VS Code vraagt je in te loggen zodra de agentmodus van Copilot de server voor het eerst gebruikt. Met een API-sleutel vraagt VS Code één keer om de sleutel en slaat die versleuteld op:

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

AI-agents

Ook continu actieve en persoonlijke agents voegen de server op deze manier toe: Grok Bot en Meta Muse als je een bericht plakt waarin je erom vraagt, OpenAI dots via de plugins van ChatGPT, Gemini Spark, Manus en Perplexity via hun connectorinstellingen. OpenClaw en Hermes Agent kunnen de server ook gebruiken, of de skill van Zurelay, waarmee ze een eigen sleutel krijgen via een link die je goedkeurt. De stappen voor elke agent staan onder AI-agents.

Codex, Gemini CLI en andere apps

Elke app die MCP via Streamable HTTP ondersteunt, werkt. Codex logt in met codex mcp login zurelay en Gemini CLI met /mcp auth zurelay; voor een sleutel gebruiken de meeste apps een 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"

Inloggen of een API-sleutel

Inloggen is de makkelijke en veiligere manier. De app opent zurelay.com, waar je inlogt met een code per e-mail, kiest welke werkruimte de kosten betaalt, een dagelijkse bestedingslimiet instelt en toestemming geeft. Zurelay voegt dan een sleutel toe aan je Sleutelpagina, met die limiet en de naam van de app, zoals “Claude (MCP)”. De app krijgt nooit een API-sleutel te zien: hij krijgt een token dat een uur geldig is en een vernieuwingstoken dat bij elk gebruik verandert. Beide werken alleen op de MCP-server, nooit op de rest van de API. Pas de limiet aan op de Sleutelpagina, of trek de sleutel daar in om de app los te koppelen.

Een API-sleutel zet je in de Authorization: Bearer zr_live_…-header. Alle instellingen van de sleutel gelden: budgetten, aanvraaglimiet, toegestane modellen en toegestane IP-adressen. Maak een aparte sleutel voor de app met een dagbudget, zodat een drukke agent niet meer kan uitgeven dan je had gepland (zie Sleutellimieten en -regels). Apps zoals Claude en ChatGPT doen aanroepen vanaf hun eigen servers. Laat toegestane IP-adressen daarom leeg bij een sleutel voor deze apps.

Prijzen, links en wachttijden

• Dezelfde prijzen als de API: bekijk elk model op de modellenpagina, of vraag de AI om list_models aan te roepen. Voor een mislukte aanvraag betaal je niets, en een video wordt pas in rekening gebracht als die klaar is.
• Een tool antwoordt binnen ongeveer 35 seconden. Afbeeldingen en spraak zijn dan meestal klaar; bij alles wat langer duurt (de meeste video's) krijg je een id terug en roept de AI get_result aan. Die wacht elke keer maximaal 45 seconden extra.
• Resultaten zijn links naar onze opslag, die 24 uur geldig zijn. Afbeeldingen en video's blijven 30 dagen in je Bibliotheek staan, en elke aanvraag verschijnt net als alle andere op je Aanvragenpagina.
• Afbeeldingen worden ook als kleine preview teruggestuurd, zodat de AI kan zien wat hij heeft gemaakt en het kan aanpassen. Vraag de AI om previews weg te laten om context te besparen.

Bestanden van je computer

Om een afbeelding te bewerken of een frame te animeren, moet het model het bestand via een link kunnen ophalen. Bestanden die al online staan, kun je doorgeven via hun https-links. Voor bestanden op je computer gebruiken apps die opdrachten kunnen uitvoeren (Claude Code, Cursor, Codex) create_upload_link: één PNG, JPEG, WebP, MP4, MOV, MP3 of WAV van maximaal 20 MB, te uploaden binnen 15 minuten. De link die je terugkrijgt, werkt 2 uur en het bestand wordt na 2 dagen verwijderd. Voor uploadlinks moet er tegoed op je account staan.

# 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.

Beveiliging

• Inloggen volgt de MCP-specificatie: OAuth 2.1 met PKCE (alleen S256), uitsluitend geregistreerde omleidingsadressen en eenmalige codes die 5 minuten geldig zijn. Als een code twee keer wordt gebruikt, wordt alles wat ervoor is uitgegeven ongeldig.
• Tokens zijn willekeurig en worden alleen als SHA-256-hashes opgeslagen. Toegangstokens zijn een uur geldig en werken alleen op de MCP-server. Vernieuwingstokens veranderen bij elk gebruik; als er een meer dan een minuut later opnieuw wordt gebruikt, is het gekopieerd. De verbinding wordt dan verbroken en de bijbehorende sleutel ingetrokken.
• Elke verbinding is een sleutel op je Sleutelpagina met een eigen daglimiet, zichtbaar voor de leden van je werkruimte. Als je de sleutel intrekt of de werkruimte verlaat, wordt de app losgekoppeld.
• De toestemmingspagina kan niet binnen een andere site worden getoond en laat je weten als Zurelay een app niet herkent en waarnaar je wordt teruggestuurd.
• Uploadlinks zijn ondertekend, accepteren één bestand en verlopen na 15 minuten; geüploade bestanden worden na 2 dagen verwijderd.
• Elke sleutel en werkruimte heeft een eigen aanvraaglimiet voor MCP-aanroepen, en elke aanroep in een batch telt mee.

Voor ontwikkelaars

De server gebruikt MCP 2025-11-25 (en 2025-06-18, 2025-03-26 en 2024-11-05) via Streamable HTTP: stuur JSON-RPC met POST naar https://api.zurelay.com/mcp en je krijgt JSON terug. De server houdt geen sessies bij, dus er zijn geen server-sent events en GET antwoordt met 405. Zonder token antwoordt de server met 401 en WWW-Authenticate dat naar https://api.zurelay.com/.well-known/oauth-protected-resource/mcp verwijst; de metadata van de autorisatieserver staat op https://api.zurelay.com/.well-known/oauth-authorization-server, met dynamische clientregistratie.

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" }
    }
  }'

Problemen oplossen

• zurelay staat niet in Claude Code's /mcp: het is toegevoegd voor een andere map, of Claude Code draaide al. Sluit Claude Code af, voer de bovenstaande opdracht (met --scope user) uit in een gewone terminal en start Claude Code opnieuw. claude mcp list geeft aan dat authenticatie nodig is totdat je inlogt.
• De app blijft vragen om in te loggen: de aangemaakte sleutel is ingetrokken, of de verbinding is een jaar niet gebruikt. Koppel de app opnieuw.
• “Je Zurelay-tegoed is op” of “heeft het dagbudget bereikt”: voeg tegoed toe op de Facturatiepagina, of verhoog de limiet van de sleutel op de Sleutelpagina.
• “Dit token hoort bij een app die via de MCP-server van Zurelay is gekoppeld”: je hebt een token van een app naar de API gestuurd. Gebruik daar een API-sleutel.
• Een video lijkt vast te zitten: vraag de AI om get_result opnieuw aan te roepen; video's duren 1 tot 5 minuten, soms langer als een model druk is.