Conecta Skillry MCP en Claude Code (macOS y Windows)

La respuesta corta

1Ejecuta claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp una vez en cualquier terminal. Sin --scope user, el servidor solo existe en la carpeta desde la que lo ejecutaste.
2Confirma con claude mcp get skillry. La línea de estado debe decir ✔ Connected.
3La entrada vive en ~/.claude.json (Windows: %USERPROFILE%\.claude.json). También puedes pegar el JSON ahí a mano.

Empieza aquí:Añadirlo Comprobarlo Autorizar No funciona

Antes de empezar

Probado en macOS con Claude Code 2.1.296 el 28 de octubre de 2026. El comando para Windows sigue la documentación oficial y aún no se ha ejecutado en un equipo real.

Claude Code instalado y con sesión iniciada. claude --version debe mostrar una versión 2.x.
Node.js 22 o más reciente (node --version). Claude Code arranca el servidor con npx, que viene con Node.
Nada que descargar de Skillry: npx obtiene el paquete la primera vez que arranca el servidor.

Claude Code guarda un servidor en uno de tres ámbitos. Esta guía usa el ámbito user, para que Skillry esté en todos los proyectos.

Ámbito	Opción	Se guarda en	Úsalo cuando
User	`--scope user`	`~/.claude.json`, nivel superior	Quieres Skillry en todos los proyectos. Esta guía.
Local (por defecto)	ninguna	`~/.claude.json`, bajo la ruta del proyecto actual	Lo quieres solo en esta carpeta.
Project	`--scope project`	`.mcp.json` en el repositorio	Quieres que tu equipo lo reciba desde el repo. Cada persona lo aprueba en su primera ejecución.

Añadir Skillry a Claude Code

Lo más rápido. Funciona en cualquier shell, incluidos PowerShell y el Símbolo del sistema

1
Abre una terminal en cualquier carpeta y ejecuta:
macOS
```
claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp
```
Deberías ver: Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config, y luego File modified: ~/.claude.json.
2
En Windows, ejecuta esto en su lugar. El envoltorio cmd /c permite a Windows arrancar npx, que es un script y no un programa.
Windows (PowerShell o Símbolo del sistema)
```
claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Inicia una sesión nueva de Claude Code, o escribe /mcp en una que ya esté abierta.
Deberías ver: skillry en la lista de /mcp. Selecciónalo para ver sus 12 herramientas.

Cuando prefieres gestionar el archivo tú mismo

1
Abre ~/.claude.json en un editor. En Windows el archivo es %USERPROFILE%\.claude.json. Claude Code lo crea la primera vez que se ejecuta.
2
Fusiona esto en el objeto mcpServers de nivel superior, conservando los servidores que ya haya.
macOS
```
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}
```
Nivel superior significa junto a las demás claves en la raíz del archivo. Una entrada bajo la ruta de un proyecto solo se carga en ese proyecto.

En Windows usa esta entrada en su lugar.

Windows

{
  "mcpServers": {
    "skillry": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

4
Guarda el archivo e inicia una sesión nueva.
Deberías ver: skillry en la lista de /mcp.

Comprobar que Claude Code está conectado

1
En una terminal, ejecuta:
Terminal
```
claude mcp get skillry
```
Deberías ver: Scope: User config (available in all your projects), Status: ✔ Connected y el comando npx que añadiste.
2
Para ver todos los servidores con su estado de una vez, ejecuta claude mcp list. Dentro de una sesión, /mcp muestra la misma lista y te deja abrir las herramientas de un servidor.

La primera comprobación arranca el servidor, y el primer arranque descarga skillry-cli. Dale diez segundos o más. Un ✘ Failed to connect que persista después significa que falta Node o npx; ver abajo.

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 Claude Code 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.

Autorizar al instalar

Instalar comprueba tu cuenta de Skillry. No escribes ninguna contraseña ni pegas ninguna clave en el agente: la primera vez, abre una página en tu navegador y la apruebas ahí.

1
Pide a Claude Code que instale el Skill que elegiste, por ejemplo Instálalo para este proyecto.
Deberías ver: El agente informa de que necesita conectar tu cuenta y abre el navegador. En un cliente de terminal puede imprimir el enlace en su lugar; ábrelo tú.
2
Comprueba que el código de dispositivo de la página coincide con el que muestra el agente, inicia sesión en Skillry si te lo pide y elige Approve.
Deberías ver: Authorization approved, con una nota para volver a tu agente. El agente lo detecta en unos segundos y termina la instalación.

La aprobación dura 7 días y se guarda en el llavero de tu sistema operativo (Keychain en macOS, Administrador de credenciales en Windows). Cuando caduca, el agente simplemente te pide aprobar de nuevo. Para cerrar sesión antes, pide al agente que desconecte tu cuenta de Skillry.

Si /mcp no lista Skillry

Qué ves	Causa probable	Qué hacer
`/mcp` no lista skillry	Se añadió en el ámbito local en otra carpeta, o la sesión empezó antes de que lo añadieras	Ejecuta `claude mcp get skillry`. Si dice `Scope: Local config`, quítalo y añádelo de nuevo con `--scope user`. Si dice ámbito de usuario, inicia una sesión nueva.
`claude mcp add` imprime «was not saved»	Claude Code no pudo escribir `~/.claude.json`	Cierra las demás sesiones de Claude Code, comprueba que el archivo no sea de solo lectura y ejecuta el comando otra vez.
Conectado en tu Mac, fallando en tu PC con Windows	La entrada de Windows arranca `npx` sin `cmd /c`	Ejecuta `claude mcp remove skillry -s user` y luego añade el comando para Windows de esta página.
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
Quita el servidor de tu configuración de usuario:
Terminal
```
claude mcp remove skillry -s user
```
Deberías ver: Removed MCP server skillry from user config.
2
Para conservar el servidor pero apagarlo en un proyecto, cámbialo en /mcp; Claude Code lo recuerda por proyecto.

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

Elemento	macOS	Windows
Archivo de configuración (ámbitos user y local)	`~/.claude.json`	`%USERPROFILE%\.claude.json`
Comando de arranque	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Comprobar	`claude mcp get skillry`	igual
Quitar	`claude mcp remove skillry -s user`	igual

La entrada que guarda Claude Code (macOS)

{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

La precedencia de ámbitos, la aprobación por proyecto y todas las demás opciones están en la documentación oficial de MCP.

Preguntas frecuentes

¿Tengo que ejecutar el comando en cada proyecto?

No. --scope user hace que Skillry esté disponible en todos tus proyectos. El ámbito local por defecto lo ataría a la carpeta en la que ejecutaste el comando.

¿Claude Code necesita reiniciarse?

Una sesión nueva recoge el servidor. En una sesión abierta, /mcp lo muestra tras la comprobación de estado.

¿Puede mi equipo compartir la entrada?

Sí. --scope project la escribe en .mcp.json en el repositorio, y cada compañero la aprueba la primera vez que abre Claude Code ahí.

Fuentes

¿Te ha sido útil esta guía?

AnteriorVisión general SiguienteCodex