Per gli utenti di Warp

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

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.

Inizia gratis Leggi la configurazione di Warp

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

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

Cosa deve sapere Warp

Quattro fatti specifici di Warp.

// file di configurazione

~/.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.

// trasporto

Remoto, via URL

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

// chiave

Un header letterale

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

// file di progetto

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.

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

// workflow 01

Risalire da uno script che fallisce alla sua origine

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.

// workflow 02

Controllare i chiamanti prima di cambiare un passo di avvio

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.

// step 01

Indicizza un repo su maguyva.ai

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

// step 02

Aggiungi Maguyva a ~/.warp/.mcp.json

~/.warp/.mcp.json

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

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