Conecta Skillry MCP en Cursor (enlace o mcp.json)

La respuesta corta

1En skillry.dev/mcp elige Cursor, pulsa Add to Cursor y confirma el servidor dentro de Cursor.
2O fusiona la entrada skillry en ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto).
3Comprueba en la página Customize de Cursor: skillry debe estar activado y listar sus herramientas.

Empieza aquí:Añadirlo Comprobarlo Autorizar No funciona

Antes de empezar

Comprobado con la documentación oficial el 28 de octubre de 2026. Aún no se ha ejecutado en una instalación real de este cliente; si algún paso es distinto en tu equipo, usa Informar de un problema al final de la página.

Cursor instalado y con sesión iniciada.
Node.js 22 o más reciente (node --version). Cursor arranca el servidor con npx.

Archivo	Se aplica a	Úsalo cuando
`~/.cursor/mcp.json`	Todos los proyectos de este ordenador	Quieres Skillry en todas partes. Esta guía.
`.cursor/mcp.json` en un proyecto	Solo ese proyecto	Quieres compartirlo con un equipo a través del repositorio.

Añadir Skillry a Cursor

Lo más rápido. Cursor te muestra la entrada antes de guardarla

1
Abre skillry.dev/mcp, elige Cursor y tu sistema operativo.
2
Pulsa Add to Cursor. Tu navegador pregunta si abrir Cursor; permítelo.
3
En Cursor, revisa el servidor llamado skillry y su comando npx, y confirma.
Deberías ver: skillry en la lista MCP de la página Customize.
Que Cursor se abra no es lo mismo que Skillry esté conectado. Comprueba la página Customize, o ejecuta la primera búsqueda de abajo.

Cuando quieres ver exactamente qué se guarda

1
Crea o abre ~/.cursor/mcp.json. Para un solo proyecto, usa .cursor/mcp.json dentro de ese proyecto en su lugar.

Fusiona esto en el objeto mcpServers, conservando los servidores que ya haya.

macOS

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

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. Cursor recoge el cambio; si el servidor no aparece, reinicia Cursor.
Deberías ver: skillry en la lista MCP de la página Customize.

Comprobar que Cursor está conectado

1
Abre Customize desde la barra lateral y busca skillry entre los servidores MCP.
Deberías ver: El servidor activado, con estado correcto y sus herramientas listadas, empezando por search_skills.
2
Si muestra un error, selecciónalo para leer el registro; el primer arranque descarga el paquete y puede tardar diez segundos o más.

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 chat de agente de Cursor 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 Cursor 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 Cursor no ve Skillry

Qué ves	Causa probable	Qué hacer
`skillry` no está en la página Customize	El archivo está en el lugar equivocado, o el JSON no es válido	Comprueba la ruta (`~/.cursor/mcp.json` para todos los proyectos) y valida el JSON: sin comas finales, y `skillry` dentro de `mcpServers`.
El enlace Add to Cursor no hizo nada	El navegador bloqueó el enlace `cursor://`	Permite que el navegador abra Cursor, o usa la pestaña Editar mcp.json.
El servidor está desactivado	Se desactivó en la página Customize	Actívalo; Cursor conserva la entrada en cualquier caso.
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
En la página Customize quita skillry, o borra su entrada de mcp.json. Para conservarlo pero evitar que se cargue, desactívalo ahí en su lugar.
Deberías ver: skillry desaparece de la lista MCP.

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 global	`~/.cursor/mcp.json`	`%USERPROFILE%\.cursor\mcp.json`
Archivo de configuración del proyecto	`.cursor/mcp.json`	igual
Comando de arranque	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Comprobar	Página Customize	igual

La entrada que guarda Cursor (macOS)

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

El enlace Add to Cursor es cursor://anysphere.cursor-deeplink/mcp/install?name=skillry&config=…, donde config es la misma entrada codificada en base64. Cursor la decodifica y te la muestra antes de guardar. Los detalles están en la documentación de enlaces de instalación.

Preguntas frecuentes

¿Es seguro el enlace Add to Cursor?

Solo lleva el nombre del servidor y el comando de arranque, codificados en base64. Cursor muestra ambos antes de que confirmes, y nada se ejecuta hasta que lo hagas.

¿Archivo global o de proyecto?

Global (~/.cursor/mcp.json) para ti. De proyecto (.cursor/mcp.json) cuando un equipo debe recibirlo desde el repositorio.

¿Cursor necesita reiniciarse?

Normalmente no: la página Customize se actualiza cuando cambia el archivo. Reinicia Cursor si el servidor nunca aparece.

Fuentes

¿Te ha sido útil esta guía?

AnteriorCodex SiguienteVS Code