Para usuários do Zed

O Zed é rápido. O agente ainda precisa achar o código.

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.

Comece grátis Leia a configuração do Zed

Plano Free: 3 repositórios, Até 50 mil linhas de repositório indexadas, sem cartão.

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.

// arquivo de configuração

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.

// transporte

Remoto, por URL

O Zed se conecta via HTTP direto ao endpoint remoto do Maguyva. Sem processo local, sem Node.js.

// chave

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.

// aprovações

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.

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

// workflow 01

Achar a implementação antes de o agente abrir uma aba

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.

// workflow 02

Verificar dependentes antes de mudar uma assinatura

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.

// step 01

Indexe um repositório em maguyva.ai

Escolha um que você já conheça, para poder avaliar as respostas.

// step 02

Adicione o Maguyva a context_servers nas configurações do Zed

~/.config/zed/settings.json

{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 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.