# Maguyva Receitas curtas para fluxos de trabalho Maguyva MCP comuns: instalar um cliente, pesquisar antes de editar, resultados vazios e trabalho com vários repositórios. [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/pt-br/docs/quickstart.md) or send `Accept: text/markdown`. Release feeds: [RSS](https://maguyva.ai/pt-br/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/pt-br/changelog.json). ## Capacidades por Linguagem Abaixo estão as contagens de capacidades que impulsionam a busca estrutural, a busca de símbolos, a análise orientada por grafo e a indexação básica. Estes indicadores mostram as capacidades habilitadas na configuração atual das linguagens, não pontuações de qualidade de ponta a ponta. Para o grafo estar disponível, o analisador, a extração de símbolos e a extração do grafo precisam estar habilitados. Os tipos de relações compatíveis e a profundidade da extração variam conforme a linguagem. - Cobertura indexada: **284**. Todas as linguagens listadas são indexadas para contexto de arquivo, texto e repositório. - Busca estrutural via AST: **247**. Linguagens com estrutura baseada em parser para fluxos de trabalho de AST e busca estrutural. - Extração de símbolos: **282**. Linguagens com metadados de símbolos para definições e consultas. - Relações de grafo: **151**. Linguagens com extração operacional de relações para busca orientada por grafo. A profundidade varia conforme a linguagem e o tipo de relação. - `ast_structural=false`: Indexação focada em texto, com análise estrutural mais limitada. - `symbol_extraction=false`: A extração de símbolos é limitada, então a navegação depende mais do contexto de arquivo e estrutura. - `relationship_extraction=false`: Esta linguagem é indexada para busca, mas atualmente não é persistida no grafo de código. [Encontre sua linguagem](/llms-full.txt) ## Receitas Receitas práticas para o trabalho diário do Maguyva MCP. Cada receita nomeia as ferramentas e a sequência — não uma referência completa dos parâmetros. Para parâmetros de ferramenta, use [Referência da API MCP](https://maguyva.ai/pt-br/docs/mcp-api). Para configuração inicial, use [Início rápido](https://maguyva.ai/pt-br/docs/quickstart). ### Escolha a ferramenta certa A maioria das perguntas começa com uma chamada. Só aprofunde a busca quando a primeira resposta for muito ampla ou trouxer pouca informação. - `intelligent_search` — comece aqui para fazer uma pergunta em linguagem natural sobre a base de código. Por padrão, auto/balanced direciona perguntas sobre definições cuja intenção identifica com confiança para a busca estrutural, perguntas sobre referências ou impacto para o grafo e perguntas de correspondência exata para o texto. As demais perguntas usam o significado semântico e o texto indexado. Use mode=hybrid ou auto com quality=thorough para solicitar as quatro modalidades de busca. Um mode explícito tem prioridade sobre quality. - `find_symbol` — você já conhece o nome da função, classe ou variável. - `dependency_search` — raio de impacto: código que faz chamadas, código dependente ou impacto antes (e depois) de uma edição. - `get_task_context` — área desconhecida; um pacote limitado de arquivos, símbolos e dependências para uma descrição de tarefa. - `repository_context` — liste repositórios acessíveis ou inspecione como o nome de um repositório é resolvido. - `ask_maguyva` com `operation="guidance"` — ajuda local na seleção de ferramentas e uso de Maguyva (sem alterar o repositório). ## Tools -- Search - [intelligent_search](https://maguyva.ai/pt-br/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/pt-br/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/pt-br/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/pt-br/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/pt-br/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/pt-br/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/pt-br/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/pt-br/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/pt-br/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/pt-br/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/pt-br/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. ## Próximas etapas - [Início rápido](https://maguyva.ai/pt-br/docs/quickstart) - [Guia de instalação](https://maguyva.ai/pt-br/docs/installation) - [Referência da API MCP](https://maguyva.ai/pt-br/docs/mcp-api) - [Solução de problemas](https://maguyva.ai/pt-br/docs/troubleshooting) - [Como funciona](https://maguyva.ai/pt-br/docs/how-it-works) - [Compatibilidade e Especificações Técnicas](https://maguyva.ai/pt-br/docs/compatibility) ## Agent integrations - [Maguyva para o Cursor: contexto da base de código via MCP](https://maguyva.ai/pt-br/for-cursor): O Cursor edita o arquivo aberto; o Maguyva indexa o monorepo inteiro e devolve isso via MCP — busca semântica, AST, de grafo e de texto com arquivo:linha, para que o agente encontre os arquivos que você não fixou. - [Maguyva para o Windsurf: contexto da base de código via MCP](https://maguyva.ai/pt-br/for-windsurf): O Windsurf e o Cascade editam o arquivo aberto; o Maguyva indexa o monorepo inteiro e devolve isso via MCP — semântica, AST, grafo e texto com arquivo:linha, para que o Cascade encontre os arquivos que você não mencionou. - [Maguyva para o Antigravity: contexto da base de código via MCP](https://maguyva.ai/pt-br/for-antigravity): O Antigravity roda agentes autônomos entre editor, terminal e navegador; o Maguyva dá a eles um mapa consultável do monorepo via MCP — o raio de impacto de antemão, não depois que o CI fica vermelho. - [Maguyva para o Codex: contexto da base de código via MCP](https://maguyva.ai/pt-br/for-codex): O AGENTS.md é o acordo de trabalho. A Maguyva é o servidor MCP que dá ao Codex CLI um mapa consultável do repositório, para que a primeira edição não seja um palpite. - [Maguyva para qualquer cliente MCP: contexto da base de código via MCP](https://maguyva.ai/pt-br/for-anything): MCP é um protocolo aberto. O Maguyva é um servidor MCP padrão, então clientes com suporte a MCP como Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity recebem o mesmo contexto de base de código fundamentado. - [Maguyva para o Gemini CLI: contexto da base de código via MCP](https://maguyva.ai/pt-br/for-gemini): O GEMINI.md define o contexto de trabalho; o MCP é o canal. O Maguyva é o servidor MCP que dá ao Gemini CLI um mapa consultável do seu repositório — busca semântica, AST e de grafo para que a primeira edição não seja um chute. - [Maguyva para o Claude Code: contexto da base de código via MCP](https://maguyva.ai/pt-br/for-claude-code): O CLAUDE.md diz ao Claude como se comportar. A Maguyva indexa o repositório e o disponibiliza via MCP para que o Claude Code edite a partir de um mapa consultável. - [Maguyva para GitHub Copilot CLI: contexto de código via MCP](https://maguyva.ai/pt-br/for-copilot): Instruções personalizadas dizem ao Copilot como se comportar. A Maguyva indexa o repositório e o disponibiliza via MCP para que o GitHub Copilot CLI edite a partir de um mapa. ## Company - [Sobre a Maguyva: inteligência de código via MCP](https://maguyva.ai/pt-br/about): Inteligência de código para agentes de codificação: busca semântica, AST, de grafo e de texto completo, busca de símbolos, análise de dependências e contexto de tarefa em uma única chamada em mais de 284 linguagens. - [Conheça o Time: 2 Humanos + Enxame de Agentes de IA](https://maguyva.ai/pt-br/team) - [Como Trabalhamos: Sem VC, Sem Cobrança por Usuário, Sem Recursos Bloqueados](https://maguyva.ai/pt-br/how): Sem capital externo. Sem cobrança por usuário. Seus dados não são o produto. Como o Maguyva é construído e por que é precificado desse jeito. - [Stack Tecnológica: PostgreSQL, Tree-sitter, MCP](https://maguyva.ai/pt-br/stack): A stack técnica que move o Maguyva. PostgreSQL, embeddings da Voyage AI, busca vetorial quantizada, AST via tree-sitter e protocolo MCP. - [Changelog](https://maguyva.ai/pt-br/changelog): O que foi lançado na Maguyva: mudanças de produto, atualizações de índice e de ferramentas MCP, e notas do desenvolvimento. Mais recentes primeiro. - [Ao Vivo: O Maguyva Se Construindo, Em Tempo Real](https://maguyva.ai/pt-br/live): Sem demo enlatada. Este é o log de despacho real — cada chamada de ferramenta, falha e commit do time de agentes de IA que constrói o Maguyva, ao vivo. ## Guides - [Não é busca full-text vestindo um sobretudo. Cinco modos de recuperação fundidos.](https://maguyva.ai/pt-br/beyond-rag): Código precisa de mais do que blocos semânticos. O Maguyva funde cinco modos de recuperação em uma resposta ranqueada, fundamentada no repositório real via MCP em 284 linguagens. Plano Free, sem cartão. - [Arquivos de instrução não são um mapa do seu código. O Maguyva é.](https://maguyva.ai/pt-br/beyond-rules-files): CLAUDE.md e AGENTS.md dizem a um agente como se comportar. Não dizem o que tem no código. O Maguyva é a camada de contexto do código via MCP em 284 linguagens. Plano Free, sem cartão. - [A edição é fácil. Saber o que quebra é difícil. O Maguyva mapeia isso.](https://maguyva.ai/pt-br/know-what-breaks): Antes de uma refatoração, seu agente deveria conhecer todo código que faz chamadas, importa ou depende do código em questão. O Maguyva responde isso a partir do grafo de chamadas real via MCP, não de um grep. Plano Free, sem cartão. - [Comece grátis: a camada de contexto de código para agentes de IA](https://maguyva.ai/pt-br/map-then-change): Mapeie primeiro. Mude depois. O Maguyva dá ao seu agente de IA um mapa consultável do código via MCP, antes da primeira edição. 11 ferramentas em 284 linguagens. Plano Free, sem cartão. - [Seu agente começa às cegas no seu repositório. O Maguyva dá a ele um mapa.](https://maguyva.ai/pt-br/stop-flying-blind): Agentes de código escaneiam os arquivos errados e editam antes de entender o código. O Maguyva dá ao seu agente um mapa consultável do código via MCP em 284 linguagens. Plano Free, sem cartão.