Conecte a Skillry MCP no Cursor (link ou mcp.json)

A resposta curta

1Em skillry.dev/mcp escolha Cursor, clique em Add to Cursor e confirme o servidor dentro do Cursor.
2Ou mescle a entrada skillry em ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto).
3Confira na página Customize do Cursor: skillry deve estar ligado e listar as suas ferramentas.

Comece aqui:Adicionar Conferir Autorizar Não está funcionando

Antes de começar

Conferido com a documentação oficial em 28 de outubro de 2026. Ainda não executado em uma instalação real deste cliente; se algum passo for diferente na sua máquina, use Relatar um problema no fim da página.

Cursor instalado e logado.
Node.js 22 ou mais recente (node --version). O Cursor inicia o servidor com npx.

Arquivo	Vale para	Use quando
`~/.cursor/mcp.json`	Todos os projetos neste computador	Você quer a Skillry em todo lugar. Este guia.
`.cursor/mcp.json` em um projeto	Só esse projeto	Você quer compartilhar com um time pelo repositório.

Adicionar a Skillry ao Cursor

O mais rápido. O Cursor mostra a entrada antes de salvar

1
Abra skillry.dev/mcp, escolha Cursor e o seu sistema operacional.
2
Clique em Add to Cursor. O navegador pergunta se pode abrir o Cursor; permita.
3
No Cursor, revise o servidor chamado skillry e o comando npx, e confirme.
Você deve ver: skillry na lista MCP da página Customize.
O Cursor abrir não é o mesmo que a Skillry estar conectada. Confira a página Customize, ou faça a primeira busca abaixo.

Quando você quer ver exatamente o que é salvo

1
Crie ou abra ~/.cursor/mcp.json. Para um projeto só, use .cursor/mcp.json dentro desse projeto.

Mescle isto no objeto mcpServers, mantendo os servidores que já estiverem lá.

macOS

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

No Windows use esta entrada em vez disso.

Windows

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

4
Salve o arquivo. O Cursor percebe a mudança; se o servidor não aparecer, reinicie o Cursor.
Você deve ver: skillry na lista MCP da página Customize.

Conferir se o Cursor está conectado

1
Abra Customize pela barra lateral e encontre skillry entre os servidores MCP.
Você deve ver: O servidor ligado, com status saudável e as ferramentas listadas, começando por search_skills.
2
Se mostrar um erro, selecione-o para ler o log; a primeira inicialização baixa o pacote e pode levar dez segundos ou mais.

Faça a sua primeira busca

Buscar não exige conta, então é o jeito mais rápido de provar que a conexão funciona.

1
Abra uma conversa nova no chat de agente do Cursor e cole este pedido.
Prompt para o seu 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.
```
Você deve ver: Três Skills candidatas, cada uma com link de prévia, as entradas que precisa, suas dependências e eventuais custos externos. Nada é instalado.
2
Se o agente responder que não tem nenhuma ferramenta da Skillry, ou o pedido travar, vá para Não está funcionando.

Autorizar ao instalar

Instalar verifica a sua conta Skillry. Você não digita senha nem cola chave no agente: na primeira vez, ele abre uma página no seu navegador e você aprova por lá.

1
Peça ao Cursor para instalar a Skill que você escolheu, por exemplo Instale para este projeto.
Você deve ver: O agente informa que precisa conectar a sua conta e abre o navegador. Em um cliente de terminal, ele pode só imprimir o link; abra você mesmo.
2
Confira se o código de dispositivo na página é o mesmo que o agente mostra, entre na Skillry se for pedido e escolha Approve.
Você deve ver: Authorization approved, com um aviso para voltar ao agente. O agente percebe em alguns segundos e termina a instalação.

A aprovação vale por 7 dias e fica no chaveiro do seu sistema operacional (Keychain no macOS, Gerenciador de Credenciais no Windows). Quando expira, o agente simplesmente pede para aprovar de novo. Para sair antes, peça ao agente para desconectar a sua conta Skillry.

Se o Cursor não vê a Skillry

O que você vê	Causa provável	O que fazer
`skillry` não está na página Customize	O arquivo está no lugar errado, ou o JSON é inválido	Confira o caminho (`~/.cursor/mcp.json` para todos os projetos) e valide o JSON: sem vírgulas sobrando, e `skillry` dentro de `mcpServers`.
O link Add to Cursor não fez nada	O navegador bloqueou o link `cursor://`	Permita que o navegador abra o Cursor, ou use a aba Editar mcp.json.
O servidor está desligado	Foi desligado na página Customize	Ligue-o; o Cursor mantém a entrada de qualquer forma.
O servidor aparece na lista, mas como falho, ou nunca inicia	`npx` não está instalado, o Node.js é anterior à versão 22, ou a primeira inicialização estourou o tempo enquanto baixava o pacote	Execute `node --version` e `npx --version` em um terminal. Depois rode uma vez à mão `npx --yes skillry-cli@latest mcp`, espere iniciar, pressione Ctrl+C e tente o cliente de novo: o pacote agora está em cache.
No Windows o servidor fecha assim que inicia	A entrada inicia o `npx` diretamente, e o Windows precisa de um shell para executá-lo	Use a entrada para Windows desta página: o comando é `cmd` e os argumentos começam com `/c`, `npx`.
A página do navegador diz que a solicitação é inválida ou expirou	O código de dispositivo foi aprovado tarde demais, ou pertence a uma tentativa anterior	Peça ao agente para conectar de novo e aprove o novo código em poucos minutos.
A instalação para com uma mensagem de Premium ou de compra	A Skill é Premium e a sua conta não tem nem plano nem compra para ela	Siga o link que o agente mostra para comprar a Skill ou assinar, e peça de novo. Nada é cobrado até você fazer isso.

Remover ou desconectar

1
Na página Customize remova skillry, ou apague a entrada do mcp.json. Para manter sem carregar, desligue-o por lá.
Você deve ver: skillry some da lista MCP.

Remover a entrada não encerra a sua sessão na Skillry. Para revogar também a aprovação guardada, peça primeiro ao agente para desconectar a sua conta Skillry, ou remova a entrada e deixe a aprovação expirar depois de 7 dias.

Referência

Item	macOS	Windows
Arquivo de configuração global	`~/.cursor/mcp.json`	`%USERPROFILE%\.cursor\mcp.json`
Arquivo de configuração do projeto	`.cursor/mcp.json`	igual
Comando de inicialização	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Conferir	Página Customize	igual

A entrada que o Cursor guarda (macOS)

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

O link Add to Cursor é cursor://anysphere.cursor-deeplink/mcp/install?name=skillry&config=…, em que config é a mesma entrada codificada em base64. O Cursor a decodifica e mostra antes de salvar. Os detalhes estão na documentação de links de instalação.

Perguntas frequentes

O link Add to Cursor é seguro?

Ele leva só o nome do servidor e o comando de inicialização, codificados em base64. O Cursor mostra os dois antes de você confirmar, e nada roda até você confirmar.

Arquivo global ou do projeto?

Global (~/.cursor/mcp.json) para você. Do projeto (.cursor/mcp.json) quando um time deve receber pelo repositório.

O Cursor precisa reiniciar?

Normalmente não: a página Customize atualiza quando o arquivo muda. Reinicie o Cursor se o servidor nunca aparecer.

Fontes

Este guia ajudou?

AnteriorCodex PróximoVS Code