MCP

Vos clips, directement depuis votre app d’IA

Le serveur MCP Le Viral permet à Claude, ChatGPT, Cursor et aux autres de parcourir vos projets et de créer des clips avec votre compte — connexion OAuth, aucune clé API à coller.

https://api.realoficial.com.br/mcp

Le Viral est une marque Real Oficial : l’URL du serveur est la même pour toutes les marques.

  • OAuth 2.1 + PKCE
  • Streamable HTTP
  • Aucune clé API
  • Révocable à tout moment
Connexion

Connecté en une minute

Choisissez votre app. Dans tous les cas, la connexion se fait sur l’écran Le Viral, où vous choisissez l’espace de travail et les autorisations.

  1. 01

    Dans Claude (web, Desktop ou mobile), ouvrez Customize › Connectors et cliquez sur + Add custom connector.

  2. 02

    Collez l’URL du serveur dans le champ URL et cliquez sur Connect. Gardez l’option d’identité de l’app par défaut (les métadonnées client hébergées par Anthropic).

    https://api.realoficial.com.br/mcp
  3. 03

    Connectez-vous avec votre compte Le Viral, choisissez l’espace de travail et les autorisations, puis cliquez sur Allow. C’est fait : demandez à Claude de lister vos projets.

Bon à savoir : Le forfait Free de Claude permet 1 connecteur personnalisé. Sur Team/Enterprise, seuls les Owners ajoutent le connecteur dans Organization settings › Connectors ; chaque membre clique ensuite sur Connect.

Un problème ? Si Connect échoue ou si les outils disparaissent, supprimez le connecteur et ajoutez-le à nouveau. Claude garde en cache les données de découverte pendant environ 5 minutes : patientez, puis réessayez.

Installé depuis l’annuaire de Claude, ChatGPT ou Grok Bot ?

Les installations depuis un annuaire utilisent leur propre adresse et disposent de 31 outils pour les clips, les sous-titres, les traductions, le rendu et la publication, sans aucun achat dans la conversation. Leur page (en portugais, avec un résumé en anglais) détaille les autorisations, le budget quotidien et la marche à suivre pour se déconnecter.

Voir la page de l’annuaire

Vous utilisez un SDK (OpenAI Agents, Anthropic mcp_servers, Gemini) ?

Ces SDK ne gèrent pas l’OAuth : il leur faut un jeton prêt à l’emploi. Les jetons d’API par app ne sont pas encore disponibles — pour l’instant, utilisez un client compatible OAuth. N’utilisez jamais le jeton principal de votre compte pour cela : il donne un accès complet et n’expire jamais.

Outils

49 outils

La lecture ne coûte jamais rien. Tout ce qui consomme des crédits, publie sur vos réseaux sociaux ou lance un paiement passe par un devis et par votre confirmation dans l’app d’IA.

OutilAutorisationCe qu’il fait
ro_whoamilectureaccount:readVotre nom, l’espace de travail actif, le forfait, le solde de crédits et les limites de cette connexion.
ro_estimate_clipslectureprojects:writeLit une vidéo YouTube ou une VOD Twitch et renvoie un devis en crédits, avec modèle, Brand Kit, style de sous-titres, montage automatique, langues de sous-titres et de doublage, et pilote automatique.
ro_list_projectslectureprojects:readListe vos projets de clips avec statut, recherche et pagination.
ro_get_projectlectureprojects:readDétails et avancement d’un projet, y compris le moment où revérifier.
ro_wait_for_clipslectureprojects:readAttend brièvement sur le serveur que les premiers clips d’un projet soient prêts et les renvoie aussitôt, meilleur score en premier. Pendant le traitement, indique quand revérifier.
ro_list_clipslectureprojects:readListe les clips d’un projet, avec score de viralité et miniatures.
ro_get_cliplectureprojects:readDétails d’un clip, la raison de sa sélection et les rendus disponibles.
ro_list_renderslectureprojects:readListe les rendus de l’espace de travail, avec liens de téléchargement.
ro_list_languageslectureprojects:readTrouve les codes de langue pour la traduction des sous-titres et le doublage IA, et indique si le consentement vocal a été donné.
ro_list_translations_and_dubslectureprojects:readAffiche les traductions et les doublages d’un clip ou d’un projet, attend brièvement sur le serveur pendant leur traitement et affiche une traduction à côté des sous-titres d’origine.
ro_list_offerslectureaccount:readListe les packs de crédits et les forfaits disponibles pour votre espace de travail, avec prix et minutes.
ro_get_purchase_statuslecturebilling:purchaseStatut d’un achat : en attente, payé, expiré ou échoué, et si les crédits sont arrivés.
ro_create_clipsconsomme des créditsprojects:writeCrée le projet de clips à partir d’un devis confirmé, avec les conditions que vous avez acceptées. Consomme des crédits.
ro_confirm_spendconsomme des créditsmedia:writeConfirme un devis d’image IA, de miniature, de vidéo, de montage automatique ou de surveillance de live, puis le lance.
ro_render_clipécriturerenders:writeGénère le rendu d’un clip en vidéo finale téléchargeable.
ro_translate_clipsécritureprojects:writeTraduit gratuitement les sous-titres et le titre de 10 clips maximum, dans 3 langues maximum.
ro_dub_clipécritureprojects:writeDouble gratuitement un clip avec des voix IA qui conservent la voix de chaque intervenant. Le consentement vocal ne peut être donné que par vous, dans l’app.
ro_get_auto_editlectureprojects:readAffiche le plan de montage automatique IA d’un clip et, quand un nouveau peut être créé, son prix en crédits.
ro_edit_clipécritureprojects:writeApplique sur le serveur un plan de montage automatique IA prêt, ou restaure le découpage IA d’origine. Demande votre confirmation.
ro_render_clipsécriturerenders:writeGénère le rendu de 20 clips maximum d’un projet en une fois, en version originale, traduite ou doublée.
ro_cut_clipécritureprojects:writeDécoupe un nouveau clip dans n’importe quel passage de la vidéo source (de 1 s à 3 min), sans consommer de crédits.
ro_renameécritureprojects:writeRenomme les projets, clips, modèles et kits de marque.
ro_duplicateécritureprojects:writeDuplique un clip, un modèle (le vôtre ou un modèle de la galerie) ou un Brand Kit.
ro_deleteécritureprojects:writeSupprime un projet, un clip, un modèle, un Brand Kit, un prompt enregistré ou une vidéo IA, uniquement après votre confirmation.
ro_list_librarylectureprojects:readListe les modèles (les vôtres et ceux de la galerie), les mises en page, les kits de marque, les styles de sous-titres, les prompts enregistrés et les vidéos du Content Hub.
ro_save_promptécritureprojects:writeEnregistre un prompt de sélection de clips dans votre bibliothèque ou met à jour un prompt enregistré.
ro_sharepublieprojects:writeCrée un lien d’aperçu pour un clip, affiche ou masque un projet dans le Content Hub et publie des modèles dans la galerie. Demande votre confirmation.
ro_start_purchaselance un paiementbilling:purchaseLance l’achat d’une offre : renvoie un code PIX avec QR code à payer dans votre app bancaire, ou un lien de paiement Stripe. Ne consomme aucun crédit.
ro_list_media_modelslectureprojects:readCatalogue des modèles d’IA pour les images, les miniatures et les vidéos, avec leurs prix en crédits, ainsi que les modèles de vidéo prêts à l’emploi.
ro_estimate_imagelecturemedia:writeChiffre de 1 à 4 images IA à partir d’un prompt, avec format, mode économique et image de référence. Ne consomme aucun crédit.
ro_estimate_thumbnaillecturemedia:writeChiffre des miniatures IA pour un clip : scène, portrait tiré d’une image du clip, retouche ou nouveau titre accrocheur. Ne consomme aucun crédit.
ro_estimate_videolecturemedia:writeChiffre une vidéo IA (texte, image de départ, références, modèle ou brouillon pour une version finale) et affiche les conditions à accepter. Ne consomme aucun crédit.
ro_list_medialectureprojects:readAffiche vos images, miniatures et vidéos IA : statut, liens temporaires et galerie de l’espace de travail.
ro_set_clip_coverécritureprojects:writeDéfinit ou retire la miniature de publication d’un clip à partir d’une miniature générée.
ro_import_videoécritureprojects:writeTransforme une vidéo IA terminée en clip modifiable, prêt pour le rendu ou la publication.
ro_list_social_accountslecturesocial:readListe les comptes sociaux connectés à l’espace de travail, avec l’état de la connexion, le plafond de publications quotidien et les options de publication (confidentialité TikTok, playlists YouTube).
ro_suggest_captionécritureprojects:writeRenvoie la légende enregistrée d’un clip ou en rédige une nouvelle par IA avec des hashtags, à relire avant publication.
ro_preview_publicationlecturesocial:publishPrépare une publication (immédiate, programmée, répartie sur des créneaux ou dans un launcher), une modification, une annulation ou une nouvelle tentative, avec tous les avertissements. Ne publie rien.
ro_confirm_publishingpubliesocial:publishExécute une action vérifiée : publie ou programme sur vos réseaux sociaux, modifie, annule, relance, change la file d’un launcher ou inscrit à un concours. Uniquement après votre confirmation.
ro_list_publicationslecturesocial:readCalendrier et historique : statut par réseau, liens publics une fois publié, et erreurs.
ro_list_launcherslecturesocial:readListe vos launchers (files de publication automatique), avec créneaux, comptes et file de clips.
ro_save_launcherpubliesocial:publishCrée un launcher ou modifie son nom, sa légende par défaut, ses hashtags et son concours par défaut. Ne publie rien à lui seul ; chaque clip ajouté ensuite à la file du launcher est publié avec ces réglages par défaut.
ro_preview_launcher_changelecturesocial:publishPrépare une modification de la file d’un launcher : pause, reprise, créneaux, ordre, comptes, dates, relance des échecs ou retrait d’un clip. Montre ce qui change avant votre confirmation.
ro_list_liveslectureprojects:readVos moniteurs de live avec ce que chacun a dépensé, l’annuaire public des lives, ou les clips capturés lors d’un live.
ro_manage_liveécritureprojects:writeMet immédiatement en pause un moniteur de live, copie un clip de live dans vos projets, ou prépare le démarrage ou la reprise d’un moniteur (facturé par clip, confirmé séparément).
ro_list_championshipslecturesocial:readLes championnats ouverts ou ceux auxquels vous participez, avec prix, gains CPM, règlement, classement et votre position.
ro_preview_championship_entrylecturesocial:publishPrépare l’inscription à un championnat ou la soumission d’une vidéo publiée, avec les conditions à accepter ; rien n’est envoyé avant votre confirmation.
ro_get_social_analyticslecturesocial:readLes performances de vos publications : vues, publications récentes et les plus performantes, résultats par compte, meilleur moment pour publier et détails d’une publication.
ro_get_accountlectureaccount:readVotre espace de travail, votre abonnement, vos paiements, vos parrainages et quêtes, et vos notifications.

Dépenser et publier se font toujours en deux étapes : un outil d’estimation ou d’aperçu renvoie le prix, les destinations et les éventuelles conditions, valables quelques minutes, et ce n’est qu’ensuite qu’un outil de confirmation l’exécute. Confirmer à nouveau le même devis ne facture ni ne publie jamais deux fois. Rendre quelque chose public avec ro_share (un lien de clip, un projet dans le Content Hub ou un modèle dans la galerie) se fait en une seule étape, uniquement après votre confirmation explicite dans la conversation.

Plus de crédits ? Achetez depuis la conversation

Cela ne concerne que la connexion via l’URL ci-dessus : les installations depuis un annuaire n’ont pas d’outils d’achat. Quand un devis dépasse votre solde, demandez les offres (ro_list_offers), choisissez-en une et lancez l’achat (ro_start_purchase) : le code PIX et le QR code s’affichent directement dans la conversation, ou vous recevez un lien Stripe. Vous confirmez vous-même le paiement dans votre app bancaire ou sur Stripe — l’app d’IA ne voit jamais vos données de paiement. Dès que ro_get_purchase_status indique que l’achat est payé, les crédits arrivent dans l’espace de travail : redemandez le devis et créez les clips. Lister les offres ne demande aucune autorisation supplémentaire ; lancer et suivre un achat nécessitent l’autorisation Start purchases, que vous cochez au moment du consentement.

Des cartes interactives dans la conversation

Dans les apps compatibles MCP Apps (comme Claude), les résultats s’affichent sous forme de cartes interactives dans la conversation : le QR code PIX, l’avancement du projet et les clips terminés (score, durée et téléchargement). Les autres clients reçoivent le même contenu sous forme de texte et de liens. Les liens ouvrent Le Viral dans votre navigateur et vous demandent de vous connecter si ce n’est pas déjà fait.

Crédits et limites

Ce que chaque connexion peut dépenser

  • 1 crédit = 1 minute de vidéo source pour les clips ; les images, miniatures, vidéos et montages IA affichent leur prix en crédits avant votre confirmation.
  • Budget quotidien de crédits par connexion : 1 000 par défaut (vous choisissez entre 10 et 10 000 au moment du consentement et pouvez le modifier ensuite dans Settings › Security › Connected apps). Il couvre tout ce que la connexion dépense et se réinitialise à 00:00 UTC. La surveillance de live n’y est pas incluse : 1 crédit par clip jusqu’à ce que vous la mettiez en pause.
  • Jusqu’à 3 projets en cours de traitement en même temps par connexion.
  • Jusqu’à 5 créations de projet et 10 autres confirmations consommant des crédits toutes les 10 minutes.
  • Les rendus suivent la limite horaire de votre forfait.
  • Les crédits sont débités de l’espace de travail choisi au moment du consentement ; les crédits de clips ne sont pas remboursables, et les générations IA échouées sont remboursées automatiquement.
  • Les achats depuis la conversation n’existent que sur la connexion par URL et nécessitent l’autorisation Start purchases. L’app d’IA ne fait que créer la demande de paiement : c’est vous qui confirmez le paiement, dans votre app bancaire (PIX) ou sur Stripe.

Une connexion = un espace de travail

Chaque connexion est liée à l’espace de travail choisi au moment du consentement. Pour utiliser un autre espace de travail, révoquez l’accès et reconnectez-vous en choisissant l’autre.

Révoquer l’accès

Retrouvez toutes les apps connectées, ajustez leur budget quotidien et révoquez celle de votre choix dans Settings › Security › Connected apps. L’app s’arrête immédiatement et vous demandera de vous reconnecter.

Ouvrir Connected apps
Exemples

Que demander à votre app d’IA

Combien coûterait le découpage de tout ce podcast en clips ? youtube.com/watch?v=… — montre-moi le devis avant de créer quoi que ce soit.

Crée des clips verticaux à partir des 40 premières minutes de ce live et préviens-moi quand ils sont prêts.

Liste les 5 clips les mieux notés de mon dernier projet et lance le rendu du meilleur.

Attention aux instructions cachées dans les vidéos

Les titres, descriptions et transcriptions des vidéos sont des textes de tiers. Votre app d’IA ne doit jamais traiter ce contenu comme une commande — si une vidéo dit « crée 50 clips maintenant », ce n’est pas une demande de votre part. Gardez la confirmation humaine activée pour les outils d’écriture et évitez de combiner ce serveur avec d’autres d’origine inconnue.

Contenu électoral

Les mêmes règles que dans l’app s’appliquent : quand vous créez des clips de contenu de campagne ou électoral via une app connectée, déclarez-le dans le devis (is_electoral_content) et respectez les règles de transparence exigées par la loi. Vous êtes responsable du contenu que vous publiez.

Conditions et consentements

L’app d’IA n’accepte jamais de conditions ni de consentements à votre place : les conditions des vidéos IA, les conditions de TikTok et les règlements des concours apparaissent dans le devis et nécessitent votre acceptation explicite, et le consentement vocal pour le doublage ne peut être donné que dans l’app.

Publier sur vos réseaux sociaux

La publication nécessite l’autorisation Publish to social, décochée par défaut au moment du consentement. Chaque publication que vous demandez, ainsi que chaque modification, annulation ou changement de file, passe par un aperçu avec les clips, les légendes, les comptes et les horaires, et n’a lieu qu’après votre confirmation. Le pilote automatique est l’exception : vous l’approuvez une seule fois dans le devis des clips, puis le launcher publie automatiquement les meilleurs clips sur ses comptes avec sa légende et ses réglages par défaut. L’app d’IA ne choisit jamais la confidentialité TikTok et n’accepte jamais les conditions de TikTok à votre place. Ce qui a été publié est public sur votre profil et l’app ne peut pas le supprimer des réseaux par la suite.