# El agente de Warp vive en la terminal. Dale un mapa del repo. Canonical source: https://maguyva.ai/es/for-warp 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 Warp ejecuta comandos y lee lo que imprimen. Maguyva indexa el repo entero y lo sirve por MCP, así que el agente pregunta dónde vive el código en vez de encadenar grep y cat hasta que algo coincida. > Una entrada mcpServers en ~/.warp/.mcp.json: una URL y un encabezado Authorization. ## Lo que Warp necesita saber Cuatro datos propios de Warp. ### ~/.warp/.mcp.json Warp arranca por su cuenta los servidores de este archivo global. También puedes pegar el mismo JSON en Settings → Agents → MCP servers → + Add. ### Remoto, por URL Una entrada `url` se conecta por Streamable HTTP o SSE. Nada se ejecuta en local y no hace falta Node.js. ### Un encabezado literal La clave va directamente en el encabezado `Authorization`. Déjala en el archivo global, no en el `.warp/.mcp.json` de un proyecto que subes al repo. ### Nunca arrancan solos Warp detecta `.warp/.mcp.json` en un repo clonado, pero espera a que arranques cada servidor. Si lo activas, también puede leer servidores de las configuraciones de Claude Code y Codex. ## Las reglas de proyecto son un acuerdo de trabajo. Úsalas. ```text # AGENTS.md - Ejecuta make test antes de dar un cambio por terminado. - Usa los scripts de bin/, no comandos improvisados. ``` Warp lee las reglas de proyecto de `AGENTS.md` (o de `WARP.md`, que manda si existen ambos) y aplica las Global Rules en todas partes. Úsalas para: - Comandos de build, test y despliegue. - Convenciones que el agente sigue fallando. - Comandos que el agente nunca debe ejecutar. Las reglas le dicen al agente cómo trabajar. No pueden decirle qué servicio sigue leyendo la variable de entorno que estás a punto de eliminar. ## Donde se acaba grep en la terminal Tres cosas que una sesión de shell no aprende barato. ### // la salida se desplaza Cada grep y cada cat que ejecuta el agente acaban en la conversación. Una búsqueda que imprime doscientas líneas gasta contexto antes de que empiece el trabajo de verdad. ### // una coincidencia no es un llamador grep no distingue una llamada real de un comentario, un fixture o un método homónimo de otra clase. ### // la shell arranca en frío Una sesión nueva no sabe nada del repo. El índice de Maguyva ya está construido, así que la primera pregunta recibe una respuesta clasificada. ## Maguyva como servidor MCP en Warp Una entrada mcpServers le da al agente de Warp: - **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 más de 285 lenguajes, lo bastante cortas para leerlas en un panel de terminal. - **Herramientas que solo leen**: Las herramientas de Maguyva consultan el índice. Ninguna edita archivos ni ejecuta comandos. > Warp le da al agente *una terminal*. > Maguyva le da al agente *un mapa del código*. ## Dos flujos de trabajo Primero pregunta al mapa; después, ejecuta comandos. ### 01. Rastrear un script que falla hasta su origen ```text warp agent> deploy.sh falla: BUILD_ID no está definido. ¿dónde se define? text_pattern_search("BUILD_ID=") ci/env.sh:9 export BUILD_ID=... docs/deploy.md:31 ← texto → El agente carga ci/env.sh y vuelve a lanzar el despliegue. [exit 0] ``` Una búsqueda indexada sustituye a un grep recursivo por todo el repo y a su salida. ### 02. Revisar los llamadores antes de cambiar un paso de arranque ```text warp agent> ¿podemos dejar de ejecutar las migraciones al arrancar? dependency_search("runMigrations", dependents) 3 llamadores: server.ts, worker.ts, scripts/seed.ts → El agente mueve los tres al paso de release. [exit 0] ``` Los llamadores llegan antes del cambio, así que el worker no arranca contra un esquema antiguo. ## Configuración en Warp 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. Añade Maguyva a ~/.warp/.mcp.json `~/.warp/.mcp.json` ```json { "mcpServers": { "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. Comprueba en Settings → Agents → MCP servers que el servidor está en marcha y haz una pregunta cuya respuesta ya conozcas. La [documentación de MCP](https://docs.warp.dev/agents/capabilities/mcp/) de Warp cubre los servidores definidos en archivos, el uso compartido y la autenticación. ## Indexa un repo que ya conozcas. Conecta Warp por MCP y haz una pregunta que puedas comprobar.