Conecte a Skillry MCP no Claude Code (macOS e Windows)

A resposta curta

1Execute claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp uma vez em qualquer terminal. Sem --scope user, o servidor existe só na pasta de onde você rodou.
2Confirme com claude mcp get skillry. A linha de status deve mostrar ✔ Connected.
3A entrada fica em ~/.claude.json (Windows: %USERPROFILE%\.claude.json). Você também pode colar o JSON lá à mão.

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

Antes de começar

Testado no macOS com Claude Code 2.1.296 em 28 de outubro de 2026. O comando para Windows segue a documentação oficial e ainda não foi executado em uma máquina real.

Claude Code instalado e logado. claude --version deve imprimir uma versão 2.x.
Node.js 22 ou mais recente (node --version). O Claude Code inicia o servidor com npx, que vem com o Node.
Nada para baixar da Skillry: o npx busca o pacote na primeira vez que o servidor inicia.

O Claude Code guarda um servidor em um de três escopos. Este guia usa o escopo user, para que a Skillry esteja em todos os projetos.

Escopo	Opção	Guardado em	Use quando
User	`--scope user`	`~/.claude.json`, nível superior	Você quer a Skillry em todos os projetos. Este guia.
Local (padrão)	nenhuma	`~/.claude.json`, sob o caminho do projeto atual	Você a quer só nesta pasta.
Project	`--scope project`	`.mcp.json` no repositório	Você quer que o time receba pelo repositório. Cada pessoa aprova na primeira execução.

Adicionar a Skillry ao Claude Code

O mais rápido. Funciona em qualquer shell, inclusive PowerShell e Prompt de Comando

1
Abra um terminal em qualquer pasta e execute:
macOS
```
claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp
```
Você deve ver: Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config, depois File modified: ~/.claude.json.
2
No Windows, execute isto em vez disso. O invólucro cmd /c permite ao Windows iniciar o npx, que é um script e não um programa.
Windows (PowerShell ou Prompt de Comando)
```
claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Inicie uma nova sessão do Claude Code, ou digite /mcp em uma que já esteja aberta.
Você deve ver: skillry na lista do /mcp. Selecione para ver as 12 ferramentas.

Quando você prefere cuidar do arquivo por conta própria

1
Abra ~/.claude.json em um editor. No Windows o arquivo é %USERPROFILE%\.claude.json. O Claude Code o cria na primeira execução.
2
Mescle isto no objeto mcpServers de nível superior, mantendo os servidores que já estiverem lá.
macOS
```
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}
```
Nível superior significa ao lado das outras chaves na raiz do arquivo. Uma entrada sob o caminho de um projeto só carrega nesse projeto.

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 e inicie uma nova sessão.
Você deve ver: skillry na lista do /mcp.

Conferir se o Claude Code está conectado

1
Em um terminal, execute:
Terminal
```
claude mcp get skillry
```
Você deve ver: Scope: User config (available in all your projects), Status: ✔ Connected e o comando npx que você adicionou.
2
Para ver todos os servidores com o estado de cada um de uma vez, execute claude mcp list. Dentro de uma sessão, /mcp mostra a mesma lista e permite abrir as ferramentas de um servidor.

A primeira verificação inicia o servidor, e a primeira inicialização baixa o skillry-cli. Dê dez segundos ou mais. Um ✘ Failed to connect que persista depois disso significa que o Node ou o npx está faltando; veja abaixo.

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 Claude Code 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 Claude Code 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 /mcp não lista a Skillry

O que você vê	Causa provável	O que fazer
`/mcp` não lista skillry	Foi adicionado no escopo local em outra pasta, ou a sessão começou antes de você adicionar	Execute `claude mcp get skillry`. Se mostrar `Scope: Local config`, remova e adicione de novo com `--scope user`. Se mostrar escopo de usuário, inicie uma nova sessão.
`claude mcp add` imprime “was not saved”	O Claude Code não conseguiu escrever em `~/.claude.json`	Feche outras sessões do Claude Code, confira se o arquivo não é somente leitura e execute o comando de novo.
Conectado no seu Mac, falhando no seu PC com Windows	A entrada do Windows inicia o `npx` sem `cmd /c`	Execute `claude mcp remove skillry -s user` e depois adicione o comando para Windows desta página.
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
Remova o servidor da sua configuração de usuário:
Terminal
```
claude mcp remove skillry -s user
```
Você deve ver: Removed MCP server skillry from user config.
2
Para manter o servidor, mas desligá-lo em um projeto, alterne-o no /mcp; o Claude Code lembra disso por projeto.

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 (escopos user e local)	`~/.claude.json`	`%USERPROFILE%\.claude.json`
Comando de inicialização	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Conferir	`claude mcp get skillry`	igual
Remover	`claude mcp remove skillry -s user`	igual

A entrada que o Claude Code guarda (macOS)

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

A precedência de escopos, a aprovação por projeto e todas as outras opções estão na documentação oficial de MCP.

Perguntas frequentes

Preciso rodar o comando em cada projeto?

Não. --scope user deixa a Skillry disponível em todos os seus projetos. O escopo local padrão a amarraria à pasta em que você rodou o comando.

O Claude Code precisa reiniciar?

Uma nova sessão reconhece o servidor. Em uma sessão aberta, /mcp o mostra depois da verificação de estado.

Meu time pode compartilhar a entrada?

Sim. --scope project a escreve em .mcp.json no repositório, e cada colega aprova na primeira vez que abre o Claude Code lá.

Fontes

Este guia ajudou?

AnteriorVisão geral PróximoCodex