# Collega Maguyva al tuo agente

Canonical source: https://maguyva.ai/it/docs

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

Il tuo agente inizia ogni sessione alla cieca. Maguyva risolve il problema con ricerca nel codebase, ricerca dei simboli e contesto delle dipendenze via MCP.

Il percorso più breve è semplice: inizia gratis, indicizza un piccolo set di repository rappresentativi, collega il tuo client, poi fai una vera domanda di cui sai già come verificare la risposta.

## Quattro mosse per passare da un agente cieco a risposte fondate.

Il percorso più breve resta il migliore: collega un piccolo set di repository, collega il tuo client, poi fai una domanda di cui sai già come verificare la risposta.

- **Inizia gratis**: Nessuna carta di credito richiesta. Usa un piccolo set di repository rappresentativi invece di provare a indicizzare tutta l'azienda il primo giorno.
- **Indicizza un repository che già conosci**: Scegli codice che puoi verificare rapidamente. Così è subito chiaro se Maguyva aiuta il modello a basarsi sul codice reale meglio di una ricerca generica.
- **Collega il tuo client MCP**
- **Fai una vera domanda sul repository**: Vai dritto a simboli, chiamanti, definizioni e dipendenze — ogni risultato cita il percorso del file e i risultati di ricerca portano anche i numeri di riga — invece di sperare che il modello abbia indovinato.

## Panoramica della documentazione

- [Avvio rapido](https://maguyva.ai/it/docs/quickstart): Da zero a una prima risposta verificata in pochi minuti
- [Installazione](https://maguyva.ai/it/docs/installation): Collega Maguyva al tuo client MCP in pochi minuti
- [Come funziona](https://maguyva.ai/it/docs/how-it-works): Scopri come indicizzazione, ricerca, simboli e grafi delle dipendenze si incastrano tra loro
- [Riferimento API MCP](https://maguyva.ai/it/docs/mcp-api): Guida di riferimento per ciascuno strumento MCP di Maguyva
- [Compatibilità](https://maguyva.ai/it/docs/compatibility): Linguaggi supportati, limiti dei repository e copertura dei file
- [Ricette](https://maguyva.ai/it/docs/cookbook): Brevi ricette per installazione, ricerca prima della modifica, risultati vuoti e multi-repo
- [Risoluzione dei problemi](https://maguyva.ai/it/docs/troubleshooting): Risolvi problemi di chiave API, bridge e connessione ai repository

## Altre risorse

- [Guide per linguaggio](https://maguyva.ai/it/languages): Scopri come Maguyva gestisce il tuo stack di linguaggi
- [Blog](https://maguyva.ai/it/blog): Decisioni architetturali e approfondimenti tecnici
- [Prezzi](https://maguyva.ai/it/pricing): Prezzi per workspace, si parte gratis

## Convalida con una domanda di cui conosci già la risposta.

Maguyva dà il meglio di sé quando lo usi su codice che già conosci. Inizia con un repository, fai una vera domanda, controlla i percorsi dei file, e fai in modo che lo strumento si guadagni la fiducia prima che diventi parte del tuo flusso di lavoro predefinito.

- Domanda: Quale codice gestisce il login e la scadenza della sessione?
- Verifica: Apri i file citati, segui i simboli e verifica che la risposta regga il confronto con il repository reale.
- Segnale: Contesto più piccolo, meno punti ciechi, più probabilità che il modello modifichi il file giusto al primo tentativo.

### Cosa ottieni

- Risposte fondate con percorsi dei file e numeri di riga.
- Ricerca dei simboli, funzioni chiamanti, definizioni e percorsi delle dipendenze in un'unica interfaccia.
- Un unico server MCP remoto che funziona su più client, invece di un flusso di lavoro separato per ogni editor.
