Per gli utenti di Claude Desktop

Claude Desktop non vede il tuo repo. Dagliene uno.

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.

Inizia gratis Leggi la configurazione per Claude Desktop

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

Nessun checkout necessario. Chiedi all’indice.

Cosa sapere su Claude Desktop

Quattro fatti specifici di Claude Desktop.

// file di configurazione

claude_desktop_config.json

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

// trasporto

Il bridge locale

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

// chiave

Una voce env

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

// riavvio

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.

// workflow 01

Spiegare un percorso del codice durante una review

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.

// workflow 02

Dimensionare una modifica prima di pianificarla

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.

// step 01

Indicizza un repo su maguyva.ai

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

// step 02

Aggiungi Maguyva a claude_desktop_config.json

claude_desktop_config.json

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

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