La respuesta corta
- 1Necesitas GitHub Copilot habilitado en VS Code (el nivel gratuito basta). Sin él, los comandos MCP no se ofrecen.
- 2Lo más rápido: Add to VS Code en skillry.dev/mcp, o un comando
code --add-mcpen una terminal. - 3Confirma con MCP: List Servers en la Command Palette:
skillrydebe estar en ejecución.
Antes de empezar
La vía code --add-mcp se probó en macOS con VS Code 1.141 el 28 de octubre de 2026. Las demás vías siguen la documentación oficial y aún no se han ejecutado en una instalación real.
- VS Code con GitHub Copilot con sesión iniciada y las funciones de IA habilitadas. El nivel gratuito de Copilot basta.
- Node.js 22 o más reciente (
node --version). VS Code arranca el servidor connpx. - VS Code tiene dos formatos de archivo: su propio
mcp.jsoncon una claveservers, y el archivo portátil de Copilot~/.copilot/mcp-config.jsoncon una clavemcpServers. Ambos funcionan; esta página te dice cuál escribe cada vía.
| Vía | Escribe en | Va bien cuando |
|---|---|---|
| Enlace Add to VS Code | El mcp.json de tu perfil de usuario | Ya estás en skillry.dev/mcp |
| MCP: Add Server en la Command Palette | ~/.copilot/mcp-config.json (Copilot Global) | Prefieres hacer clics dentro de VS Code |
code --add-mcp en una terminal | El mcp.json de tu perfil de usuario | Te gusta un solo comando |
Editar mcp.json tú mismo | El archivo que abras | Quieres ver la entrada |
Añadir Skillry a VS Code
- 1
Abre skillry.dev/mcp, elige VS Code y tu sistema operativo, y pulsa Add to VS Code. Permite que el navegador abra VS Code.
- 2
VS Code muestra el nombre del servidor y el comando y te pide confirmar. Elige Install.
Deberías ver: La entrada en tu
mcp.jsonde usuario, con una acción Start encima. Púlsala, o espera a que el servidor arranque en el primer uso.
- 1
Abre la Command Palette (⇧⌘P en macOS, Ctrl+Mayús+P en Windows) y ejecuta MCP: Add Server.
- 2
Elige Command (stdio) e introduce el comando de arranque:
npx --yes skillry-cli@latest mcpen macOS,cmd /c npx --yes skillry-cli@latest mcpen Windows. - 3
Introduce
skillrycomo ID del servidor. - 4
Elige Global y luego Copilot Global cuando se te pida. Esto escribe
~/.copilot/mcp-config.json.Deberías ver: Un aviso de confianza para el servidor nuevo. Acéptalo para que VS Code pueda arrancarlo.
- 1
Ejecuta esto en una terminal. En Windows usa PowerShell, donde las comillas simples funcionan tal cual.
macOS code --add-mcp '{"name":"skillry","type":"stdio","command":"npx","args":["--yes","skillry-cli@latest","mcp"]}'Deberías ver:
Added MCP servers: skillry. VS Code se abre o pasa al frente. - 2
En Windows, ejecuta esto en su lugar para que Windows pueda arrancar
npx:Windows (PowerShell) code --add-mcp '{"name":"skillry","type":"stdio","command":"cmd","args":["/c","npx","--yes","skillry-cli@latest","mcp"]}'
- 1
Ejecuta MCP: Open User Configuration desde la Command Palette. Abre el
mcp.jsonde tu perfil de usuario y lo crea si hace falta. - 2
Fusiona esto en el objeto
servers, conservando los servidores que ya haya.macOS { "servers": { "skillry": { "type": "stdio", "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
En Windows usa esta entrada en su lugar.
Windows { "servers": { "skillry": { "type": "stdio", "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
Guarda. VS Code muestra Start encima de la entrada; púlsalo.
Deberías ver: El servidor en ejecución en MCP: List Servers.
Comprobar que VS Code está conectado
- 1
Ejecuta MCP: List Servers desde la Command Palette y selecciona
skillry.Deberías ver: Un servidor en ejecución con acciones como Stop, Restart y Show Output. Si está detenido, elige Start.
- 2
Abre Chat, cambia al modo Agent y abre el selector de herramientas.
Deberías ver: Las herramientas de Skillry, empezando por
search_skills, listas para marcar.
Prueba tu primera búsqueda
Buscar no requiere cuenta, así que es la forma más rápida de comprobar que la conexión funciona.
- 1
Abre una conversación nueva en el modo agente de Copilot Chat y pega esta petición.
Prompt para tu agente Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.Deberías ver: Tres Skills candidatos, cada uno con enlace de vista previa, las entradas que necesita, sus dependencias y cualquier coste externo. No se instala nada.
- 2
Si el agente responde que no tiene ninguna herramienta de Skillry, o la petición se queda colgada, ve a No funciona.
Si VS Code no ve Skillry
| Qué ves | Causa probable | Qué hacer |
|---|---|---|
| MCP: Add Server no está en la Command Palette | Copilot no tiene sesión iniciada o las funciones de IA están desactivadas | Inicia sesión en GitHub y habilita Copilot. Los comandos MCP aparecen cuando Chat está disponible. |
| El servidor aparece en la lista pero detenido, o muestra un error | Nunca se arrancó, o npx falló | Elige Start en MCP: List Servers y luego Show Output para leer el error. Un npx ausente significa que Node.js no está instalado para el shell que usa VS Code. |
| Las herramientas nunca aparecen en Chat | Chat no está en modo Agent, o las herramientas están desmarcadas | Cambia al modo Agent, abre el selector de herramientas y marca las herramientas de Skillry. |
| El servidor aparece en la lista pero marcado como fallido, o nunca arranca | npx no está instalado, Node.js es anterior a la versión 22, o el primer arranque agotó el tiempo mientras descargaba el paquete | Ejecuta node --version y npx --version en una terminal. Luego ejecuta una vez a mano npx --yes skillry-cli@latest mcp, espera a que arranque, pulsa Ctrl+C y vuelve a probar el cliente: el paquete ya está en caché. |
| En Windows el servidor se cierra en cuanto arranca | La entrada lanza npx directamente, y Windows necesita un shell para ejecutarlo | Usa la entrada para Windows de esta página: el comando es cmd y los argumentos empiezan por /c, npx. |
| La página del navegador dice que la solicitud es inválida o ha caducado | El código de dispositivo se aprobó demasiado tarde, o pertenece a un intento anterior | Pide al agente que se conecte de nuevo y aprueba el código nuevo en pocos minutos. |
| La instalación se detiene con un mensaje de Premium o de compra | El Skill es Premium y tu cuenta no tiene ni plan ni compra para él | Sigue el enlace que muestra el agente para comprar el Skill o suscribirte, y vuelve a pedirlo. No se cobra nada hasta que lo hagas. |
Quitar o desconectar
- 1
Ejecuta MCP: List Servers, selecciona
skillryy luego Uninstall; o borra la entrada del archivo que la contiene.Deberías ver:
skillrydesaparece de la lista.
Quitar la entrada no cierra tu sesión en Skillry. Para revocar también la aprobación guardada, pide primero al agente que desconecte tu cuenta de Skillry, o quita la entrada y deja que la aprobación caduque a los 7 días.
Referencia
| Archivo | macOS | Windows |
|---|---|---|
mcp.json del perfil de usuario (clave servers) | ~/Library/Application Support/Code/User/mcp.json | %APPDATA%\Code\User\mcp.json |
Archivo de Copilot (clave mcpServers) | ~/.copilot/mcp-config.json | %USERPROFILE%\.copilot\mcp-config.json |
| Archivo del espacio de trabajo | .vscode/mcp.json en el proyecto | igual |
| Comando de arranque | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
{
"servers": {
"skillry": {
"type": "stdio",
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}Todos los campos, el formato de la URL de instalación y los dos formatos de archivo están en la referencia de configuración de MCP.
Preguntas frecuentes
¿Necesito Copilot?
Sí. El soporte MCP de VS Code vive en el modo agente de Copilot Chat. El nivel gratuito de Copilot basta.
¿Qué archivo debo usar?
Cualquiera de ellos. El enlace y code --add-mcp escriben el mcp.json del perfil de usuario; MCP: Add Server escribe el archivo de Copilot. No añadas Skillry a ambos.
¿Puedo compartirlo con mi equipo?
Pon la entrada en .vscode/mcp.json en el repositorio (formato servers). Los compañeros reciben un aviso de confianza la primera vez que VS Code lo arranca.
Fuentes
¿Te ha sido útil esta guía?
