# Votre agent IA (MCP)

> Brancher votre agent IA au serveur MCP d'Ondaclip : Claude Code, Cursor, Antigravity ou OpenCode écrivent, vérifient, corrigent et filment vos tutoriels.

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**

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

**Antigravity (agy)**

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

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

```json
{
  "$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`)

```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](mailto:hello@ondaclip.com).

### 4. Dites à votre agent comment changer `.ondaclip/`

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

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

Source: https://ondaclip.com/docs/fr/for-ai-agents/