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

Canonical source: https://maguyva.ai/fr/for-claude-desktop

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

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.

> Pas besoin de checkout. Interrogez l’index.

## Ce qu’il faut savoir sur Claude Desktop

Quatre faits propres à Claude Desktop.

### 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\`.

### Le pont local

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

### Une entrée env

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

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

### 01. Expliquer un chemin de code pendant une revue

```text
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.

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

```text
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.

### 01. Indexez un dépôt sur maguyva.ai

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

### 02. Ajoutez Maguyva à claude_desktop_config.json

`claude_desktop_config.json`

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

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

Le [guide MCP des serveurs locaux](https://modelcontextprotocol.io/docs/develop/connect-local-servers) détaille le fichier de configuration et ses logs.

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

Connectez Claude Desktop via MCP, puis posez une question que vous pouvez vérifier.