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

# Utiliser Avala avec l'IA

> Connectez Avala à Claude, Cursor, VS Code et ChatGPT avec MCP

Le [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) est un standard ouvert qui permet aux assistants IA d'appeler des outils externes et d'accéder à des sources de données. Le serveur MCP d'Avala expose vos jeux de données, projets et exports comme des outils, vous permettant de gérer votre flux d'annotation en langage naturel dans Claude, Cursor, VS Code ou ChatGPT.

## Configuration rapide

Installez le serveur MCP avec n'importe quel client IA compatible. Vous aurez besoin de **Node.js 18+** et d'une [clé API Avala](/docs/api-reference/authentication).

Pour Claude Desktop, ajoutez à votre fichier de configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` sur macOS) :

<Warning>
  Ne committez jamais de fichiers de configuration contenant de vraies clés API dans le contrôle de version. Définissez `AVALA_API_KEY` comme variable d'environnement système, ou remplacez `"your-api-key"` par votre clé réelle localement.
</Warning>

```json theme={null}
{
  "mcpServers": {
    "avala": {
      "command": "npx",
      "args": ["-y", "@avala-ai/mcp-server"],
      "env": {
        "AVALA_API_KEY": "your-api-key"
      }
    }
  }
}
```

Redémarrez Claude Desktop. Les outils Avala apparaîtront dans le sélecteur d'outils.

<Info>
  MCP fonctionne en lecture seule par défaut dans le serveur intégré. Pour activer les outils d'écriture/suppression, définissez `AVALA_MCP_ENABLE_MUTATIONS=true` avant de lancer le serveur MCP.
</Info>

## Ce que vous pouvez faire

Une fois connecté, vous pouvez demander à votre assistant IA d'interagir avec Avala en langage naturel :

```
Liste tous mes jeux de données
```

```
Montre le statut du projet "Pedestrian Detection"
```

```
Combien de tâches sont terminées dans "Lidar QA" ?
```

```
Montre les jobs d'export pour le dataset ds_abc123
```

```
Montre les statistiques de mon espace de travail
```

L'assistant appelle l'outil MCP Avala approprié, traite la réponse et présente les résultats. Vous pouvez enchaîner plusieurs requêtes dans une seule conversation — par exemple, lister les jeux de données, en choisir un, puis déclencher un export.

## Guide de configuration complet

Pour VS Code, ChatGPT et la liste complète des outils MCP disponibles, consultez le guide complet de [configuration du serveur MCP](/docs/integrations/mcp-setup).

<CardGroup cols={2}>
  <Card title="Configuration du serveur MCP" icon="plug" href="/docs/integrations/mcp-setup">
    Instructions de configuration complètes pour tous les clients IA supportés et la référence complète des outils.
  </Card>

  <Card title="Authentification API" icon="key" href="/docs/api-reference/authentication">
    Créez et gérez les clés API utilisées par le serveur MCP.
  </Card>
</CardGroup>