# Copilot ve tu espacio de trabajo. Maguyva traza el mapa del repo. Canonical source: https://maguyva.ai/es/for-vscode 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 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. > 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. ### .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. ### 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. ### 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. ### 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. ```text # .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. ### 01. Encontrar los tests antes de cambiar un parser ```text 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. ### 02. Medir un renombrado antes de la primera edición ```text 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. ### 01. Indexa un repo en maguyva.ai Elige uno que ya conozcas, así puedes evaluar las respuestas. ### 02. Añade Maguyva a .vscode/mcp.json `.vscode/mcp.json` ```json { "servers": { "maguyva": { "type": "http", "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer ${env:MAGUYVA_API_KEY}" } } } } ``` ### 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. La [documentación de MCP](https://code.visualstudio.com/docs/agent-customization/mcp-servers) de VS Code cubre las variables de entrada, el formato portable .mcp.json y la confianza en los servidores. ## Indexa un repo que ya conozcas. Conecta VS Code por MCP y haz una pregunta que puedas comprobar.