# Guide d'installation

Canonical source: https://maguyva.ai/fr/docs/installation

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Soyez opérationnel en moins de 5 minutes. Ce guide inclut la configuration pour 23 clients MCP, dont Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT et Warp, et plus encore.

**Prérequis** : Vous aurez besoin d'une clé API depuis [app.maguyva.ai](https://app.maguyva.ai) et d'un dépôt GitHub connecté.

## Configuration de l'environnement

Commencez par définir votre clé API dans une variable d’environnement. Omettez `repository` lorsque votre client MCP fournit une valeur par défaut pour la requête ou lorsque la clé permet d’accéder à un seul dépôt ; sinon, transmettez-le explicitement.

### macOS/Linux (Bash/Zsh)

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

Remplacez `mgv_xxxx` par votre clé API réelle depuis [app.maguyva.ai](https://app.maguyva.ai).

## Configuration du client

Choisissez votre client MCP ci-dessous pour des instructions de configuration spécifiques.

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Maguyva utilise le standard MCP. N'importe quel client qui prend en charge le protocole peut se connecter — même sans guide officiel ci-dessus. 23 clients documentés, d'autres ajoutés régulièrement.

## Validez votre configuration

Une fois connecté, essayez de poser quelques questions à votre agent :

- « Quels dépôts ai-je connectés ? » — vérifie que la connexion fonctionne
- « Comment l'authentification est-elle gérée dans cette base de code ? » — teste la recherche sémantique
- « Trouve toutes les fonctions qui appellent la base de données » — teste la recherche de dépendances
- « De quoi dépend la classe UserService ? » — teste la recherche de symboles

Vous devriez voir des résultats avec les chemins de fichiers et numéros de ligne de votre dépôt connecté. Sinon, consultez la section [troubleshooting](https://maguyva.ai/fr/docs/troubleshooting) ci-dessous.

## Format du dépôt

Lorsque vous spécifiez des dépôts :

- Avec branche: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- Branche par défaut: `"owner/repo"`

**Conseil** : utilisez `repository_context(action="info", repository="...")` pour vérifier la résolution du dépôt. Un remplacement explicite du dépôt s’applique uniquement à l’appel en cours.

## Dépannage

### Problèmes de clé API

- Vérifiez que votre clé commence par le préfixe mgv_
- Vérifiez que la clé est correctement définie dans votre environnement
- Assurez-vous que la clé n'a pas expiré

### Dépôt introuvable

- Vérifiez que le dépôt est connecté dans app.maguyva.ai
- Vérifiez que le format owner/repo est correct
- Assurez-vous d'avoir accès au dépôt

### Problèmes de connexion MCP

- Si votre client utilise le pont @maguyva/mcp, vérifiez que npx est disponible dans votre PATH
- Vérifiez que votre jeton API est valide et non expiré
- Testez la connectivité vers https://maguyva.tools/mcp
- Vérifiez la syntaxe de configuration MCP de votre client

## Étapes suivantes

- Référence API MCP: Documentation API complète
- Comment ça marche: Comprendre l'optimisation du contexte
- Dépannage: Résoudre les problèmes de configuration et de connexion