> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marcodewey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fonctionnalités d'IA

> Comment Mintlify rend votre documentation utile aux assistants et agents d'IA, ainsi qu'aux personnes.

La documentation Mintlify est conçue pour deux publics : les personnes et les agents d'IA. L'essentiel est automatique. Il n'y a rien à maintenir.

> [card] Assistant
>
> Les lecteurs posent des questions en langage naturel et obtiennent des réponses avec sources.

> [card] llms.txt
>
> Un index de vos pages que les outils d'IA peuvent lire.

> [card] Serveur MCP
>
> Permet à Claude, Cursor et d'autres de rechercher directement dans votre documentation.

> [card] skill.md
>
> Un résumé des capacités pour que les agents sachent ce que votre produit peut faire.

## L'assistant

L'assistant répond aux questions sur votre documentation et votre API, cite les pages qu'il a utilisées et écrit du code prêt à copier.

**1. Ouvrez-le**

Appuyez sur <kbd>⌘</kbd> + <kbd>I</kbd> (ou <kbd>Ctrl</kbd> + <kbd>I</kbd>), ou cliquez sur **Ask AI** dans la barre de recherche.

**2. Posez une vraie question**

Essayez celles-ci sur ce site :

* *Comment m'authentifier auprès de la Todo API ?*
* *Écris un script Python qui parcourt toutes les pages de todos.*
* *Quelle est la différence entre la v1 et la v2 de la Calculator API ?*

**3. Vérifiez les sources**

Chaque réponse renvoie vers les pages dont elle provient. L'assistant lit aussi les spécifications OpenAPI, il connaît donc les paramètres et les réponses de chaque endpoint.

> [!NOTE]
>
> L'assistant est inclus dans les forfaits Pro et Enterprise. Activez-le et ajustez-le dans le tableau de bord Mintlify.

## llms.txt et llms-full.txt

Mintlify génère automatiquement deux fichiers pour chaque site :

| Fichier | Contenu |
| - | - |
| `/llms.txt` | Un index court : chaque page avec son titre et sa description |
| `/llms-full.txt` | Le texte intégral de la documentation dans un seul fichier |

Ajoutez `.md` à l'URL de n'importe quelle page, ou utilisez **View as Markdown** dans le menu contextuel, pour obtenir une version Markdown épurée de cette seule page. Les agents obtiennent le même contenu que les personnes, sans l'habillage de la page.

> [!TIP]
>
> Sur ce site, essayez `/llms.txt` et `/quickstart.md` dans votre navigateur.

## Serveur MCP

Votre site dispose d'un **serveur MCP** hébergé à `/mcp`, sans aucune configuration. Un outil d'IA qui s'y connecte peut rechercher dans votre documentation et lire des pages entières pendant qu'il travaille.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http mintlify-demo https://YOUR-DOCS-DOMAIN/mcp
> ```

> [tab] Cursor
>
> Utilisez **Connect to Cursor** dans le menu contextuel de n'importe quelle page.

> [tab] N'importe quel client MCP
>
> Ajoutez l'URL `https://YOUR-DOCS-DOMAIN/mcp` en tant que serveur MCP HTTP.

> [!NOTE]
>
> Remplacez `YOUR-DOCS-DOMAIN` par le domaine de ce site.

## skill.md

Mintlify héberge aussi un fichier `skill.md` à la racine de votre site. Il suit le format [agentskills.io](https://agentskills.io/specification) et décrit ce qu'un agent peut faire avec votre produit, les entrées dont il a besoin et les points de vigilance. Installez-le dans un agent avec :

```bash theme={null}
npx skills add https://YOUR-DOCS-DOMAIN
```

> [!NOTE]
>
> Mintlify génère `skill.md` pour vous, ce qui peut prendre jusqu'à 24 heures après la première publication. Pour écrire le vôtre, ajoutez un fichier `skill.md` à la racine du dépôt.

## Menu contextuel

Le menu situé à côté du titre de chaque page se configure dans `docs.json` avec `contextual.options`. Ce site active 17 options, dont :

> [card] Copier la page
>
> Copie la page au format Markdown.

> [card] Afficher en Markdown
>
> Ouvre la version `.md`.

> [card] Ouvrir dans ChatGPT, Claude, Perplexity, Grok
>
> Démarre une conversation avec la page comme contexte.

> [card] Connecter le MCP à Cursor ou VS Code
>
> Installation du serveur MCP en un clic.

```json docs.json theme={null}
{
  "contextual": {
    "options": [
      "copy", "view", "assistant", "chatgpt", "claude", "perplexity", "grok", "aistudio", "devin",
      "windsurf", "mcp", "cursor", "vscode", "devin-mcp", "add-mcp", "download-spec", "download-pdf"
    ]
  }
}
```

## Un contenu différent pour les personnes et les agents

Le composant `Visibility` affiche un contenu différent selon qui lit.

Vous lisez la version rédigée pour les **agents**. Pour appeler la Todo API, envoyez `X-API-Key: demo-key` et `POST /todos` avec un corps JSON contenant `title`.

Ouvrez l'URL `.md` de cette page pour voir la version destinée aux agents.

## À montrer également

> [accordion] L'agent et les automatisations
>
> L'agent de Mintlify peut rédiger des modifications de documentation à partir d'un prompt, et les automatisations peuvent maintenir la documentation à jour lorsque votre code change. Les deux ouvrent des pull requests à relire.

> [accordion] Analytique du trafic IA
>
> Le tableau de bord d'analytique distingue le trafic humain du trafic IA et montre ce que les gens demandent à l'assistant, afin que vous voyiez à quelles questions votre documentation ne répond pas encore.

> [accordion] Utilisez votre propre modèle
>
> Utilisez la clé de votre propre fournisseur de LLM pour alimenter l'assistant, l'agent et les automatisations.
