# Utiliser ces docs avec des assistants IA

> llms.txt, chaque page en Markdown, Ask AI, la spec OpenAPI et le serveur MCP : tout ce qu'un assistant IA doit lire pour intégrer WhatSetter.

Source: https://docs.whatsetter.com/fr/developers/ai-assistants/

Ces docs sont écrites pour les humains et pour les assistants IA. Chaque page existe en Markdown, tout le site tient dans un seul fichier, et un assistant peut agir sur ton compte via le serveur MCP.

## Ce que ces docs exposent aux IA

| Ressource | Où | À quoi ça sert |
|---|---|---|
| Index de toutes les pages | `https://docs.whatsetter.com/llms.txt` | Donner à un assistant la carte des docs en une requête. |
| Tout dans un seul fichier | `https://docs.whatsetter.com/llms-full.txt` | Coller toute la documentation dans un modèle à grand contexte. |
| N'importe quelle page en Markdown | Ajoute `.md` au chemin de la page, ou envoie `Accept: text/markdown` | Fournir une page sans le bruit du HTML. |
| Spec OpenAPI brute | `https://docs.whatsetter.com/openapi.yaml` | Générer un client, valider des requêtes, laisser un assistant lire chaque schéma. |
| Ask AI | Le bouton **Ask AI** dans l'en-tête | Poser une question en anglais, français ou espagnol. Il répond à partir de ces docs uniquement, avec ses sources. |
| Actions de page | **Copy page**, **Open in Claude**, **Open in ChatGPT** dans l'en-tête de la page | Copier le Markdown, ou ouvrir la page dans ton assistant en un clic. |
| Serveur MCP | `https://mcp.whatsetter.com/mcp` | Laisser l'assistant agir sur ton compte : leads, campagnes, prompts, connaissances, contacts bloqués. Voir [Serveur MCP](/fr/developers/mcp/). |

Les URL Markdown suivent la structure du site, dans chaque langue :

```
https://docs.whatsetter.com/developers/quickstart.md
https://docs.whatsetter.com/developers/errors.md
https://docs.whatsetter.com/fr/dashboard/leads.md
https://docs.whatsetter.com/es/developers/webhooks.md
```

```bash
curl -H "Accept: text/markdown" https://docs.whatsetter.com/fr/developers/authentication/
```

## Donner le bon contexte à ton assistant

Mets ce bloc dans le fichier que ton assistant lit au début de chaque session : `CLAUDE.md` pour Claude Code, un fichier de règles pour Cursor, `AGENTS.md` pour Codex.

```markdown
## WhatSetter API

Before using the WhatSetter API, read https://docs.whatsetter.com/llms.txt
and the guide of the resource you need
(for example https://docs.whatsetter.com/developers/guides/leads.md).

- Base URL: https://app.whatsetter.com/api/v1
- The API key is in the WHATSETTER_API_KEY environment variable.
  Never write it in code, in a config file or in a commit.
- Every error is { "error": { "code", "message" } }.
  The codes are listed at https://docs.whatsetter.com/developers/errors.md
- Always send an Idempotency-Key header on POST /messages.
- Never send a WhatsApp message or add a lead to a campaign without asking me first.
```

L'assistant va alors chercher la page exacte dont il a besoin au lieu de deviner les noms de champs.

## Fournir une page à un assistant

Trois façons, de la plus rapide à la plus complète :

1. Clique sur **Open in Claude** ou **Open in ChatGPT** dans l'en-tête de la page que tu lis.
2. Clique sur **Copy page** et colle le Markdown dans la conversation.
3. Donne à l'assistant l'URL `.md` de la page, par exemple `https://docs.whatsetter.com/developers/webhooks.md`, et laisse-le la récupérer.

Pour une question qui couvre plusieurs pages, donne `https://docs.whatsetter.com/llms-full.txt` une fois pour toutes.

## Laisser Claude Code construire une intégration de bout en bout

1. Crée une clé dans **Paramètres**, puis **API & MCP**, avec les scopes dont l'intégration a besoin. Exporte-la : `export WHATSETTER_API_KEY="ws_live_…"`.
2. Ajoute le bloc ci-dessus au `CLAUDE.md` de ton projet.
3. Si tu veux, connecte le [serveur MCP](/fr/developers/mcp/) pour que Claude Code vérifie le résultat sur ton vrai espace : `claude mcp add --transport http whatsetter https://mcp.whatsetter.com/mcp`.
4. Décris l'intégration. Par exemple : « Synchronise chaque lead qualifié par WhatSetter dans notre CRM HubSpot. Abonne-toi au webhook `contact.qualified`, vérifie la signature et fais la correspondance sur `external_reference`. »
5. Demande à Claude Code de tester d'abord avec `GET /me`, puis avec des lectures, avant tout appel qui envoie un message.

> **La clé reste dans l'environnement**
Relis le code généré avant de le lancer : la clé doit venir de `WHATSETTER_API_KEY`, jamais d'une chaîne dans le code. Si une clé atterrit un jour dans un fichier ou un chat, révoque-la dans **Paramètres**, puis **API & MCP**, et crées-en une nouvelle.

## Voir aussi

- [Serveur MCP](/fr/developers/mcp/)
- [Démarrage rapide](/fr/developers/quickstart/)
- [Erreurs, limites et idempotence](/fr/developers/errors/)
