# Démarrage rapide

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

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).

Le chemin le plus rapide de zéro à une réponse vérifiée : obtenez une clé, indexez un dépôt que vous connaissez déjà, connectez votre client, et posez une question dont vous pouvez déjà évaluer la réponse.

## 1. Obtenez une clé API

[Démarrer gratuitement](https://app.maguyva.ai) — sans carte bancaire. Votre clé API (elle commence par `mgv_`) se trouve dans [app.maguyva.ai](https://app.maguyva.ai).

## 2. Indexez un dépôt que vous connaissez déjà

Connectez un dépôt GitHub depuis le portail et laissez-le s'indexer. Choisissez un petit dépôt que vous pouvez vérifier rapidement — vous verrez tout de suite si Maguyva ancre le modèle dans le code réel, plutôt que d'essayer d'indexer toute votre entreprise dès le premier jour.

## 3. Connectez votre client

Pour Claude Code, installez le plugin Maguyva depuis la marketplace — lancez chaque commande dans Claude Code :

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

Le plugin s'authentifie avec votre clé depuis la variable d'environnement `MAGUYVA_API_KEY`. Définissez-la dans votre shell (le `direnv` par projet est recommandé, puisque les clés sont scopées par dépôt) :

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

Vous travaillez en équipe ? Choisissez la portée project dans le panneau qu'ouvre `/plugin install maguyva@maguyva`. Le plugin est alors enregistré dans le `.claude/settings.json` du dépôt, que vous commitez ; chaque coéquipier exécute tout de même l'installation une fois. Les commandes `/plugin` de session n'acceptent pas d'option `--scope` : pour l'automatiser, exécutez la forme shell depuis la racine du dépôt :

```bash
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project
```

La plupart des autres clients (Cursor, VS Code, Devin Desktop, Zed, et compagnie) se connectent directement au serveur distant — pointez-les vers le point de terminaison avec un en-tête `Bearer`, sans pont requis. Par exemple, le `.cursor/mcp.json` de Cursor :

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

La forme varie légèrement selon le client (VS Code imbrique sous `servers` avec `type: "http"`, Antigravity utilise `serverUrl`, Zed utilise `context_servers`). Cet exemple Cursor lit votre clé depuis la variable d'environnement `MAGUYVA_API_KEY` présentée plus haut ; si la config d'un client affiche plutôt le placeholder `mgv_xxxx`, remplacez-le par votre clé API. Redémarrez ensuite votre client. La config exacte pour les 23 clients documentés se trouve dans le [Guide d'installation](https://maguyva.ai/fr/docs/installation).

## 4. Posez une question dont vous pouvez déjà évaluer la réponse

Commencez par **"Quels dépôts ai-je connectés ?"** pour confirmer la connexion, puis posez une vraie question sur votre dépôt dont vous connaissez déjà la réponse — quelque chose comme **"Comment l'authentification est-elle gérée dans ce dépôt ?"**

Vous devriez obtenir des réponses avec chemins de fichiers et numéros de ligne. Ouvrez les fichiers cités et vérifiez que la réponse survit au contact avec le vrai dépôt. Cette seule réponse évaluée vous en dit plus que n'importe quelle liste de fonctionnalités — laissez l'outil gagner votre confiance avant qu'il rejoigne votre boucle par défaut.

Aucun résultat ou des erreurs de connexion ? Vérifiez la clé API, la configuration du client et l’état d’indexation du dépôt dans [Dépannage](https://maguyva.ai/fr/docs/troubleshooting). Si votre installation utilise le pont, vérifiez aussi que `npx` est disponible.

## Prochaines étapes

- Guide d'installation: config par client pour les 23 clients documentés
- Comment ça marche: ce qui se passe entre votre question et la réponse
- Référence de l'API MCP: chaque outil, paramètre par paramètre