A resposta curta
- 1Adicione uma entrada ao seu cliente. Ela inicia
npx --yes skillry-cli@latest mcp(no Windowscmd /c npx …): nada para baixar à mão e nenhuma chave de API. - 2Buscar funciona sem conta. Na primeira instalação, o agente abre uma página no navegador onde você aprova uma vez; a aprovação fica no chaveiro do sistema por 7 dias.
- 3Escolha o seu cliente abaixo para os passos exatos. Cada página de cliente termina com como confirmar a conexão e o que fazer quando falha.
O que você precisa
- Um Mac ou um PC com Windows. Linux ainda não é suportado, porque a aprovação fica no chaveiro do sistema e a Skillry só suporta Keychain e Gerenciador de Credenciais.
- Node.js 22 ou mais recente. Confira com
node --version; se o comando não existir, instale a versão LTS em nodejs.org. - Um dos seis clientes abaixo, logado e atualizado.
- Uma conta Skillry só na hora de instalar. Buscar e ler os detalhes de uma Skill não exige nada. Uma conta gratuita instala Skills gratuitas; Skills Premium exigem uma compra ou um plano.
Escolha o seu cliente
Claude CodeUm comando em qualquer terminal; testado no macOS.
CodexUm comando, ou as configurações do app ChatGPT para desktop. CLI, app e extensão do IDE compartilham a entrada.
CursorUm link Add to Cursor, ou duas linhas no mcp.json.VS CodeUm link, a Command Palette, code --add-mcp ou mcp.json. Precisa do Copilot.
Gemini CLI / Antigravitygemini mcp add, ou o mcp_config.json compartilhado que o Antigravity lê.
Claude DesktopInstale a extensão de desktop da SkillryO que acontece, em ordem
Você adiciona a Skillry ao seu cliente
O cliente inicia o servidor local com npx na primeira vez que precisa dele. Essa primeira inicialização baixa o pacote e pode levar dez segundos ou mais; as seguintes são instantâneas.
Você descreve o que quer fazer
O agente chama search_skills e mostra candidatas com links de prévia, entradas, dependências e custos externos. Não precisa de conta.
Você escolhe uma e diz “instala”
O agente chama get_skill_access. Se a sua conta ainda não estiver conectada, ele abre a página do navegador descrita abaixo.
Você aprova no navegador
O agente instala a Skill no agente e no escopo que você indicou. Instalar nunca executa a Skill; o agente a executa depois, quando você pedir.
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 seu agente 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.
Se o agente não vê a Skillry
Comece pela página do seu cliente, que lista as verificações próprias dele. Estes problemas acontecem em todos os clientes:
| O que você vê | Causa provável | O que fazer |
|---|---|---|
| O agente diz que não tem nenhuma ferramenta da Skillry | A entrada foi adicionada para outro projeto ou outro escopo, ou o cliente não foi reiniciado após a mudança | Rode a verificação indicada na página do seu cliente. Se o servidor estiver faltando, adicione de novo no escopo de usuário; se estiver listado, reinicie ou recarregue o cliente. |
| Buscar funciona, mas instalar é recusado com um limite diário | A sua conta chegou a 50 carregamentos de Skills hoje | O limite zera às 00:00 UTC. Enquanto isso, buscar continua funcionando. |
| 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. |
Limites e fronteiras
50 por dia
Carregamentos de Skills por conta, compartilhados entre MCP, a Skillry CLI e o site. Buscar não conta.
7 dias
Quanto dura uma aprovação no navegador. O agente pede de novo quando ela expira.
Sem chave de API
Nada para colar. A aprovação é guardada pelo seu sistema operacional, não pelo agente.
12 ferramentas
Ferramentas de busca, inspeção, instalação, atualização e conta. Todos os argumentos estão na referência.
- Instalar adiciona arquivos à pasta de Skills do seu agente. A Skillry nunca executa a Skill e nunca paga por chamadas de modelo: uma Skill que precisa de um modelo de imagem ou vídeo usa as suas próprias ferramentas ou chaves, e o agente mostra esse custo antes de você escolher.
- O servidor roda no seu computador e fala com skillry.dev apenas para o catálogo, as verificações de acesso e os downloads. Ele trata o conteúdo do catálogo e dos pacotes como dados não confiáveis.
- Você pode desconectar a qualquer momento pedindo ao agente para desconectar a sua conta Skillry, ou removendo a entrada do seu cliente.
Todas as ferramentas, na referência
A referência de ferramentas da Skillry MCP lista as 12 ferramentas com seus argumentos, padrões, exemplos e caminhos de recuperação. Você não precisa dela para se conectar, mas ela responde com precisão a “o que posso pedir?”.
Perguntas frequentes
Preciso de uma chave de API?
Não. Buscar não exige nada, e instalar exige uma aprovação única da sua conta Skillry no navegador. O único segredo guardado é a aprovação que o seu chaveiro mantém por 7 dias.
Posso continuar instalando Skills do jeito antigo?
Sim. O prompt de instalação, a Skillry CLI e os downloads em ZIP continuam disponíveis. Veja Instalar uma Skill.
O servidor envia meus arquivos para algum lugar?
Não. Ele roda localmente e só contata skillry.dev para o catálogo, as verificações de acesso e o download da Skill que você pediu.
Qual cliente devo escolher?
Escolha o cliente que você já usa. Claude Code, Codex e Gemini CLI usam um comando; Cursor e VS Code, um link de instalação; Claude Desktop, a extensão Skillry .mcpb.
Fontes
Este guia ajudou?