# Dar a um agente de IA o contexto de um repositório grande sem indexador local

Canonical source: https://maguyva.ai/pt-br/blog/large-repo-context-without-a-local-indexer

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

Date: 2026-08-14 · Author: Maguyva Team

> Como dar a um agente de código um mapa consultável de um repositório grande a partir da nuvem, sem rodar um indexador local no seu notebook.

Um repositório grande não cabe em uma janela de contexto, e se você já apontou um indexador de notebook para um monorepo de verdade, sabe que ali também não cabe confortavelmente — a RAM dispara, o primeiro índice demora uma hora, e seu agente ainda começa a próxima sessão adivinhando quais arquivos importam.

A resposta usual é rodar um indexador ao lado do editor, e para um repo que cabe confortavelmente em uma única máquina, é uma boa resposta. Se o seu monorepo já indexa rápido no Cursor e esse é o único lugar onde você precisa do mapa, este texto não tem nada a acrescentar — pule-o.

Este texto trata do outro caso — quando um agente precisa de um mapa consultável de um repo grande, e você não quer rodar um indexador local para consegui-lo.

## Quando um indexador local é a ferramenta errada

Um índice local assume que o código vive na máquina que o consulta, e na escala real de um monorepo essa suposição fica tensa até dentro de um único editor. O repo é simplesmente maior do que você quer manter aquecido em um notebook: você trabalha em um pacote enquanto o raio de impacto vive três diretórios adiante, e um primeiro índice a frio de uma árvore de dois milhões de linhas não é algo que você queira encarar duas vezes — nem na sua máquina, nem em um runner de CI que nunca clonou a árvore antes. Ou um colega de equipe deveria conseguir consultar o mesmo mapa que você, sem esperar a própria máquina se arrastar pelo mesmo índice.

Nada disso é motivo para jogar fora um bom indexador de editor. É motivo para também ter um mapa hospedado que qualquer um dos seus agentes possa consultar via MCP.

E o problema de escala vai além de "arquivos demais para colar". Em uma árvore grande, a pergunta interessante quase nunca é "me mostra este arquivo" — é qual arquivo, qual símbolo, quais chamadores, quais testes. Um agente que começa listando `src/` e lendo os três primeiros resultados vai alegremente perder o handler em `apps/api` e o cliente gerado em `packages/sdk`. O que você precisa é de recuperação construída a partir da árvore inteira, depois ranqueada, depois citada.

## O que "contexto de um repo grande" realmente significa

Despejar arquivos no prompt não é contexto — é uma cópia menor e pior da árvore. O que seu agente realmente precisa é fazer perguntas e receber respostas citadas de volta: onde esse símbolo é definido e quem o chama, o que depende do módulo que estou prestes a mudar, qual arquivo de teste cobre esse comportamento, e como a árvore se parece *agora*, não no trimestre passado.

Essas respostas têm que vir de um índice construído a partir do seu repo, e não da memória do modelo sobre repos de outras pessoas, e o índice tem que viver em algum lugar diferente da janela de contexto do agente. Para esse problema, ele também deveria viver em algum lugar diferente do seu notebook.

Mais uma coisa que arquivos de instrução não podem fazer por você: `CLAUDE.md` e `AGENTS.md` são o lugar certo para convenções e comportamento, mas não são um mapa vivo, ranqueado e consultável de uma árvore de dois milhões de linhas. Use regras para comportamento; use inteligência de repositório para fatos.

## Construir o mapa na nuvem, consultá-lo de qualquer cliente

O Maguyva é uma camada de contexto de código MCP remota. Você conecta o GitHub, escolhe seus repositórios, e vai embora enquanto pipelines na nuvem analisam a árvore, constroem os símbolos e as arestas do grafo, e mantêm um mapa ranqueado — sem indexador local, nunca.

Quando você envia código, arquivos alterados são analisados incrementalmente, e as camadas de grafo e ranqueamento se reconstroem em uma programação: diária no plano gratuito, a cada hora nos pagos. Cada snapshot tem carimbo de tempo, então seu agente consegue saber qual versão da árvore está lendo. O limite honesto aqui é o trabalho local não sincronizado — uma edição que só existe na sua árvore de trabalho, nunca enviada, ainda não está no mapa hospedado.

Aí você conecta o cliente que já usa adicionando uma chave de API à configuração MCP dele. Há guias de configuração para 24 clientes MCP documentados, e qualquer outro cliente compatível com MCP que suporte configuração padrão também pode se conectar. Se o Cursor é onde você mora, a [página do Cursor](/pt-br/for-cursor) percorre esse caminho; o mesmo servidor atende Claude Code, VS Code, Windsurf, Codex CLI e o resto.

Você não troca de editor. Você dá ao seu agente uma superfície de ferramentas — 11 ferramentas MCP em busca, símbolos, análise de dependências, recuperação de arquivos e contexto de repositório — com cobertura em mais de 279 linguagens e tecnologias baseadas em texto, o que importa mais do que se pensa em um monorepo que deixou de ser uma única linguagem há anos.

As respostas voltam fundamentadas, como caminhos de arquivo com números de linha. Recuperação semântica, estrutural, por grafo e de texto são fundidas em resultados ranqueados, de modo que uma pergunta como "o que depende de parseConfig" não te dá nem um despejo de grep nem um único trecho semântico, mas o punhado de lugares que realmente importam.

## Um passo a passo concreto

Não comece indexando a empresa inteira. Aqui está o caminho que funciona:

1. Escolha um repositório que você já conhece bem — um pacote que você consiga avaliar à mão vale mais que a maior árvore que você tem.
2. Comece grátis: 3 repos, 50 mil linhas indexadas, todas as 11 ferramentas, sem cota mensal de consultas. Se seu repo representativo for maior que isso, a [página de preços](/pt-br/pricing) lista os níveis de workspace ($0, $19, $49, $149) por pegada indexada — não por número de assentos.
3. Conecte o GitHub e espere o primeiro índice terminar. Você não está compilando nada localmente.
4. Conecte o cliente MCP — algumas linhas de configuração. O Maguyva é um servidor MCP remoto, então não há plugins, nem extensões, nem um segundo editor para adotar.
5. Faça uma pergunta que você consiga verificar. "O que depende de parseConfig?" ou "Onde a expiração de sessão de login é tratada?" Depois abra os resultados citados `file.ext:line` e confira contra a árvore na sua frente.
6. Só depois que as citações sobreviverem a esse contato você deixa o agente editar.

Se o primeiro repo encaixar bem e sua árvore for grande, aumente o workspace para acompanhar suas linhas indexadas e a cadência de reconstrução. Humanos e agentes compartilham a mesma contagem de usuários — o Maguyva cobra por workspace, não por assento — então adicionar um terceiro agente ao loop não custa nada.

O teste de ativação é o mesmo que os [docs](/pt-br/docs) recomendam para qualquer primeira execução: indexar um repo que você já conhece, fazer uma pergunta que você consiga verificar. Um repo grande não muda o teste; só torna um primeiro arquivo errado mais caro.

## O que observar depois de conectado

Fique de olho em três coisas. Atualidade: planos pagos reconstroem a cada hora, os gratuitos diariamente, e trabalho local não enviado não estará no mapa — essa é a troca que você aceita. Escopo: indexe um conjunto representativo de repos, não cada fork arquivado; o nível gratuito é deliberadamente dimensionado para descobrir se as respostas valem a pena manter. E verificação: um mapa de repo grande que não consegue citar caminhos e números de linha é só um motor de adivinhação mais lento, então faça seu agente mostrar o lugar antes de entregar o patch.

Depois rode o mesmo teste que rodaria em um repo pequeno. Indexe um repo que você já conhece. Faça uma pergunta que você consiga verificar. Se o mapa for real, seu agente para de começar de uma árvore fria.

`// no laptop got hot building this map.`