Per gli utenti di Zed

Zed è veloce. Il codice, però, l’agente deve ancora trovarlo.

L’agente di Zed lavora con i file che apri e le istruzioni che gli dai. Maguyva indicizza l’intero repo e lo restituisce via MCP, così l’agente chiede dove si trova un simbolo invece di tirare a indovinare.

Inizia gratis Leggi la configurazione per Zed

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

Una voce in context_servers: un URL e un header Authorization.

Cosa sapere su Zed

Quattro fatti specifici di Zed. Nessuno è difficile.

// file di configurazione

settings.json

I server remoti stanno sotto context_servers. Apri il file con zed: open settings file oppure aggiungi un server da Settings → AI → MCP Servers.

// trasporto

Remoto, via URL

Zed si collega via HTTP direttamente all’endpoint remoto di Maguyva. Nessun processo locale, niente Node.js.

// chiave

Un header letterale

Questa guida inserisce la chiave direttamente nell’header Authorization, perché l’espansione delle variabili d’ambiente negli header di Zed qui non è verificata. Tienila nelle impostazioni utente, non in un file che committi.

// approvazioni

Permessi degli strumenti

Per impostazione predefinita Zed chiede conferma prima di ogni chiamata a uno strumento. Consenti gli strumenti di Maguyva uno alla volta sotto agent.tool_permissions.tools, con chiavi come mcp:maguyva:find_symbol.

Le istruzioni di progetto sono un accordo di lavoro. Usale.

# .rules
- Esegui il comando di test del repo prima di dichiarare conclusa una modifica.
- Modifica solo il pacchetto che ti è stato chiesto di cambiare.

Zed carica un solo file di istruzioni di progetto: la prima corrispondenza in un elenco fisso che inizia con .rules e include AGENTS.md e CLAUDE.md. Le istruzioni personali vanno in ~/.config/zed/AGENTS.md. Usale per:

Comandi di build, test e lint.
Convenzioni che l’agente continua a sbagliare.
Directory che l’agente non deve toccare.

Un file di istruzioni dice all’agente come lavorare. Non può dirgli quali di quattromila file chiamano la funzione che sta per modificare.

Dove il buffer aperto non basta

Tre cose che l’agente di Zed non può imparare dai file che ha davanti.

// il file aperto non è il repo

L’agente vede ciò che hai aperto e ciò che trova con grep. Un helper con lo stesso nome in un altro pacchetto sembra identico finché non va in produzione quello sbagliato.

// i chiamanti non sono sullo schermo

“Cosa si rompe se cambio questa firma?” è una domanda da grafo. Senza indice, l’agente legge i file uno alla volta finché non esaurisce i turni o il contesto.

// il contesto ha un budget

Ogni file che l’agente apre per orientarsi consuma token che non potrà spendere sulla modifica. Una risposta classificata con file:line costa meno di dieci letture esplorative.

Maguyva come server di contesto di Zed

Una voce in context_servers dà all’agente di Zed:

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ì l’agente apre subito il file giusto.
Un elenco di strumenti sempre aggiornato Zed ricarica gli strumenti di un server quando il server annuncia una modifica, senza riavvio.

Zed dà all’agente un editor veloce.
Maguyva dà all’agente una mappa del codice.

Due flussi di lavoro

Prima chiedi alla mappa, poi modifica.

// workflow 01

Trovare l’implementazione prima che l’agente apra una scheda

zed agent> dov’è la policy di retry per i webhook in uscita?

find_symbol("retryPolicy")
  src/webhooks/dispatch.ts:41   retryPolicy()   ← implementazione
  src/webhooks/__mocks__/dispatch.ts:9   ← mock

→ L’agente apre dispatch.ts:41, non il mock.
[exit 0]

Una ricerca classificata sostituisce un giro di grep. La risposta torna come percorso e riga che l’agente può aprire direttamente.

// workflow 02

Controllare i dipendenti prima di cambiare una firma

zed agent> aggiungi un argomento timeout a fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 chiamanti in 4 pacchetti

→ L’agente aggiorna tutti e sette i punti di chiamata in un passaggio.
[exit 0]

Il raggio d'impatto arriva prima della prima modifica, non dopo che la build fallisce.

Configurazione in Zed

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 context_servers nelle impostazioni di Zed

~/.config/zed/settings.json

{
  "context_servers": {
    "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. Fai all’agente una domanda di cui conosci già la risposta, poi apri il file citato.