# L’agente di Warp vive nel terminale. Dagli una mappa del repo.

Canonical source: https://maguyva.ai/it/for-warp

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

L’agente di Warp esegue comandi e legge quello che stampano. Maguyva indicizza l’intero repo e lo serve via MCP, così l’agente chiede dove si trova il codice invece di lanciare grep e cat finché qualcosa non corrisponde.

> Una voce mcpServers in ~/.warp/.mcp.json: un URL e un header Authorization.

## Cosa deve sapere Warp

Quattro fatti specifici di Warp.

### ~/.warp/.mcp.json

Warp avvia da solo i server di questo file globale. Puoi anche incollare lo stesso JSON in Settings → Agents → MCP servers → + Add.

### Remoto, via URL

Una voce `url` si collega in Streamable HTTP o SSE. In locale non gira nulla e Node.js non serve.

### Un header letterale

La chiave va direttamente nell’header `Authorization`. Tienila nel file globale, non nel `.warp/.mcp.json` di un progetto che committi.

### Mai avviati da soli

Warp rileva `.warp/.mcp.json` in un repo clonato, ma aspetta che sia tu ad avviare ogni server. Se lo attivi, legge anche i server dalle configurazioni di Claude Code e Codex.

## Le regole di progetto sono un accordo di lavoro. Usale.

```text
# AGENTS.md
- Esegui make test prima di dichiarare conclusa una modifica.
- Usa gli script in bin/, non comandi improvvisati.
```

Warp legge le regole di progetto da `AGENTS.md` (o da `WARP.md`, che prevale se esistono entrambi) e applica ovunque le Global Rules. Usale per:

- Comandi di build, test e deploy.
- Convenzioni che l’agente continua a sbagliare.
- Comandi che l’agente non deve mai eseguire.

Le regole dicono all’agente come lavorare. Non possono dirgli quale servizio legge ancora la variabile d’ambiente che stai per rimuovere.

## Dove finisce grep nel terminale

Tre cose che una sessione di shell non impara a buon mercato.

### // l’output scorre via

Ogni grep e ogni cat che l’agente esegue finiscono nella conversazione. Una ricerca che stampa duecento righe consuma contesto prima che inizi il lavoro vero.

### // una corrispondenza non è un chiamante

grep non distingue una chiamata vera da un commento, una fixture o un metodo omonimo di un’altra classe.

### // la shell parte a freddo

Una nuova sessione non sa nulla del repo. L’indice di Maguyva è già costruito, quindi la prima domanda riceve una risposta classificata.

## Maguyva come server MCP in Warp

Una voce mcpServers dà all’agente di Warp:

- **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**: in oltre 285 linguaggi, abbastanza brevi da leggerle in un riquadro del terminale.
- **Strumenti che leggono e basta**: Gli strumenti di Maguyva interrogano l’indice. Nessuno modifica file o esegue comandi.

> Warp dà all’agente *un terminale*.
> Maguyva dà all’agente *una mappa del codice*.

## Due flussi di lavoro

Prima chiedi alla mappa, poi esegui i comandi.

### 01. Risalire da uno script che fallisce alla sua origine

```text
warp agent> deploy.sh fallisce: BUILD_ID non è impostata. dove viene impostata?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← testo

→ L’agente carica ci/env.sh e rilancia il deploy.
[exit 0]
```

Una ricerca indicizzata sostituisce un grep ricorsivo su tutto il repo e il suo output.

### 02. Controllare i chiamanti prima di cambiare un passo di avvio

```text
warp agent> possiamo smettere di eseguire le migrazioni all’avvio?

dependency_search("runMigrations", dependents)
  3 chiamanti: server.ts, worker.ts, scripts/seed.ts

→ L’agente sposta tutti e tre nel passo di release.
[exit 0]
```

I chiamanti arrivano prima della modifica, così il worker non parte contro uno schema vecchio.

## Configurazione in Warp

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 ~/.warp/.mcp.json

`~/.warp/.mcp.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

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

Sostituisci `mgv_xxxx` con la tua chiave API e salva. Controlla in Settings → Agents → MCP servers che il server sia in esecuzione, poi fai una domanda di cui conosci già la risposta.

La [documentazione MCP](https://docs.warp.dev/agents/capabilities/mcp/) di Warp copre i server definiti in file, la condivisione e l’autenticazione.

## Indicizza un repo che già conosci.

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