Votre agent IA (MCP)

Ondaclip a un serveur MCP. Votre agent IA travaille à côté du code de votre application ; par MCP, il pilote aussi Ondaclip : il écrit un tutoriel, vérifie qu’il passe sur votre application, lit ce qui a cassé et pourquoi, le corrige, puis le filme.

Cela marche avec tout agent qui parle MCP : Claude Code, OpenCode, Antigravity, Cursor, et les autres. Venez avec l’agent et le modèle que vous utilisez déjà.

Ce que votre agent peut faire

Outil	Ce qu’il fait
list_products	Les produits que votre jeton atteint, votre rôle, leurs langues et leurs comptes de démo
readiness	Le produit est-il prêt à filmer ? Chaque vérification, et la prochaine action quand l’une échoue
list_tutorials	Les tutoriels publiés, par chapitre, et si chacun correspond encore à l’application
list_problems	Ce qui a cassé : le tutoriel, l’étape et la cause en clair
validate_config	Vérifie .ondaclip/config.yaml avant de le commiter, et dit ce que reçoit chaque produit d’un monorepo (products:)
validate_publication	Vérifie .ondaclip/publication.yaml : langues, chapitres, tutoriels sans fichier
validate_tutorial	Vérifie un fichier de tutoriel avant de le commiter
check	Rejoue des tutoriels sur votre application à une branche, sans filmer (quelques minutes)
run_status	Suit une vérification ou un tournage jusqu’à la fin
film	Filme des tutoriels : capture, voix dans chaque langue, montage
add_product	Jeton admin : ajoute un produit à votre espace ; la réponse dit la prochaine étape d’installation
setup_product	Jeton admin : une étape de l’installation (dépôt, où ça tourne : cloud pour Ondaclip Cloud ou gcp pour votre infrastructure, application, assistant, vérification, mise en service), et la suivante ; les gestes qui demandent une personne viennent avec le lien du studio
set_aside	Met de côté un nouveau tutoriel (pas tourné pour l’instant, avec la raison), ou le remet à tourner
update_product	Jeton admin : la version d’Ondaclip du produit, sa branche de travail, son nom dans products:
set_demo_account	Jeton admin : écrit les comptes de démonstration du produit (jamais relus)
publish	Publie les nouvelles vidéos une fois chaque clip approuvé par une personne dans le studio ; sinon donne le lien de relecture
decide_problem	Classe un problème : un bogue, un changement voulu, ou pas un problème
look_at_tutorial	Montre un tutoriel tel qu’Ondaclip l’a filmé : chaque étape avec sa narration et une image (le dernier tournage ou la vidéo publiée), pour que votre agent le vérifie avant la revue d’une personne
look_at_change	Montre chaque écran qu’une vérification a trouvé différent, la zone changée encadrée en rouge
list_review_notes	Ce que les relecteurs ont rejeté et pourquoi, pour que votre agent corrige le tutoriel après une revue
report_problem	Enregistre un bogue ou un défaut de vidéo vu par votre agent, qu’une personne tranchera
scan_app	Chaque écran de l’application, s’il est filmé, et les éléments qui n’ont pas encore d’identifiant
propose_testids	Ajoute les identifiants manquants dans une pull request en brouillon
voices	Les voix de narration du produit, les voix disponibles, et une pull request pour les changer
integration	Où se trouvent les vidéos publiées et le code qui les affiche dans votre application
stop_run	Arrête une vérification ou un tournage lancé par erreur

La relecture reste dans le studio, pour une personne : votre agent n’approuve jamais un clip, et il publie seulement ce qu’une personne a approuvé. Chaque réponse donne le lien du studio à transmettre à la personne. Un jeton admin (personnel seulement, jamais plus que vous) permet à votre agent les gestes d’installation : la version, la branche, les comptes de démonstration.

Chaque appel suit les mêmes règles que le studio : votre rôle, les produits de votre jeton, votre forfait, et l’environnement où votre produit se filme (DEV).

Le mettre en place

1. Créer un jeton personnel

Dans le studio, page API, Mes jetons personnels, Nouveau jeton : un nom (l’agent), le rôle Producteur, les produits de ce dépôt, une durée de 7 à 365 jours. Copiez le jeton : Ondaclip ne le montre qu’une fois.

Gardez-le hors de votre dépôt : mettez-le dans une variable d’environnement, par exemple ONDACLIP_TOKEN.

2. Ajouter le serveur à votre agent

Le serveur : https://studio.ondaclip.com/mcp (streamable HTTP), avec l’en-tête Authorization: Bearer <votre jeton>.

Claude Code

claude mcp add --transport http ondaclip https://studio.ondaclip.com/mcp \
  --header "Authorization: Bearer $ONDACLIP_TOKEN"

Antigravity (agy)

agy mcp add --header "Authorization: Bearer $ONDACLIP_TOKEN" ondaclip https://studio.ondaclip.com/mcp

OpenCode (opencode.json du dépôt)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ondaclip": {
      "type": "remote",
      "url": "https://studio.ondaclip.com/mcp",
      "headers": { "Authorization": "Bearer {env:ONDACLIP_TOKEN}" }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "ondaclip": {
      "url": "https://studio.ondaclip.com/mcp",
      "headers": { "Authorization": "Bearer ${env:ONDACLIP_TOKEN}" }
    }
  }
}

Un autre agent : donnez-lui l’adresse et l’en-tête ci-dessus. Ondaclip répond en MCP sur streamable HTTP.

3. Donner la compétence Ondaclip à votre agent

La compétence explique à votre agent comment écrire un bon tutoriel, nommer ses data-ondaclip-id, lire un problème et le corriger. Elle vient avec les forfaits Team et Business : écrivez-nous à hello@ondaclip.com.

4. Dites à votre agent comment changer .ondaclip/

Collez ceci dans le AGENTS.md (ou CLAUDE.md) de votre dépôt :

## Ondaclip (video tutorials)
- `.ondaclip/` holds the video tutorials of this repository. Before you change it,
  read https://ondaclip.com/docs/ondaclip-folder/ and the page of the file you change.
- Change only what is asked; never put a secret in it.
- Check every file before you commit: the Ondaclip MCP tools validate_config,
  validate_tutorial, validate_publication (or the JSON schemas of the docs).
- A new tutorial: find the screens in the code, add the missing data-ondaclip-id
  (<area>-<element>-<kind>, only the attributes), write .ondaclip/tutorials/<id>.yaml,
  validate_tutorial, push a branch, check it, fix, then one pull request with the ids
  and the tutorial. Rules: https://ondaclip.com/docs/for-ai-agents/#from-a-need-to-a-pull-request
- Push on a branch and open a pull request; a person reviews the videos in the studio.

D’un besoin à une pull request

Votre agent connaît votre code ; Ondaclip sait le filmer. À partir d’un besoin en mots (« une vidéo pour inviter un collègue »), votre agent :

1. trouve le produit (list_products) et vérifie qu’il est prêt (readiness) ;
2. trouve les écrans de la tâche dans le code : routes, menu, composants des pages ;
3. ajoute les data-ondaclip-id qui manquent sur les éléments que la vidéo montre, clique ou remplit (<zone>-<élément>-<type> ; seulement les attributs, rien d’autre sur ces lignes) ;
4. écrit .ondaclip/tutorials/<id>.yaml et lance validate_tutorial ;
5. pousse une branche et lance check dessus (run_status le suit), lit list_problems, corrige ;
6. ouvre une seule pull request avec les identifiants et le tutoriel, et le résultat de la vérification.

Les règles qu’il suit : lecture seule par défaut (un tutoriel qui enregistre des données liste ses writes et a un cleanup), données fictives seulement (safeEmail, neverShow, hide, fichiers de .ondaclip/fixtures/), chaque texte dans chaque langue du produit, une action par plan, des clips de 50 secondes au plus. Dans un dépôt à plusieurs produits, il écrit dans le dossier de son produit (folder dans list_products). Les identifiants qu’il ajoute sont dans l’application une fois la branche déployée sur l’environnement qu’Ondaclip filme (DEV par défaut).

Demandez à votre agent

• « Ajoute un tutoriel Ondaclip pour inviter un collègue, puis vérifie-le sur cette branche. »
• « Cette pull request change la page des commandes : vérifie les tutoriels Ondaclip qu’elle touche et corrige ceux qui cassent. »
• « Lis les problèmes Ondaclip ouverts et dis-moi lesquels sont des bogues de l’application. »
• « Filme les tutoriels de cette branche. »

Bon à savoir

• Votre agent pousse ses changements sur une branche ; Ondaclip lit les tutoriels à cette branche.
• Une vérification prend quelques minutes ; elle compte dans les exécutions de votre forfait, comme depuis le studio.
• Révoquez un jeton dans la page API : il s’arrête tout de suite.