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.

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

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.

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

/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) :

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 :

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 :

{
  "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.

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.

• 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