MCP et agents IA

Utiliser avec des agents IA#

Utilisez Serveur MCP pour demander à un assistant de créer des médias pour vous, par exemple dans le chat de Claude Code ou de Cursor. Utilisez Agent Skill lorsqu’un agent écrit du code qui appelle l’API. Vous pouvez utiliser les deux : si les outils MCP sont connectés, la compétence indique également aux agents de les privilégier.

URL du serveur et connexion#

• Transport : HTTP Streamable, sans état. Compatible avec les clients utilisant les versions 2025 et 2026-07-28 du protocole MCP.
• Connexion : OAuth 2.1, conforme à la spécification d’autorisation MCP. À la première connexion, le client ouvre une page CheaperGen dans votre navigateur. Connectez-vous et autorisez l’application. Les applications autorisées sont répertoriées dans Tableau de bord → Clés API → Applications connectées, où vous pouvez les déconnecter à tout moment.
• Sans interface et CI : Envoyez plutôt une clé API, comme indiqué dans Authorization: Bearer cg_live_…. Voir Utiliser une clé API.

Connecter un client#

Claude (claude.ai et Claude Desktop)#

1. Ouvrez Personnaliser → Connecteurs et ajoutez un connecteur personnalisé.
2. Nommez-le CheaperGen, collez l’URL ci-dessus et choisissez Ajouter.
3. Choisissez Connecter, connectez-vous à CheaperGen et autorisez l’accès. Activez ensuite le connecteur dans un chat depuis le menu des outils.

Avec les offres Team et Enterprise, un propriétaire doit parfois d’abord ajouter le connecteur pour l’organisation. Les connecteurs ajoutés sur claude.ai apparaissent aussi dans Claude Desktop.

Claude Code#

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

Exécutez ensuite /mcp, sélectionnez cheapergen et choisissez Authentifier (ou lancez claude mcp login cheapergen dans un terminal). Votre navigateur s’ouvre pour vous connecter et autoriser l’accès. Ajoutez --scope user pour l’utiliser dans tous vos projets. Vous pouvez aussi installer le plugin, qui configure le serveur et le Agent Skill en une seule étape :

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

ChatGPT#

Application de bureau (macOS et Windows). En mode Work ou Codex, l’application de bureau ChatGPT utilise les mêmes paramètres MCP que le CLI Codex, ce qui permet à codex mcp add de s’y connecter également. Vous pouvez aussi l’ajouter depuis l’application :

1. Ouvrez Settings → MCP servers → Add server.
2. Nommez-le cheapergen, choisissez HTTP Streamable, collez l’URL ci-dessus et enregistrez.
3. Sélectionnez Redémarrer, puis Authentifier, et connectez-vous à CheaperGen pour autoriser l’accès. Saisissez /mcp dans le champ de rédaction pour vérifier la connexion.

chatgpt.com. Les serveurs MCP personnalisés deviennent des plugins, disponibles dans les espaces de travail ChatGPT Business, Enterprise et Edu (sur Business, seuls les administrateurs et propriétaires peuvent les ajouter). Ajoutez-les depuis le Web, et non depuis l’application mobile :

1. Ouvrez Plugins → + → Add custom MCP server.
2. Nommez-le CheaperGen, collez l’URL ci-dessus et choisissez OAuth pour l’authentification.
3. Cochez la case « J’ai compris et je souhaite continuer », choisissez Créer comme plugin, puis installez le plugin, connectez-vous et autorisez l’accès.
4. Dans un chat, saisissez @ et sélectionnez le plugin. ChatGPT vous demande confirmation avant d’exécuter generate ou add_credits.

Codex#

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

Cette commande ajoute le serveur à ~/.codex/config.toml et ouvre immédiatement votre navigateur pour vous connecter. Vous avez ignoré cette étape ? Exécutez codex mcp login cheapergen. La CLI Codex, l’extension Codex pour IDE (menu engrenage → MCP servers) et l’application de bureau ChatGPT lisent toutes ce fichier : une seule configuration suffit. Les tâches Codex dans le cloud ne le lisent pas. Pour modifier le fichier manuellement :

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

Cursor#

Ajoutez cette configuration à ~/.cursor/mcp.json (tous les projets) ou à .cursor/mcp.json (un seul projet). Ouvrez ensuite Customize → MCPs et connectez cheapergen. Dans la CLI Cursor, exécutez cursor-agent mcp enable cheapergen, puis cursor-agent mcp login cheapergen.

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

VS Code (GitHub Copilot)#

Ajoutez cette configuration à .vscode/mcp.json, ou exécutez MCP: Add Server… et choisissez HTTP. VS Code vous demande de vous connecter au premier démarrage du serveur. Utilisez ensuite les outils dans le mode agent de Copilot Chat.

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

Autres clients#

Les clients qui prennent en charge les serveurs distants et OAuth n’ont besoin que de l’URL (certains utilisent "serverUrl" à la place de "url"). Les clients qui ne lancent que des serveurs locaux (stdio) peuvent passer par le pont mcp-remote, qui nécessite Node.js et gère la connexion.

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

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

Utiliser une clé API (sans interface, CI)#

Si la connexion via navigateur est impossible, envoyez une clé API obtenue sur Tableau de bord → Clés API. Créez une clé distincte pour chaque agent afin de pouvoir la révoquer indépendamment. Conservez-la dans une variable d’environnement, comme ci-dessous : les guillemets simples contiennent le nom de la variable, et non la clé ; le client lit sa valeur lors de la connexion. Claude Code développe également ${CHEAPERGEN_API_KEY} à partir de l’environnement de chaque développeur dans un fichier .mcp.json versionné.

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

Outils#

Chaque outil reprend le même code que l’API REST (Référence de l’API) : les prix, validations et erreurs sont identiques. Les résultats sont renvoyés sous forme de JSON compact. Une image terminée est aussi renvoyée sous forme de petit aperçu intégré, pour que le chat l’affiche et que l’agent puisse la vérifier, et chaque fichier de sortie sous forme de lien de ressource à afficher ou télécharger.

Les images sont généralement générées en un seul appel generate. Les vidéos prennent une à plusieurs minutes : l’agent envoie la tâche, puis appelle get_generation avec wait_seconds jusqu’à sa fin. Un generate terminé renvoie :

{
  "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": "Officiel",
    "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": "Terminé. Affichez ou téléchargez les URL de sortie avant outputs_expire_at."
}

Exemples de prompts#

• “Quels modèles vidéo CheaperGen acceptent les vidéos de référence, et combien coûteraient 5 secondes en 720p avec chacun ?”
• “Génère une vidéo de 5 secondes en 720p avec Seedance 2.0 Fast : un bateau en papier dérive dans une rue néon sous la pluie, avec un lent travelling avant. Indique-moi d’abord le prix.”
• “Créez quatre photos produit de cette tasse avec Seedream 5.0 Lite, chacune à moins de $0.05 : https://example.com/mug.png”
• “Anime cette photo en un clip vertical de 6 secondes avec Wan 3.0 : https://example.com/portrait.jpg”
• “Anime la photo de mon bureau (~/Desktop/beach.jpg) en un clip de 5 secondes avec Kling 3.0. Donne-moi d’abord le prix.”
• “Vidéo de référence avec Seedance 2.0 : @Image1 est le personnage, @Image2 la rue ; déplace la caméra comme dans @Video1. Voici les URL : …”
• “Quel est le solde de mon compte CheaperGen et combien de clips Seedance 2.0 de 10 secondes en 1080p puis-je payer ?”

Agent Skill#

La compétence CheaperGen est un seul fichier SKILL.md au format Agent Skills. Elle décrit l’ensemble du processus pour un agent : choisir un modèle, lire son schéma, estimer le prix, envoyer la tâche, l’interroger ou vérifier les webhooks, gérer les mentions de référence, les importations, les tarifs et les erreurs. Les agents ne la chargent que pour les tâches qui en ont besoin. Pour les appels REST, elle lit la clé dans CHEAPERGEN_API_KEY et privilégie les outils MCP lorsqu’ils sont connectés. La source se trouve dans 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

La CLI Skills installe la compétence dans Claude Code, Cursor, Codex, Gemini CLI et d’autres agents (-a en installe une, -g dans tous les projets). Dans les applications Claude, compressez le dossier cheapergen en ZIP et importez-le comme compétence personnalisée.

Limites et facturation#

• Les mêmes limites de débit que pour l’API REST s’appliquent à chaque application ou clé connectée (chaque requête MCP est comptabilisée), ainsi que la limite par compte du nombre de générations en cours.
• Lorsque generate envoie une requête, son prix est réservé puis intégralement remboursé si la génération échoue ou est annulée. Voir Facturation et crédits.
• Les générations lancées par MCP apparaissent dans votre tableau de bord et dans GET /api/v1/generations avec source: "mcp".
• Les jetons de connexion durent une heure et le client les renouvelle automatiquement. Déconnecter l’application dans le tableau de bord met immédiatement fin à son accès.
• Les URL des résultats sont publiques et expirent selon la durée de conservation des données API (un jour par défaut). Téléchargez ce que vous souhaitez garder.

Dépannage#

• Le client indique que le serveur nécessite une authentification : Reprenez la connexion à partir de la demande initiale (dans Claude Code : /mcp → cheapergen → Authenticate). Si vous avez déconnecté l’application ou ne l’avez pas utilisée depuis 90 jours, reconnectez-vous.
• La page de connexion indique que l’application n’est pas enregistrée ou que l’URL de redirection ne correspond pas : Supprimez le serveur du client, puis ajoutez-le de nouveau pour que le client l’enregistre à nouveau.
• Un appel d’outil expire : Réduisez wait_seconds. La génération continue dans tous les cas ; récupérez-la plus tard avec get_generation.
• Si invalid_request:, les entrées ne correspondent pas au schéma du point de terminaison. L’erreur indique le champ dans param ; demandez à l’agent d’appeler d’abord get_model.