# O Zed é rápido. O agente ainda precisa achar o código. Canonical source: https://maguyva.ai/pt-br/for-zed 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). O agente do Zed trabalha com os arquivos que você abre e as instruções que você dá. O Maguyva indexa o repositório inteiro e devolve tudo via MCP, então o agente pergunta onde um símbolo está em vez de chutar. > Uma entrada em context_servers: uma URL e um cabeçalho Authorization. ## O que você precisa saber sobre o Zed Quatro fatos específicos do Zed. Nenhum é difícil. ### settings.json Servidores remotos ficam em `context_servers`. Abra o arquivo com `zed: open settings file` ou adicione um servidor em Settings → AI → MCP Servers. ### Remoto, por URL O Zed se conecta via HTTP direto ao endpoint remoto do Maguyva. Sem processo local, sem Node.js. ### Um cabeçalho literal Este guia coloca a chave direto no cabeçalho `Authorization`, porque a expansão de variáveis de ambiente nos cabeçalhos do Zed não foi verificada aqui. Guarde-a nas suas configurações de usuário, não em um arquivo que você comita. ### Permissões de ferramentas Por padrão, o Zed pede confirmação antes de cada chamada de ferramenta. Libere as ferramentas do Maguyva uma a uma em `agent.tool_permissions.tools`, com chaves como `mcp:maguyva:find_symbol`. ## As instruções do projeto são um acordo de trabalho. Use-as. ```text # .rules - Rode o comando de testes do repositório antes de dar uma mudança por concluída. - Edite só dentro do pacote que pediram para mudar. ``` O Zed carrega um único arquivo de instruções do projeto: a primeira correspondência de uma lista fixa que começa com `.rules` e inclui `AGENTS.md` e `CLAUDE.md`. Instruções pessoais vão em `~/.config/zed/AGENTS.md`. Use-as para: - Comandos de build, teste e lint. - Convenções que o agente vive errando. - Diretórios em que o agente não deve mexer. Um arquivo de instruções diz ao agente como trabalhar. Ele não consegue dizer quais de quatro mil arquivos chamam a função que o agente está prestes a mudar. ## Onde o buffer aberto não dá conta Três coisas que o agente do Zed não consegue aprender com os arquivos à sua frente. ### // o arquivo aberto não é o repositório O agente vê o que você abriu e o que ele encontra com grep. Um helper com o mesmo nome em outro pacote parece idêntico até o errado ir para produção. ### // quem chama não está na tela “O que quebra se eu mudar esta assinatura?” é uma pergunta de grafo. Sem um índice, o agente lê arquivos um por um até esgotar os turnos ou o contexto. ### // contexto tem orçamento Cada arquivo que o agente abre para se orientar gasta tokens que ele não vai poder usar na mudança. Uma resposta priorizada com file:line custa menos que dez leituras exploratórias. ## O Maguyva como servidor de contexto do Zed Uma entrada em context_servers dá ao agente do Zed: - **11 ferramentas sobre o seu repositório indexado**: busca semântica, estrutural (AST), de grafo e de texto, além de busca de símbolos, dependentes e recuperação de arquivos. - **Respostas com caminhos de arquivo e números de linha**: em mais de 285 linguagens, para o agente abrir o arquivo certo logo de primeira. - **Uma lista de ferramentas sempre atual**: O Zed recarrega as ferramentas de um servidor quando ele anuncia uma mudança, sem reiniciar. > O Zed dá ao agente *um editor rápido*. > O Maguyva dá ao agente *um mapa do código*. ## Dois fluxos de trabalho Pergunte ao mapa primeiro, depois edite. ### 01. Achar a implementação antes de o agente abrir uma aba ```text zed agent> onde fica a política de retentativa dos webhooks de saída? find_symbol("retryPolicy") src/webhooks/dispatch.ts:41 retryPolicy() ← implementação src/webhooks/__mocks__/dispatch.ts:9 ← mock → O agente abre dispatch.ts:41, não o mock. [exit 0] ``` Uma consulta priorizada substitui uma rodada de grep. A resposta volta como caminho e linha que o agente pode abrir direto. ### 02. Verificar dependentes antes de mudar uma assinatura ```text zed agent> adicione um argumento timeout ao fetchInvoice dependency_search("fetchInvoice", dependents) 7 chamadores em 4 pacotes → O agente atualiza os sete pontos de chamada de uma vez. [exit 0] ``` O raio de impacto chega antes da primeira edição, não depois que o build quebra. ## Configuração no Zed Três passos. Plano Free: 3 repositórios, Até 50 mil linhas de repositório indexadas, sem cartão. ### 01. Indexe um repositório em maguyva.ai Escolha um que você já conheça, para poder avaliar as respostas. ### 02. Adicione o Maguyva a context_servers nas configurações do Zed `~/.config/zed/settings.json` ```json { "context_servers": { "maguyva": { "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } } ``` ### 03. Troque o placeholder e faça uma pergunta Troque `mgv_xxxx` pela sua chave de API e salve. Faça ao agente uma pergunta cuja resposta você já saiba e depois abra o arquivo citado. A [documentação de MCP](https://zed.dev/docs/ai/mcp) do Zed cobre servidores de contexto, perfis de agente e permissões de ferramentas. ## Indexe um repositório que você já conhece. Conecte o Zed via MCP e faça uma pergunta que você consiga conferir.