Para usuarios de VS Code

Copilot ve tu espacio de trabajo. Maguyva traza el mapa del repo.

El agente de VS Code lee los archivos que adjuntas y los que encuentra por su cuenta. Maguyva indexa el repo entero y lo sirve por MCP, así que antes de editar el agente pregunta dónde vive un símbolo y quién lo llama.

Empieza gratis Ver la configuración de VS Code

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

Una entrada servers en .vscode/mcp.json: una URL y un encabezado Authorization.

Lo que VS Code necesita saber

Cuatro datos propios de VS Code.

// archivo de configuración

.vscode/mcp.json

Los servidores van bajo servers, no bajo mcpServers. Para todos tus espacios de trabajo, ejecuta MCP: Open User Configuration y añade la misma entrada al mcp.json de tu perfil.

// transporte

type: http

VS Code se conecta al endpoint de Maguyva por Streamable HTTP y solo recurre a SSE si un servidor no lo admite. Nada se ejecuta en local.

// clave

Una referencia a variable de entorno

El encabezado es Bearer ${env:MAGUYVA_API_KEY}, que VS Code resuelve desde el entorno en el que se inició, así que la clave queda fuera del archivo que subes al repo. ¿Prefieres que te la pida? Una variable de entrada la solicita una vez y la guarda.

// confianza

Workspace Trust

Los servidores de .vscode/mcp.json arrancan sin un aviso aparte en cuanto confías en el espacio de trabajo, y nunca en modo restringido. Configure Tools, en la entrada del chat, activa o desactiva cada herramienta.

Las instrucciones personalizadas son un acuerdo de trabajo. Úsalas.

# .github/copilot-instructions.md
- Ejecuta npm test antes de dar un cambio por terminado.
- No edites nunca los archivos generados en src/gen/.

VS Code lee las instrucciones de todo el proyecto en .github/copilot-instructions.md o AGENTS.md, y las específicas en archivos .github/instructions/*.instructions.md con un patrón applyTo. Úsalas para:

Comandos de build, test y lint.
Convenciones que el agente sigue fallando.
Carpetas que el agente no debe tocar.

Las instrucciones le dicen al agente cómo trabajar. No pueden decirle cuáles de cuatro mil archivos importan el tipo que está a punto de renombrar.

Donde se acaba la vista del espacio de trabajo

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

// adjunto no es todo

El agente trabaja con lo que adjuntas y con lo que devuelven sus búsquedas. El llamador de otro paquete que se rompe tras el cambio no estaba en ninguna de las dos listas.

// una coincidencia de texto no es una referencia

La búsqueda del espacio de trabajo encuentra la cadena. No distingue una llamada real de un comentario, un mock o un método homónimo de otra clase.

// cada lectura cuesta contexto

Cada archivo que el agente abre para orientarse gasta el contexto que necesita para el cambio. Una respuesta clasificada con file:line cuesta menos que diez lecturas de exploración.

Maguyva como servidor MCP en VS Code

Una entrada servers le da al agente:

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.
Herramientas que solo leen Las herramientas de Maguyva consultan el índice. Ninguna edita tus archivos, así que cada aprobación es de lectura, no de escritura.

VS Code le da al agente tu espacio de trabajo.
Maguyva le da al agente un mapa del repo.

Dos flujos de trabajo

Primero consulta el mapa, después edita.

// workflow 01

Encontrar los tests antes de cambiar un parser

vscode agent> ¿qué tests pasan por parseConfig?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ Tras editar, el agente ejecuta estos dos archivos, no toda la suite.
[exit 0]

La respuesta nombra los dos archivos de test que llegan al parser, así que el agente comprueba el cambio donde puede romperse.

// workflow 02

Medir un renombrado antes de la primera edición

vscode agent> renombra OrderStatus.PENDING a OrderStatus.QUEUED

find_symbol("OrderStatus", references)
  23 referencias en 9 archivos

→ El agente planea una sola pasada por nueve archivos.
[exit 0]

El número de referencias llega antes de editar, no después de que falle el comprobador de tipos.

Configuración en VS Code

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 .vscode/mcp.json

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

Define tu clave e inicia el servidor

Define MAGUYVA_API_KEY en el entorno desde el que abres VS Code y arranca el servidor con el code lens que hay sobre su entrada. Hazle al agente una pregunta cuya respuesta ya conozcas.