# Claude Desktop non vede il tuo repo. Dagliene uno.

Canonical source: https://maguyva.ai/it/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 è dove molti fanno domande su codice che in quel momento non stanno modificando: review, onboarding, call per gli incidenti. Maguyva indicizza il repo e lo serve via MCP, così le risposte citano file e righe invece della memoria.

> Nessun checkout necessario. Chiedi all’indice.

## Cosa sapere su Claude Desktop

Quattro fatti specifici di Claude Desktop.

### claude_desktop_config.json

Settings → Developer → Edit Config lo apre. Su macOS si trova in `~/Library/Application Support/Claude/`; su Windows, in `%APPDATA%\Claude\`.

### Il bridge locale

Questo file avvia processi locali, quindi questa guida esegue `@maguyva/mcp` tramite `npx`. Serve Node.js installato.

### Una voce env

Il bridge legge `MAGUYVA_API_KEY` dal blocco `env` del server, nello stesso file.

### Chiudi, poi riapri

Claude Desktop legge il file all’avvio. Chiudi completamente l’app dopo averlo modificato; il server parte all’avvio successivo.

## Le istruzioni di progetto fissano il brief. Usale.

I Projects di Claude contengono istruzioni e file con cui parte ogni chat del progetto. Sono il posto giusto per:

- A chi sono rivolte le risposte: un revisore, un nuovo arrivato, un ingegnere di reperibilità.
- Lo stile della casa per spiegazioni e riassunti.
- Pochi documenti che vuoi vedere citati, come una panoramica dell’architettura.

I file caricati sono un’istantanea. Il repo è già andato avanti il giorno dopo il caricamento.

## Dove il codice incollato non basta

Tre modi in cui una chat sul codice va storta senza il codice.

### // gli snippet incollati invecchiano

Un file incollato nella chat la settimana scorsa descrive il codice della settimana scorsa. Claude risponde sicuro di sé partendo dalla versione che ha ricevuto.

### // lo snippet non è il sistema

Raramente un solo file risponde a “cosa succede quando questo fallisce?” L’handler, il retry e l’alert di solito vivono in tre pacchetti diversi.

### // niente checkout, niente grep

Claude Desktop non ha una copia di lavoro del tuo repo. Senza uno strumento, ogni risposta sulla struttura dipende da ciò che ti sei ricordato di incollare.

## Maguyva come server MCP in Claude Desktop

Una voce in mcpServers dà a Claude:

- **11 strumenti sul tuo repo indicizzato**: ricerca semantica, strutturale (AST), a grafo e testuale, più ricerca dei simboli, dipendenti e recupero file.
- **Risposte con percorsi file e numeri di riga**: su oltre 285 linguaggi, così puoi verificare ogni affermazione.
- **Risultati che tengono conto del branch**: così Claude risponde sul branch che indichi, non su un file caricato da qualcuno il mese scorso.

> Le istruzioni di progetto dicono a Claude *come rispondere*.
> Maguyva dà a Claude *il codice da cui partire*.

## Due flussi di lavoro

Domande per cui altrimenti apriresti un IDE.

### 01. Spiegare un percorso del codice durante una review

```text
claude> cosa succede quando un webhook di pagamento non supera il controllo della firma?

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

→ Claude risponde citando entrambe le righe.
[exit 0]
```

Ogni passaggio della risposta rimanda a un file e una riga che puoi aprire.

### 02. Dimensionare una modifica prima di pianificarla

```text
claude> in quanti punti si legge il vecchio campo plan_code?

text_pattern_search("plan_code")
  14 corrispondenze in 9 file
dependency_search("getPlanCode", dependents)
  6 chiamanti

→ La stima parte da un numero, non da un’ipotesi.
[exit 0]
```

Utile in una riunione di pianificazione, quando nessuno ha il repo aperto.

## Configurazione in Claude Desktop

Tre passaggi. Piano Free: 3 repository, Fino a 50K righe di repository indicizzate, senza carta di credito.

### 01. Indicizza un repo su maguyva.ai

Scegline uno che già conosci, così puoi valutare le risposte.

### 02. Aggiungi Maguyva a claude_desktop_config.json

`claude_desktop_config.json`

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

### 03. Sostituisci il segnaposto, riavvia e fai una domanda

Sostituisci `mgv_xxxx` con la tua chiave API, chiudi completamente Claude Desktop e riaprilo. Se il server non compare, leggi `mcp-server-maguyva.log` nella cartella dei log di Claude (`~/Library/Logs/Claude` su macOS).

La [guida MCP ai server locali](https://modelcontextprotocol.io/docs/develop/connect-local-servers) spiega più nel dettaglio il file di configurazione e i suoi log.

## Indicizza un repo che già conosci.

Collega Claude Desktop via MCP, poi fai una domanda che puoi verificare.