# Maguyva

Brevi ricette per i flussi di lavoro Maguyva MCP comuni: installa un client, cerca prima di modificare, risultati vuoti e lavoro multi-repo.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/it/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/it/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/it/changelog.json).

## Capacità per linguaggio

Di seguito i conteggi delle capacità che alimentano la ricerca strutturale, la ricerca di simboli, l’analisi basata sul grafo e l’indicizzazione di base.

Questi indicatori mostrano le funzionalità abilitate nella configurazione attuale dei linguaggi, non punteggi di qualità dell'intero processo. La disponibilità del grafo richiede che siano abilitati un parser, l'estrazione dei simboli e l'estrazione del grafo. I tipi di relazione supportati e la profondità di estrazione variano in base al linguaggio.

- Copertura indicizzata: **284**. Ogni linguaggio elencato è indicizzato per il contesto di file, testo e repository.
- Ricerca strutturale AST: **247**. Linguaggi con struttura basata su parser per flussi di lavoro AST e ricerca strutturale.
- Estrazione dei simboli: **282**. Linguaggi con metadati dei simboli per definizioni e ricerca.
- Relazioni del grafo: **151**. Linguaggi con estrazione operativa delle relazioni per la ricerca basata sul grafo. La profondità varia in base al linguaggio e al tipo di relazione.

- `ast_structural=false`: Indicizzazione text-first con analisi strutturale più limitata.
- `symbol_extraction=false`: L'estrazione dei simboli è limitata, quindi la navigazione si appoggia di più al contesto di file e struttura.
- `relationship_extraction=false`: Questo linguaggio è indicizzato per la ricerca, ma al momento non viene memorizzato nel grafo del codice.

[Trova il tuo linguaggio](/llms-full.txt)

## Ricette

Ricette pratiche per il lavoro quotidiano con Maguyva MCP. Ogni ricetta indica gli strumenti e la sequenza da seguire, non tutti i parametri. Per i parametri degli strumenti, consulta «[Riferimento API MCP](https://maguyva.ai/it/docs/mcp-api)». Per la prima configurazione, consulta «[Avvio rapido](https://maguyva.ai/it/docs/quickstart)».

### Scegli lo strumento giusto

La maggior parte delle domande richiede inizialmente una sola chiamata. Approfondisci solo quando la prima risposta è troppo generica o poco dettagliata.

- `intelligent_search` — inizia da qui per una domanda in linguaggio naturale sulla base di codice. L'impostazione predefinita auto/balanced indirizza le query riconosciute con alta confidenza come ricerche di definizioni alla ricerca strutturale, le domande su riferimenti o impatto al grafo e quelle su corrispondenze esatte alla ricerca testuale. Le altre domande utilizzano il significato semantico e il testo indicizzato. Usa mode=hybrid oppure auto con quality=thorough per richiedere tutte e quattro le modalità di ricerca. Una modalità scelta esplicitamente ha la precedenza su quality.
- `find_symbol`: conosci già la funzione, la classe o il nome della variabile.
- `dependency_search` — raggio d'impatto: chiamanti, componenti dipendenti o impatto prima (e dopo) una modifica.
- `get_task_context` — zona sconosciuta; un insieme delimitato di file, simboli e dipendenze per la descrizione di un'attività.
- `repository_context`: elenca i repository accessibili o controlla come si risolve il nome di un repository.
- `ask_maguyva` con `operation="guidance"` — guida locale sulla scelta degli strumenti e sull'utilizzo di Maguyva (nessuna modifica al repository).

## Tools -- Search

- [intelligent_search](https://maguyva.ai/it/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/it/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/it/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/it/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/it/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/it/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/it/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/it/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/it/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/it/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/it/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## Prossimi passi

- [Avvio rapido](https://maguyva.ai/it/docs/quickstart)
- [Guida all'installazione](https://maguyva.ai/it/docs/installation)
- [Riferimento API MCP](https://maguyva.ai/it/docs/mcp-api)
- [Risoluzione dei problemi](https://maguyva.ai/it/docs/troubleshooting)
- [Come funziona](https://maguyva.ai/it/docs/how-it-works)
- [Compatibilità e specifiche tecniche](https://maguyva.ai/it/docs/compatibility)

## Agent integrations

- [Maguyva per Cursor: contesto del codebase via MCP](https://maguyva.ai/it/for-cursor): Cursor modifica il file aperto; Maguyva indicizza l'intero monorepo e lo restituisce via MCP — ricerca semantica, AST, a grafo e testuale con file:line, così l'agente trova i file che non avevi fissato.
- [Maguyva per Windsurf: contesto del codebase via MCP](https://maguyva.ai/it/for-windsurf): Windsurf e Cascade modificano il file aperto; Maguyva indicizza l'intero monorepo e lo restituisce via MCP — semantico, AST, a grafo e testuale con file:line, così Cascade trova i file che non avevi menzionato.
- [Maguyva per Antigravity: contesto del codebase via MCP](https://maguyva.ai/it/for-antigravity): Antigravity esegue agenti autonomi su editor, terminale e browser; Maguyva fornisce loro una mappa consultabile del monorepo via MCP — il raggio d'impatto in anticipo, non dopo che la CI diventa rossa.
- [Maguyva per Codex: contesto del codebase via MCP](https://maguyva.ai/it/for-codex): AGENTS.md è l’accordo di lavoro. Maguyva è il server MCP che fornisce a Codex CLI una mappa interrogabile del repository, così la prima modifica non è un’ipotesi.
- [Maguyva per qualsiasi client MCP: contesto del codebase via MCP](https://maguyva.ai/it/for-anything): MCP è un protocollo aperto. Maguyva è un server MCP standard, quindi i client abilitati MCP come Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity ottengono lo stesso contesto del codebase ancorato al codice reale.
- [Maguyva per Gemini CLI: contesto del codebase via MCP](https://maguyva.ai/it/for-gemini): GEMINI.md stabilisce il contesto di lavoro; MCP è il canale. Maguyva è il server MCP che dà a Gemini CLI una mappa consultabile del tuo repo — ricerca semantica, AST e a grafo, così la prima modifica non è un'ipotesi.
- [Maguyva per Claude Code: contesto del codebase via MCP](https://maguyva.ai/it/for-claude-code): CLAUDE.md dice a Claude come comportarsi. Maguyva indicizza il repository e lo serve tramite MCP, così Claude Code modifica a partire da una mappa interrogabile.
- [Maguyva per GitHub Copilot CLI: contesto del codice tramite MCP](https://maguyva.ai/it/for-copilot): Le istruzioni personalizzate dicono a Copilot come comportarsi. Maguyva indicizza il repository e lo serve tramite MCP, così GitHub Copilot CLI modifica a partire da una mappa.

## Company

- [Informazioni su Maguyva: intelligenza del codice via MCP](https://maguyva.ai/it/about): Intelligenza del codice per agenti di coding: ricerca semantica, AST, a grafo e full-text, ricerca dei simboli, analisi delle dipendenze e contesto del task in un'unica chiamata su oltre 284 linguaggi.
- [Conosci il team: 2 umani + uno sciame di agenti IA](https://maguyva.ai/it/team)
- [Come lavoriamo: niente VC, niente prezzi per utente, niente funzionalità bloccate](https://maguyva.ai/it/how): Niente capitale esterno. Niente prezzi per utente. I tuoi dati non sono il prodotto. Come è costruito Maguyva e perché ha questo prezzo.
- [Stack tecnologico: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/it/stack): Lo stack tecnico che fa funzionare Maguyva. PostgreSQL, embedding di Voyage AI, ricerca vettoriale quantizzata, AST tree-sitter e protocollo MCP.
- [Changelog](https://maguyva.ai/it/changelog): Cosa è stato rilasciato in Maguyva: cambiamenti del prodotto, aggiornamenti dell’indice e degli strumenti MCP, e note dallo sviluppo. Le più recenti prima.
- [Live: Maguyva si costruisce da solo, in tempo reale](https://maguyva.ai/it/live): Niente demo preconfezionata. Questo è il log di dispatch reale — ogni chiamata di strumento, guasto e commit del team di agenti IA che costruisce Maguyva, live.

## Guides

- [Non è ricerca full-text con un impermeabile addosso. Cinque modalità di recupero combinate.](https://maguyva.ai/it/beyond-rag): Al codice non bastano semplici chunk semantici. Maguyva combina cinque modalità di recupero in un'unica risposta con risultati ordinati per pertinenza e riscontri nel repository reale, via MCP su 284 linguaggi. Piano Free, senza carta di credito.
- [I file di istruzioni non sono una mappa del tuo codice. Maguyva lo è.](https://maguyva.ai/it/beyond-rules-files): CLAUDE.md e AGENTS.md dicono a un agente come comportarsi. Non gli dicono cosa c'è nel codebase. Maguyva è il livello di contesto del codebase via MCP su 284 linguaggi. Piano Free, senza carta di credito.
- [Modificare è facile. Sapere cosa si rompe è difficile. Maguyva lo mappa.](https://maguyva.ai/it/know-what-breaks): Prima di un refactoring, il tuo agente dovrebbe conoscere ogni chiamante, modulo che importa il codice e componente dipendente. Maguyva li trova nel grafo delle chiamate reale via MCP, non con un grep. Piano Free, senza carta di credito.
- [Inizia gratis: il livello di contesto del codebase per agenti IA di programmazione](https://maguyva.ai/it/map-then-change): Prima mappa. Poi modifica. Maguyva dà al tuo agente IA di programmazione una mappa interrogabile del codebase via MCP, prima della prima modifica. 11 strumenti su 284 linguaggi. Piano Free, senza carta di credito.
- [Il tuo agente inizia alla cieca sul tuo repository. Maguyva gli dà una mappa.](https://maguyva.ai/it/stop-flying-blind): Gli agenti di programmazione scansionano i file sbagliati e modificano prima di capire il codice. Maguyva dà al tuo agente una mappa interrogabile del codebase via MCP su 284 linguaggi. Piano Free, senza carta di credito.