Serveur MCP : images, vidéo et voix dans les applications d’IA

Donnez à Claude, ChatGPT, Cursor, VS Code et aux autres applications d’IA accès aux modèles d’image, de vidéo et de synthèse vocale de Zurelay. Connectez le serveur MCP une seule fois, connectez-vous à votre compte, puis demandez une image, un clip ou une voix off dans la conversation : le contenu est créé avec Nano Banana, GPT Image, Seedance, Kling, Wan ou Gemini TTS et facturé sur votre solde Zurelay, aux mêmes tarifs que l’API.

https://api.zurelay.com/mcp

Il s’agit d’un serveur distant (Streamable HTTP), vous n’avez donc rien à installer. Connectez-vous depuis l’application ou envoyez une clé API. Il figure dans le registre MCP officiel sous le nom com.zurelay/mcp.

Fonctionnalités

Les modèles de chat ne sont pas proposés comme outils ici : une application qui utilise un modèle en a déjà un. Pour utiliser Claude Code, Cursor ou toute autre application avec les modèles de chat de Zurelay, modifiez plutôt son URL de base (voir Intégrations).

Connecter votre application

Toutes les applications ci-dessous permettent de vous connecter : vous autorisez l’accès une seule fois sur zurelay.com, sans jamais avoir à coller de clé. Les applications qui ne permettent pas de vous connecter, ou les configurations qui ne doivent pas ouvrir de navigateur (serveurs, CI), envoient une clé API à la place.

Claude (web, ordinateur et mobile)

Ajouter Zurelay à Claude ouvre le formulaire prérempli. Ou, pour le faire manuellement:

1. Allez dans Personnaliser, puis Connecteurs, choisissez Ajouter, puis Ajouter un connecteur personnalisé.
2. Nommez-le Zurelay et collez https://api.zurelay.com/mcp comme URL du serveur MCP. Les deux options de client OAuth conviennent : Utiliser l’identité publiée de Claude ou Enregistrer automatiquement. Ajoutez le connecteur.
3. Choisissez Connecter. Zurelay s’ouvre : connectez-vous, définissez un plafond de dépenses quotidien, puis choisissez Autoriser.
4. Dans une conversation, ouvrez +, puis Connecteurs, activez Zurelay et demandez ce que vous voulez : « Créez une affiche au format 16:9 de… », « Animez cette image pour en faire un clip de 5 secondes », « Lisez ce texte à voix haute d’une voix calme ».

Les connecteurs fonctionnent sur le web, dans l’application de bureau et sur votre téléphone, avec toutes les offres (Free permet un connecteur personnalisé). Avec Team et Enterprise, un propriétaire ajoute Zurelay dans Paramètres de l’organisation, Connecteurs (Ajouter, Personnalisé, Web); chaque membre connecte ensuite son propre compte Zurelay.

Claude Code

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

Tapez ensuite /mcp dans Claude Code, sélectionnez zurelay et connectez-vous dans le navigateur qui s’ouvre (ou lancez claude mcp login zurelay). Avec une clé API, pas besoin de navigateur :

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

--scope user l’ajoute pour tous les dossiers. Sans cette option, il n’apparaît que lorsque Claude Code s’exécute dans le dossier depuis lequel vous l’avez ajouté; utilisez plutôt --scope project pour le partager via le fichier .mcp.json du projet (ne mettez pas de clés dans les fichiers partagés : .mcp.json lit ${ZURELAY_API_KEY} dans l’environnement). Exécutez la commande dans un terminal classique, pas dans Claude Code, puis relancez Claude Code s’il était déjà ouvert.

ChatGPT

1. Dans Paramètres, Sécurité et connexion, activez le Mode développeur (Plus, Pro, Business, Enterprise et Edu; un administrateur de l’espace de travail devra peut-être l’autoriser).
2. Ouvrez ChatGPT Plugins et appuyez sur +. Nommez-le Zurelay et saisissez https://api.zurelay.com/mcp comme URL de connexion, avec OAuth.
3. Connectez-vous à Zurelay et choisissez Autoriser. Dans une conversation, ouvrez +, choisissez Mode développeur et sélectionnez Zurelay.

ChatGPT fonctionne uniquement par connexion : il ne peut pas envoyer de clé API.

Cursor

Ajoutez Zurelay à Cursor, puis choisissez Connecter à côté de Zurelay dans les paramètres MCP de Cursor pour vous connecter. Ou ajoutez-le à ~/.cursor/mcp.json (tous les projets) ou à .cursor/mcp.json (un seul projet) :

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

VS Code

Ajoutez Zurelay à VS Code, ou ajoutez-le à .vscode/mcp.json dans votre projet (ou lancez MCP: Add Server depuis la palette de commandes et choisissez HTTP). VS Code vous demande de vous connecter la première fois que le mode agent de Copilot l’utilise. Avec une clé API, il vous demande la clé une seule fois et la conserve chiffrée :

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

Agents IA

Les agents personnels et ceux qui restent actifs en permanence ajoutent le serveur de la même façon : Grok Bot et Meta Muse quand vous collez un message qui le leur demande, OpenAI dots via les plugins de ChatGPT, Gemini Spark, Manus et Perplexity dans leurs paramètres de connecteurs. OpenClaw et Hermes Agent peuvent aussi l’utiliser, ou utiliser le skill de Zurelay, qui leur fournit leur propre clé via un lien que vous approuvez. Les étapes pour chaque agent figurent dans Agents IA.

Codex, Gemini CLI et autres applications

Toute application prenant en charge MCP via Streamable HTTP fonctionne. Codex se connecte avec codex mcp login zurelay et Gemini CLI avec /mcp auth zurelay; pour utiliser une clé, la plupart des applications acceptent un en-tête Authorization :

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

Connexion ou clé API

La connexion est la méthode la plus simple et la plus sûre. L’application ouvre zurelay.com, où vous vous connectez avec un code reçu par e-mail, choisissez l’espace de travail à facturer et une limite de dépenses quotidienne, puis autorisez l’accès. Zurelay ajoute alors à votre page Clés une clé portant le nom de l’application, par exemple “Claude (MCP)”, avec cette limite. L’application ne voit jamais de clé API : elle détient un jeton valable une heure et un jeton de renouvellement qui change à chaque utilisation. Tous deux fonctionnent uniquement sur le serveur MCP, jamais sur le reste de l’API. Modifiez la limite sur la page Clés, ou révoquez-y la clé pour déconnecter l’application.

API Une clé se place dans l’en-tête Authorization: Bearer zr_live_…. Tous ses paramètres s’appliquent : budgets, limite de requêtes, modèles et adresses IP autorisés. Créez une clé dédiée à l’application, avec un budget quotidien, pour qu’un agent très actif ne dépense pas plus que prévu (voir Limites et règles des clés). Les applications comme Claude et ChatGPT envoient les requêtes depuis leurs propres serveurs : laissez donc la liste des adresses IP autorisées vide pour une clé qui leur est destinée.

Tarifs, liens et délais

• Les tarifs sont les mêmes que pour l’API : consultez chaque modèle sur la page des modèles, ou demandez à l’IA d’appeler list_models. Une requête qui échoue n’est pas facturée, et une vidéo n’est facturée qu’une fois terminée.
• Un outil répond en environ 35 secondes. Les images et l’audio sont généralement prêts dans ce délai; les opérations plus longues (la plupart des vidéos) renvoient un identifiant, puis l’IA appelle get_result, qui attend jusqu’à 45 secondes supplémentaires à chaque appel.
• Les résultats sont des liens vers notre stockage, valables 24 heures. Les images et vidéos restent dans votre Bibliothèque pendant 30 jours, et chaque requête apparaît sur votre page Requêtes comme les autres.
• Les images sont aussi renvoyées sous forme de petit aperçu, pour que l’IA puisse voir ce qu’elle a créé et l’ajuster. Demandez-lui d’omettre les aperçus pour économiser du contexte.

Fichiers de votre ordinateur

Pour modifier une image ou l’animer, le modèle doit pouvoir accéder au fichier via un lien. Les fichiers déjà en ligne peuvent être transmis via leurs liens https. Pour les fichiers de votre ordinateur, les applications capables d’exécuter des commandes (Claude Code, Cursor, Codex) utilisent create_upload_link : un fichier PNG, JPEG, WebP, MP4, MOV, MP3 ou WAV de 20 MB maximum, à envoyer dans les 15 minutes. Le lien renvoyé fonctionne pendant 2 heures, et le fichier est supprimé après 2 jours. Les liens d’envoi nécessitent du crédit sur le compte.

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

Sécurité

• La connexion suit la spécification MCP : OAuth 2.1 avec PKCE (S256 uniquement), adresses de redirection enregistrées uniquement et codes à usage unique valables 5 minutes. Toute réutilisation d’un code révoque les jetons obtenus avec celui-ci.
• Les jetons sont aléatoires et stockés uniquement sous forme de hachages SHA-256. Les jetons d’accès sont valables une heure et ne fonctionnent que sur le serveur MCP. Les jetons d’actualisation changent à chaque utilisation ; si un jeton est réutilisé plus d’une minute après, il a été copié : la connexion est alors interrompue et sa clé révoquée.
• Chaque connexion correspond à une clé sur votre page Clés, avec sa propre limite quotidienne, visible par les membres de votre espace de travail. Révoquer cette clé ou quitter l’espace de travail déconnecte l’application.
• La page de consentement ne peut pas s’afficher dans un autre site. Elle vous indique si Zurelay ne reconnaît pas l’application et vers quelle adresse vous serez redirigé.
• Les liens d’envoi sont signés, acceptent un seul fichier et expirent après 15 minutes ; les fichiers envoyés sont supprimés après 2 jours.
• Chaque clé et chaque espace de travail ont leur propre limite de fréquence pour les appels MCP, et chaque appel d’un lot est comptabilisé.

Pour les développeurs

Le serveur utilise MCP 2025-11-25 (ainsi que 2025-06-18, 2025-03-26 et 2024-11-05) via Streamable HTTP : envoyez du JSON-RPC par POST à https://api.zurelay.com/mcp et recevez du JSON en retour. Il ne conserve aucune session : il n’y a donc pas d’événements envoyés par le serveur et GET renvoie 405. Sans jeton, il renvoie 401 avec WWW-Authenticate pointant vers https://api.zurelay.com/.well-known/oauth-protected-resource/mcp ; les métadonnées du serveur d’autorisation sont disponibles à l’adresse https://api.zurelay.com/.well-known/oauth-authorization-server, avec prise en charge de l’enregistrement dynamique des clients.

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

Dépannage

• zurelay n’apparaît pas dans /mcp de Claude Code : il a été ajouté pour un autre dossier, ou Claude Code était déjà en cours d’exécution. Quittez Claude Code, exécutez la commande ci-dessus (avec --scope user) dans un terminal classique, puis relancez Claude Code. claude mcp list indique qu’une authentification est nécessaire tant que vous ne vous êtes pas connecté.
• L’application vous demande sans cesse de vous connecter : la clé qu’elle a créée a été révoquée, ou sa connexion n’a pas été utilisée depuis un an. Reconnectez l’application.
• “Votre solde Zurelay est vide” ou “a atteint son budget quotidien” : ajoutez du crédit sur la page Facturation, ou augmentez la limite de la clé sur la page Clés.
• “Ce jeton appartient à une application connectée via le serveur MCP de Zurelay” : vous avez envoyé le jeton d’une application à l’API. Utilisez une clé API pour celle-ci.
• Une vidéo semble bloquée : demandez à l’IA d’appeler get_result à nouveau ; les vidéos prennent 1 à 5 minutes, parfois plus lorsqu’un modèle est très sollicité.