Conecte a Skillry MCP no Claude Desktop

Instale a extensão de desktop da Skillry

Baixe Skillry .mcpb e selecione o arquivo em Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension…. Confira as ferramentas em + → Connectors.

Antes de começar

• Claude Desktop no macOS ou Windows, atualizado: menu Claude → Verificar atualizações….
• A extensão usa o Node.js 22+ incluído no Claude Desktop; não é necessário instalá-lo separadamente. A configuração manual abaixo exige Node.js 22+ e npx.

Baixe Skillry .mcpb e selecione o arquivo em Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension…. Confira as ferramentas em + → Connectors.

Configuração manual (alternativa)

1. 1

   No menu do Claude Desktop, escolha Ajuda → Solução de problemas → Ativar modo de desenvolvedor… e depois Ativar. Se você já vê um menu Desenvolvedor, pule este passo.

   Você deve ver: Um menu Desenvolvedor ao lado dos outros.

2. 2

   Escolha Desenvolvedor → Abrir arquivo de configuração do aplicativo.

   Você deve ver: O claude_desktop_config.json abre no seu editor padrão. O Claude Desktop cria o arquivo se ele não existir.

3. 3

   Mescle isto no objeto mcpServers, mantendo os servidores que já estiverem lá. Se o arquivo ainda não tiver mcpServers, adicione como mostrado.

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

4. 4

   No Windows, use esta entrada.

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

5. 5

   Salve o arquivo e escolha Desenvolvedor → Recarregar configuração do MCP.

   Você deve ver: skillry em Connectors, como na próxima seção.

   Se a Skillry não aparecer, feche o Claude Desktop por completo e abra de novo: no macOS, saia pelo menu Claude (⌘Q); no Windows, pelo ícone da bandeja.

Conferir se o Claude Desktop está conectado

1. 1

   Em uma conversa, selecione + na caixa de mensagem e depois Connectors.

   Você deve ver: skillry na lista com suas ferramentas, começando por search_skills.

2. 2

   Para ver o status, abra Settings → Desktop app, selecione Manage ao lado de Extensions e veja em Local MCP servers (no layout antigo das configurações: Settings → Developer). Desenvolvedor → Abrir arquivo de log do MCP abre o log.

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. 1

   Abra uma conversa nova no Claude Desktop e cole este pedido.

   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. 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. 1

   Peça ao Claude 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. 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.

Se o Claude Desktop não vê a Skillry

Remover ou desconectar

Desative ou desinstale a Skillry em Extensions. Para a configuração manual, remova apenas a entrada skillry.

1. 1

   Apague a entrada skillry do claude_desktop_config.json, salve e escolha Desenvolvedor → Recarregar configuração do MCP.

   Você deve ver: skillry some de Connectors.

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

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

O formato do arquivo de configuração está na documentação do Model Context Protocol; as capturas de lá mostram uma janela de configurações antiga, com um botão Edit Config que as versões atuais não têm mais.

Perguntas frequentes