Passer au contenu

Démarrage rapide

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 — sans carte bancaire. Votre clé API (elle commence par mgv_) se trouve dans 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 — ça rend évident si Maguyva ancre réellement le modèle dans le 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 :

/plugin marketplace add maguyva/claude-code-plugin
/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) :

export MAGUYVA_API_KEY=mgv_xxxx

Vous travaillez en équipe ? Ajoutez --scope project aux deux commandes /plugin pour commiter le plugin dans le .claude/settings.json du dépôt, afin que les coéquipiers le reçoivent automatiquement.

La plupart des autres clients (Cursor, VS Code, Windsurf, 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 :

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

La forme varie légèrement selon le client (VS Code imbrique sous servers avec type: "http", Windsurf utilise serverUrl, Zed utilise context_servers). Remplacez mgv_xxxx par votre clé API, puis redémarrez votre client. La config exacte pour les 24 clients documentés se trouve dans le Guide d'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 — faites gagner sa confiance à l'outil avant qu'il rejoigne votre boucle par défaut.

Aucun résultat, ou des erreurs de connexion ? Direction Dépannage — la plupart des échecs viennent d'une clé API non définie, d'un npx manquant, ou d'un dépôt qui n'a pas fini de s'indexer.

Prochaines étapes#