Para usuarios de Warp

El agente de Warp vive en la terminal. Dale un mapa del repo.

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.

Empieza gratis Ver la configuración de Warp

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

Una entrada mcpServers en ~/.warp/.mcp.json: una URL y un encabezado Authorization.

Lo que Warp necesita saber

Cuatro datos propios de Warp.

// archivo de configuración

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

// transporte

Remoto, por URL

Una entrada url se conecta por Streamable HTTP o SSE. Nada se ejecuta en local y no hace falta Node.js.

// clave

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.

// archivos de proyecto

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.

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

// workflow 01

Rastrear un script que falla hasta su origen

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.

// workflow 02

Revisar los llamadores antes de cambiar un paso de arranque

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.

// step 01

Indexa un repo en maguyva.ai

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

// step 02

Añade Maguyva a ~/.warp/.mcp.json

~/.warp/.mcp.json

{
  "mcpServers": {
    "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. Comprueba en Settings → Agents → MCP servers que el servidor está en marcha y haz una pregunta cuya respuesta ya conozcas.