# Zed es rápido. Igual el agente tiene que encontrar el código. Canonical source: https://maguyva.ai/es/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). 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. > 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. ### 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. ### Remoto, por URL Zed se conecta por HTTP directamente al endpoint remoto de Maguyva. Sin proceso local, sin Node.js. ### 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. ### 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. ```text # .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. ### 01. Encontrar la implementación antes de que el agente abra una pestaña ```text 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. ### 02. Revisar dependientes antes de cambiar una firma ```text 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. ### 01. Indexa un repo en maguyva.ai Elige uno que ya conozcas, así puedes evaluar las respuestas. ### 02. Agrega Maguyva a context_servers en la configuración de Zed `~/.config/zed/settings.json` ```json { "context_servers": { "maguyva": { "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } } ``` ### 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. La [documentación de MCP](https://zed.dev/docs/ai/mcp) de Zed cubre servidores de contexto, perfiles de agente y permisos de herramientas. ## Indexa un repo que ya conozcas. Conecta Zed vía MCP y haz una pregunta que puedas comprobar.