# Contexto que viaja com você

Canonical source: https://maguyva.ai/pt-br/blog/context-that-travels

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-09-07 · Author: Maguyva Team

> O indexador do Cursor é excelente dentro do Cursor. O Maguyva é o mapa MCP hospedado que o mesmo agente pode consultar a partir de outros editores, CLIs e CI.

O indexador do Cursor é excelente dentro do Cursor. Autocompletar, edição inline, chat e o agente naquela janela já se apoiam em um índice de projeto que o Cursor opera para o workspace aberto. Se o Cursor é a única superfície em que você escreve, e esse índice já encontra os arquivos certos, fique lá. Esse é o caso honesto de "fique onde está", e com razão é a primeira frase desta página.

Este texto trata da outra metade de uma semana comum. O mesmo repositório também é aberto no Claude Code, consultado pelo Codex CLI, revisado em uma segunda máquina, ou consultado por um agente rodando em CI. A pergunta não é "qual indexador é melhor". A pergunta é se o mapa em que o agente confia em uma janela é o mesmo em que confia na próxima.

O Maguyva é esse mapa que viaja com você. É uma camada de contexto de código MCP remota. O agente a consulta do mesmo jeito que consulta qualquer outra ferramenta MCP. Os resultados voltam como caminhos ranqueados com números de linha. O Cursor continua sendo o editor. O contexto é o que se move.

## Para que serve o indexador do Cursor

A indexação embutida do Cursor existe para que chat, agente e busca dentro do editor possam recuperar código relevante em vez de depender só do que cabe na janela de contexto bruta do modelo. Esse é o design certo para uma IDE. O índice é nativo do Cursor. Não é um servidor MCP e não é acessível por nenhum outro cliente.

Como funciona, conforme descrito na documentação pública do Cursor e no relato do próprio Cursor no momento em que este texto foi escrito: o caminho de busca principal não é mais um índice de embeddings na nuvem. A equipe do Cursor declarou em seu fórum da comunidade que a busca semântica/baseada em embeddings dedicada está sendo desativada em favor de uma recuperação baseada em grep, porque os modelos atuais já buscam bem o suficiente em uma árvore viva por conta própria. No lugar dela está o Instant Grep, um índice de busca local construído a partir de n-gramas, listas invertidas e filtros de Bloom, mantido em uma tabela de consulta mapeada em memória, de modo que as consultas são resolvidas na própria máquina do desenvolvedor, e não em um servidor.

O índice em si vive dentro do próprio diretório `.git/cursor/` do repositório, ancorado a um commit git específico; mudanças desde esse commit se sobrepõem em vez de disparar uma nova varredura, e o índice só se reconstrói quando o estado local se afastou bastante daquilo contra o que foi construído. Como fica dentro de `.git`, nunca é versionado nem enviado — apague a pasta, e o índice some. `.gitignore` é respeitado por construção, já que só conteúdo rastreado pelo git é elegível, e `.cursorignore` é aplicado no caminho de leitura. Não há mais etapa de embedding no lado do servidor nem banco de dados vetorial remoto nesse caminho. Documentações anteriores descreviam um design assistido pela nuvem — criptografia de blocos, sincronização por árvore de Merkle, reaproveitamento de índice entre colegas de equipe — e a própria equipe do Cursor já afirmou que esse design está sendo desativado, então este texto não o descreve mais como atual.

Um destaque dentro do editor é o subagente Explore do Cursor. Ele pode disparar várias buscas paralelas em sua própria janela de contexto, em um modelo mais rápido, e retornar só os achados relevantes, para que a conversa principal não fique inchada com resultados de busca. Isso é um ponto forte genuíno dentro do editor. Mantenha-o.

Workspaces multi-raiz são suportados: o contexto de cada pasta aberta fica disponível para o Agente. Alguns recursos dependentes de git, como worktrees, ficam desativados em configurações multi-raiz, e os Cloud Agents não suportam workspaces multi-raiz de jeito nenhum.

Nada disso é motivo para abandonar o Cursor. É uma descrição precisa de um mapa que é excelente onde vive.

## O que "viajar com você" realmente significa

Um mapa viaja com você quando as mesmas perguntas retornam o mesmo tipo de resposta, com citações que você pode abrir, a partir de mais de um cliente.

- No Cursor: "Onde `parseConfig` é definido, e quem o chama?"
- No Claude Code, no mesmo repo: a mesma pergunta.
- No Codex CLI, em uma máquina de revisão que nunca abriu a janela do Cursor: a mesma pergunta.
- Em um agente de CI que fala MCP: a mesma pergunta, contra o mesmo snapshot hospedado.

Se cada superfície constrói seu próprio índice privado, você não tem um mapa. Você tem vários caches que divergem. O índice do editor pode estar atualizado para a árvore em disco. A sessão da CLI pode estar um dia atrasada. O job de CI pode estar olhando um checkout diferente. O agente vai continuar soando confiante mesmo assim.

O indexador do Cursor não deveria resolver isso. Como vive dentro do editor, o contexto que ele constrói é para aquele editor. Um leitor que também precisa de uma CLI, de um pipeline de CI ou de um editor diferente precisa de uma ferramenta separada para essas superfícies. Isso é um fato de escopo, não um defeito. O Maguyva é essa ferramenta separada.

Uma contagem de linguagens publicada para o indexador do Cursor não é informada nas notas que este rascunho pode usar. O Maguyva publica mais de 279 linguagens e tecnologias baseadas em texto. Os preços do Cursor também não são copiados aqui; veja a página de preços deles. O Maguyva cobra por workspace, não por assento, com planos publicados de $0, $19, $49 e $149, dependendo da pegada indexada e do tamanho do workspace.

## Um mapa hospedado, todo cliente MCP

O Maguyva é um servidor MCP remoto. Você conecta o GitHub, escolhe os repositórios, e o pipeline na nuvem constrói símbolos, arestas do grafo e um mapa ranqueado. Você adiciona uma chave de API à configuração MCP do cliente que já usa. O Maguyva tem guias de configuração para 24 clientes MCP documentados — incluindo o Cursor — e pode se conectar a outros clientes compatíveis com MCP que suportem a configuração padrão.

A [página de configuração do Cursor](/pt-br/for-cursor) é o caminho específico do editor, se for onde você trabalha. O mesmo servidor atende Claude Code, VS Code, Windsurf, Codex CLI e o resto. Você não troca de editor. Você dá a cada agente a mesma superfície de ferramentas: 11 ferramentas MCP voltadas ao cliente em busca, símbolos, análise de dependências, recuperação de arquivos, contexto de repositório e workflows utilitários determinísticos. Recuperação semântica, estrutural, por grafo e de texto são fundidas em resultados ranqueados.

Esse é o benefício da portabilidade. As citações que você avaliou no Cursor de manhã têm a mesma forma das citações que o Codex CLI vai retornar à noite. Caminho do arquivo e número da linha. Abra-as. Se estiverem erradas, você vê. Se estiverem certas, a próxima edição tem um lugar para pousar. A afirmação aprovada é menos edições alucinadas, não a promessa de que toda edição está correta.

A atualidade é publicada. Snapshots têm carimbo de tempo, então o agente sabe qual versão da árvore está lendo. A cadência de reconstrução é diária no plano gratuito e a cada hora nos planos pagos. O limite honesto é o trabalho local não sincronizado: uma edição que só existe em uma árvore de trabalho ainda não está no mapa hospedado. Esse limite é o mesmo não importa de qual cliente você consulte, e esse é justamente o ponto. A deriva entre clientes deixa de ser um segundo limite escondido.

Os [docs](/pt-br/docs) dão o loop de ativação que se aplica a todo cliente: indexar um repo que você já conhece, conectar o cliente, fazer uma pergunta que você consiga verificar. Faça isso uma vez no Cursor. Faça de novo a partir da CLI que você realmente usa em dias de revisão. Se as duas respostas citarem o mesmo handler, o mapa viajou.

## Como os dois mapas convivem

Use os dois. Eles não são alternativas no sentido de uma página de comparação.

1. Mantenha o indexador do Cursor ativo para o projeto em disco. Deixe o Explore, o Instant Grep e o agente dentro do editor usá-lo. Esse loop é nativo e rápido.
2. Adicione o Maguyva como servidor MCP no Cursor para que a mesma sessão também possa consultar o mapa hospedado do workspace. O Cursor é um cliente Maguyva documentado. Você não está escolhendo um índice e apagando o outro.
3. Adicione o mesmo servidor Maguyva ao Claude Code, Codex CLI, ou qualquer outro cliente MCP que toque o repo. Uma única forma de chave de API. Um único workspace.
4. Se um agente de CI for compatível com MCP, aponte-o para o mesmo servidor. Ele vai ler o mesmo snapshot com carimbo de tempo que o notebook leu.

O índice do editor continua sendo a melhor ferramenta para "o que está em disco nesta janela, agora". O mapa hospedado é a melhor ferramenta para "como este workspace se parece para todo agente que vai tocá-lo hoje". Essas frases não competem.

As cotas de workspace são publicadas na [página de preços](/pt-br/pricing): repos, linhas indexadas e usuários, cobrados por workspace. Agentes e humanos compartilham a mesma contagem de usuários. Comece grátis com um repo que você já sabe avaliar. Aumente o workspace só depois que as citações sobreviverem ao contato com a árvore.

## O que esta página não afirma

Ela não afirma que o indexador do Cursor é fraco, incompleto, ou um motivo para trocar de editor. A primeira frase deste rascunho é o oposto.

Ela não afirma que o Maguyva substitui o Instant Grep ou o subagente Explore. Esses são recursos do Cursor. Eles ficam no Cursor.

Ela não inventa uma contagem de linguagens, um número de latência, nem uma economia de tokens para nenhum dos dois produtos. Números desconhecidos permanecem não publicados.

Ela não finge que trabalho local não enviado está no mapa hospedado. Snapshots com carimbo de tempo tornam esse limite visível. Eles não o removem.

O teste é comum. Indexe um repo que você já conhece. Faça uma pergunta que você consiga verificar, primeiro no Cursor, depois em um segundo cliente MCP. Contexto que viaja com você é a mesma citação nos dois lugares.

`// same map, wherever you opened it.`