Annuel Payez à l'année et profitez de 2 mois offerts sur chaque offre payante. Voir les offres
Se connecter Commencer gratuitement

Le serveur MCP de ToRun

Dernière mise à jour : 11 nov. 2026

De quoi s’agit-il

Le serveur MCP de ToRun permet à un agent de code d’utiliser ToRun pendant qu’il travaille sur votre projet. Un agent qui prend en charge les serveurs MCP distants, comme Claude Code, Cursor ou opencode, peut créer des images, de la voix, de la musique et de la vidéo, retoucher des images, transcrire de l’audio, lancer des recherches approfondies et les modèles de workflow de ToRun, et publier une page HTML ou un jeu sur navigateur sous forme de lien, sans que vous quittiez votre éditeur. Ce que l’agent crée est payé depuis votre compte ToRun aux mêmes prix que dans l’application, et enregistré dans votre compte ToRun comme tout ce que vous créez dans l’application.

Adresse et connexion

Adresse du serveur https://mcp.torun.ai/mcp
Transport HTTP (serveur MCP distant)
Connexion Authorization: Bearer <your developer key>

Une clé développeur commence par trn_live_. Vous la créez sur la page Développeurs de votre compte ToRun : voir Clés développeur. Configuration pour chaque outil :

Outils

Outil Ce qu’il fait Payant
image_generate Crée des images à partir d’un prompt : sprites, icônes, arrière-plans, illustrations. Renvoie les images, ou un identifiant de tâche quand elles prennent plus de temps que l’attente choisie par l’agent. Oui
image_edit Modifie une image à partir d’une instruction écrite : un nouvel arrière-plan, une autre couleur, un objet ajouté ou retiré, un autre style. L’image est une image créée par l’agent avec ToRun ou un lien vers un fichier PNG, JPEG ou WebP de 20 Mo maximum ; une image donnée par lien est d’abord enregistrée dans votre bibliothèque ToRun. Renvoie les images ou un identifiant de tâche, comme image_generate. Oui
tts_generate Transforme un texte en voix et renvoie le fichier audio et sa durée de lecture, mesurée à partir du fichier. Oui
stt_transcribe Transforme en texte la parole d’un fichier audio ou vidéo, avec des segments horodatés pour les sous-titres quand l’agent les demande. Accepte les fichiers mp3, m4a, wav, webm, ogg, opus, flac, aac et mp4 jusqu’à 25 Mo. Oui
music_generate Compose une piste, avec ou sans voix, et renvoie un identifiant de tâche. Oui
video_generate Crée un clip court à partir d’un prompt et renvoie un identifiant de tâche. Oui
job_status Indique l’état d’une tâche d’image, de musique ou de vidéo et renvoie le fichier quand il est prêt. Gratuit
deep_research_start Lance une recherche approfondie sur une question : elle cherche sur le web dans de nombreuses sources et rédige un rapport avec ses sources citées. Renvoie un identifiant de tâche. Oui
deep_research_status Indique l’état d’une recherche approfondie et renvoie le rapport quand il est prêt. Gratuit
workflow_template_search Trouve les modèles de workflow de ToRun, des chaînes de traitement en plusieurs étapes prêtes à l’emploi, et montre ce que produit chacun, ce qu’il coûte habituellement et les entrées qu’il attend. Gratuit
workflow_run Exécute un modèle de workflow avec les entrées que l’agent lui donne et renvoie un identifiant de tâche. Oui
workflow_run_status Indique l’état d’une exécution de workflow et les Runs qu’elle a coûté jusqu’ici, et renvoie ses résultats quand ils sont prêts. Gratuit
canvas_publish Publie sous forme de lien une page HTML en un seul fichier ou un jeu sur navigateur. Gratuit
account_balance Affiche l’allocation du forfait et le portefeuille restants, ainsi que la limite mensuelle et les dépenses de cette clé. Gratuit

Un lien de fichier renvoyé par un outil se télécharge sans connexion, si bien que l’agent peut enregistrer le fichier dans votre projet. Conservez le lien entier, y compris la partie après le point d’interrogation.

Une page publiée n’est pas répertoriée : toute personne qui a le lien peut l’ouvrir, mais elle n’apparaît pas dans Explorer de ToRun et les moteurs de recherche ne l’indexent pas.

Tâches longues

La musique, la vidéo, les recherches approfondies et les exécutions de workflow prennent plus de temps qu’un appel. L’outil renvoie un identifiant de tâche, et l’agent redemande jusqu’à ce que le résultat soit prêt : job_status pour les images, la musique et la vidéo, deep_research_status pour un rapport de recherche et workflow_run_status pour une exécution de workflow. Une image qui n’est pas prête dans le délai d’attente choisi par l’agent revient elle aussi sous forme d’identifiant de tâche.

Une recherche dure de 1 à 10 minutes et continue même si la conversation avec votre agent se termine ; le rapport apparaît aussi comme une conversation à part entière dans votre liste de chats ToRun. Une exécution de workflow dure d’une minute à plusieurs dizaines de minutes, et l’exécution et ses fichiers apparaissent dans votre compte ToRun. Un long rapport ou une longue série de résultats arrive en plusieurs parties, et l’agent demande la suite.

Comment les appels sont payés

  • Chaque appel payant est facturé en Runs aux mêmes prix que dans l’application.
  • Il est payé d’abord sur l’allocation de votre forfait, puis sur votre portefeuille si vous l’avez autorisé pour la clé.
  • L’allocation gratuite ne paie jamais les appels API.
  • Une exécution de workflow est facturée étape par étape pendant qu’elle s’exécute.
  • Chaque débit apparaît sur votre page de facturation, sous la clé qui l’a effectué.

Un appel au-dessus du seuil de la clé demande d’abord

Chaque clé a un seuil. Quand un seul appel coûterait plus que ce seuil, l’outil ne l’exécute pas encore. Pour une exécution de workflow, c’est l’estimation de l’exécution qui est comparée.

  • Si votre outil peut afficher un formulaire quand un serveur MCP pose une question (MCP elicitation), ToRun vous demande là : le formulaire affiche le prix et demande s’il faut continuer. L’appel s’exécute si vous acceptez ; si vous refusez, rien n’est exécuté.
  • Sinon, l’outil répond avec le prix, votre agent vous le montre, et l’appel ne s’exécute que lorsque l’agent le relance après votre accord.

Demander ne coûte rien.

Limites

Chaque clé a une limite de dépense mensuelle et une limite quotidienne, ainsi qu’une limite d’appels par minute. Chaque compte a aussi une limite quotidienne de pages publiées. Vous fixez la limite mensuelle et le seuil d’une clé lors de sa création ; les valeurs par défaut sont indiquées sur torun.ai/developers. Pour les modifier, créez une nouvelle clé avec les paramètres souhaités et révoquez l’ancienne.

Quand un appel est refusé

Ce qui est dit à l’agent Que faire
L’appel nécessite une clé développeur Vérifiez que TORUN_API_KEY contient la clé entière et que la clé n’a pas été révoquée.
L’allocation du forfait est épuisée et la clé n’est pas autorisée à dépenser depuis le portefeuille Attendez le renouvellement de l’allocation, ou créez une clé autorisée à dépenser depuis le portefeuille.
Les clés développeur ne dépensent que l’allocation d’un forfait payant ou le portefeuille Rechargez ou abonnez-vous.
La clé a atteint sa limite de dépense mensuelle ou quotidienne Attendez le jour ou le mois suivant, ou créez une clé avec une limite plus élevée.
La clé a fait trop d’appels en une minute Patientez un instant puis réessayez.
La clé n’a pas la portée dont un outil a besoin Les portées d’une clé ne peuvent pas être modifiées. Créez une nouvelle clé : une nouvelle clé dispose de toutes les portées.
Le fichier doit être donné par un identifiant de la bibliothèque ToRun ou par un lien https, pas les deux Donnez exactement l’un des deux.
Ce fichier n’existe pas dans la bibliothèque ToRun du compte Utilisez un fichier de ce compte. Un lien ToRun vers le fichier d’un autre compte est refusé de la même manière.
Le fichier est trop volumineux, n’est pas dans un format accepté par l’outil ou n’a pas pu être téléchargé Images pour image_edit : PNG, JPEG ou WebP, jusqu’à 20 Mo. Fichiers pour stt_transcribe : mp3, m4a, wav, webm, ogg, opus, flac, aac ou mp4, jusqu’à 25 Mo. Un lien doit pouvoir se télécharger sans connexion.