Pour les utilisateurs de Claude Desktop

Claude Desktop ne voit pas votre dépôt. Montrez-lui-en un.

Claude Desktop, c’est là que beaucoup posent des questions sur du code qu’ils ne modifient pas à ce moment-là : revues, onboarding, appels d’incident. Maguyva indexe le dépôt et le sert via MCP, pour que les réponses citent des fichiers et des lignes plutôt que des souvenirs.

Commencer gratuitement Voir la configuration Claude Desktop

Palier Free : 3 dépôts, Jusqu'à 50 000 lignes de dépôt indexées, sans carte bancaire.

Pas besoin de checkout. Interrogez l’index.

Ce qu’il faut savoir sur Claude Desktop

Quatre faits propres à Claude Desktop.

// fichier de config

claude_desktop_config.json

Settings → Developer → Edit Config l’ouvre. Sous macOS, il se trouve dans ~/Library/Application Support/Claude/ ; sous Windows, dans %APPDATA%\Claude\.

// transport

Le pont local

Ce fichier lance des processus locaux, donc ce guide exécute @maguyva/mcp via npx. Node.js doit être installé.

// clé

Une entrée env

Le pont lit MAGUYVA_API_KEY dans le bloc env du serveur, dans le même fichier.

// redémarrage

Quitter, puis rouvrir

Claude Desktop lit le fichier au lancement. Quittez complètement l’application après l’avoir modifié ; le serveur démarre au lancement suivant.

Les instructions de projet posent le cadre. Utilisez-les.

Les Projects de Claude contiennent des instructions et des fichiers avec lesquels démarre chaque conversation du projet. C’est le bon endroit pour :

À qui s’adressent les réponses : un relecteur, une nouvelle recrue, un ingénieur d’astreinte.
Le style maison des explications et des résumés.
Quelques documents que vous voulez voir cités, comme une vue d’ensemble de l’architecture.

Les fichiers téléversés sont un instantané. Le dépôt a déjà avancé le lendemain du téléversement.

Là où le code collé ne suffit plus

Trois façons dont une conversation sur le code déraille sans le code.

// les extraits collés vieillissent

Un fichier collé dans la conversation la semaine dernière décrit le code de la semaine dernière. Claude répond avec assurance à partir de la version qu’on lui a donnée.

// l’extrait n’est pas le système

Un seul fichier répond rarement à “que se passe-t-il quand ça échoue ?” Le handler, le retry et l’alerte vivent généralement dans trois paquets différents.

// pas de checkout, pas de grep

Claude Desktop n’a pas de copie de travail de votre dépôt. Sans outil, chaque réponse sur la structure dépend de ce que vous avez pensé à coller.

Maguyva comme serveur MCP dans Claude Desktop

Une entrée mcpServers donne à Claude :

11 outils sur votre dépôt indexé recherche sémantique, structurelle (AST), par graphe et textuelle, plus recherche de symboles, dépendants et récupération de fichiers.
Des réponses avec chemins de fichiers et numéros de ligne sur plus de 285 langages, pour que vous puissiez vérifier chaque affirmation.
Résultats qui tiennent compte des branches pour que Claude réponde sur la branche que vous nommez, pas sur un fichier téléversé le mois dernier.

Les instructions de projet disent à Claude comment répondre.
Maguyva donne à Claude le code sur lequel s’appuyer.

Deux flux de travail

Des questions pour lesquelles vous ouvririez sinon un IDE.

// workflow 01

Expliquer un chemin de code pendant une revue

claude> que se passe-t-il quand un webhook de paiement échoue à la vérification de signature ?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claude répond en citant les deux lignes.
[exit 0]

Chaque étape de la réponse renvoie à un fichier et une ligne que vous pouvez ouvrir.

// workflow 02

Évaluer l’ampleur d’un changement avant de le planifier

claude> combien d’endroits lisent l’ancien champ plan_code ?

text_pattern_search("plan_code")
  14 correspondances dans 9 fichiers
dependency_search("getPlanCode", dependents)
  6 appelants

→ L’estimation part d’un chiffre, pas d’une supposition.
[exit 0]

Utile en réunion de planification, quand personne n’a le dépôt ouvert.

Configuration dans Claude Desktop

Trois étapes. Palier Free : 3 dépôts, Jusqu'à 50 000 lignes de dépôt indexées, sans carte bancaire.

// step 01

Indexez un dépôt sur maguyva.ai

Choisissez-en un que vous connaissez déjà, pour pouvoir évaluer les réponses.

// step 02

Ajoutez Maguyva à claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

Remplacez le placeholder, redémarrez et posez une question

Remplacez mgv_xxxx par votre clé API, quittez complètement Claude Desktop et rouvrez-le. Si le serveur n’apparaît pas, lisez mcp-server-maguyva.log dans le dossier de logs de Claude (~/Library/Logs/Claude sous macOS).