Para usuarios de Zed

Zed es rápido. Igual el agente tiene que encontrar el código.

El agente de Zed trabaja con los archivos que abres y las instrucciones que le das. Maguyva indexa todo el repo y lo devuelve vía MCP, así el agente pregunta dónde vive un símbolo en lugar de adivinar.

Empieza gratis Leer la configuración de Zed

Nivel Free: 3 repositorios, Hasta 50 mil líneas de repo indexadas, sin tarjeta.

Una entrada en context_servers: una URL y un encabezado Authorization.

Lo que necesitas saber de Zed

Cuatro datos propios de Zed. Ninguno es difícil.

// archivo de configuración

settings.json

Los servidores remotos van bajo context_servers. Abre el archivo con zed: open settings file o agrega un servidor desde Settings → AI → MCP Servers.

// transporte

Remoto, por URL

Zed se conecta por HTTP directamente al endpoint remoto de Maguyva. Sin proceso local, sin Node.js.

// clave

Un encabezado literal

Esta guía pone la clave directamente en el encabezado Authorization, porque aquí no está verificada la expansión de variables de entorno en los encabezados de Zed. Guárdala en tu configuración de usuario, no en un archivo que subas al repo.

// aprobaciones

Permisos de herramientas

Por defecto, Zed pregunta antes de cada llamada a una herramienta. Permite las herramientas de Maguyva una por una bajo agent.tool_permissions.tools, con claves como mcp:maguyva:find_symbol.

Las instrucciones del proyecto son un acuerdo de trabajo. Úsalas.

# .rules
- Ejecuta el comando de pruebas del repo antes de dar un cambio por terminado.
- Edita solo dentro del paquete que te pidieron cambiar.

Zed carga un único archivo de instrucciones del proyecto: la primera coincidencia de una lista fija que empieza con .rules e incluye AGENTS.md y CLAUDE.md. Las instrucciones personales van en ~/.config/zed/AGENTS.md. Úsalas para:

Comandos de build, pruebas y lint.
Convenciones en las que el agente se equivoca una y otra vez.
Directorios que el agente no debe tocar.

Un archivo de instrucciones le dice al agente cómo trabajar. No puede decirle cuáles de cuatro mil archivos llaman a la función que está por cambiar.

Donde el buffer abierto se queda corto

Tres cosas que el agente de Zed no puede aprender de los archivos que tiene enfrente.

// el archivo abierto no es el repo

El agente ve lo que abriste y lo que encuentra con grep. Un helper con el mismo nombre en otro paquete se ve idéntico hasta que se publica el equivocado.

// los llamadores no están en pantalla

“¿Qué se rompe si cambio esta firma?” es una pregunta de grafo. Sin un índice, el agente lee archivos uno por uno hasta quedarse sin turnos o sin contexto.

// el contexto tiene presupuesto

Cada archivo que el agente abre para orientarse gasta tokens que no podrá usar en el cambio. Una respuesta priorizada con file:line cuesta menos que diez lecturas exploratorias.

Maguyva como servidor de contexto de Zed

Una entrada en context_servers le da al agente de Zed:

11 herramientas sobre tu repo indexado búsqueda semántica, estructural (AST), de grafo y de texto, además de búsqueda de símbolos, dependientes y recuperación de archivos.
Respuestas con rutas de archivo y números de línea en 285+ lenguajes, así el agente abre el archivo correcto a la primera.
Una lista de herramientas siempre al día Zed recarga las herramientas de un servidor cuando este anuncia un cambio, sin reiniciar.

Zed le da al agente un editor rápido.
Maguyva le da al agente un mapa del código.

Dos flujos de trabajo

Primero consulta el mapa, después edita.

// workflow 01

Encontrar la implementación antes de que el agente abra una pestaña

zed agent> ¿dónde está la política de reintentos de los webhooks salientes?

find_symbol("retryPolicy")
  src/webhooks/dispatch.ts:41   retryPolicy()   ← implementación
  src/webhooks/__mocks__/dispatch.ts:9   ← mock

→ El agente abre dispatch.ts:41, no el mock.
[exit 0]

Una consulta priorizada reemplaza una ronda de grep. La respuesta vuelve como una ruta y una línea que el agente puede abrir directamente.

// workflow 02

Revisar dependientes antes de cambiar una firma

zed agent> agrega un argumento timeout a fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 llamadores en 4 paquetes

→ El agente actualiza los siete puntos de llamada en una pasada.
[exit 0]

El radio de impacto llega antes de la primera edición, no después de que falle el build.

Configuración en Zed

Tres pasos. Nivel Free: 3 repositorios, Hasta 50 mil líneas de repo indexadas, sin tarjeta.

// step 01

Indexa un repo en maguyva.ai

Elige uno que ya conozcas, así puedes evaluar las respuestas.

// step 02

Agrega Maguyva a context_servers en la configuración de Zed

~/.config/zed/settings.json

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

// step 03

Reemplaza el marcador y haz una pregunta

Cambia mgv_xxxx por tu clave de API y guarda. Hazle al agente una pregunta cuya respuesta ya conozcas y luego abre el archivo citado.