Conecte a Skillry MCP no VS Code (modo agente do Copilot Chat)

A resposta curta

1Você precisa do GitHub Copilot habilitado no VS Code (o plano gratuito basta). Sem ele, os comandos MCP não aparecem.
2O mais rápido: Add to VS Code em skillry.dev/mcp, ou um comando code --add-mcp em um terminal.
3Confirme com MCP: List Servers na Command Palette: skillry deve estar em execução.

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

Antes de começar

O caminho code --add-mcp foi testado no macOS com VS Code 1.141 em 28 de outubro de 2026. Os outros caminhos seguem a documentação oficial e ainda não foram executados em uma instalação real.

VS Code com GitHub Copilot logado e recursos de IA habilitados. O plano gratuito do Copilot basta.
Node.js 22 ou mais recente (node --version). O VS Code inicia o servidor com npx.
O VS Code tem dois formatos de arquivo: o seu próprio mcp.json com uma chave servers, e o arquivo portátil do Copilot ~/.copilot/mcp-config.json com uma chave mcpServers. Os dois funcionam; esta página diz qual arquivo cada caminho escreve.

Caminho	Escreve em	Bom quando
Link Add to VS Code	O `mcp.json` do seu perfil de usuário	Você já está em skillry.dev/mcp
MCP: Add Server na Command Palette	`~/.copilot/mcp-config.json` (Copilot Global)	Você prefere clicar dentro do VS Code
`code --add-mcp` em um terminal	O `mcp.json` do seu perfil de usuário	Você gosta de um único comando
Editar o `mcp.json` você mesmo	O arquivo que você abrir	Você quer ver a entrada

Adicionar a Skillry ao VS Code

O mais rápido a partir de skillry.dev

1
Abra skillry.dev/mcp, escolha VS Code e o seu sistema operacional, e clique em Add to VS Code. Permita que o navegador abra o VS Code.
2
O VS Code mostra o nome do servidor e o comando e pede confirmação. Escolha Install.
Você deve ver: A entrada no seu mcp.json de usuário, com uma ação Start acima. Clique nela, ou espere o servidor iniciar no primeiro uso.

Guiado, sem terminal

1
Abra a Command Palette (⇧⌘P no macOS, Ctrl+Shift+P no Windows) e execute MCP: Add Server.
2
Escolha Command (stdio) e digite o comando de inicialização: npx --yes skillry-cli@latest mcp no macOS, cmd /c npx --yes skillry-cli@latest mcp no Windows.
3
Digite skillry como ID do servidor.
4
Escolha Global e depois Copilot Global quando for pedido. Isso escreve em ~/.copilot/mcp-config.json.
Você deve ver: Um aviso de confiança para o novo servidor. Aceite para o VS Code poder iniciá-lo.

Um comando; testado no macOS

1
Execute isto em um terminal. No Windows use o PowerShell, onde as aspas simples funcionam como estão.
macOS
```
code --add-mcp '{"name":"skillry","type":"stdio","command":"npx","args":["--yes","skillry-cli@latest","mcp"]}'
```
Você deve ver: Added MCP servers: skillry. O VS Code abre ou vem para a frente.

No Windows, execute isto em vez disso para que o Windows consiga iniciar o npx:

Windows (PowerShell)

code --add-mcp '{"name":"skillry","type":"stdio","command":"cmd","args":["/c","npx","--yes","skillry-cli@latest","mcp"]}'

Quando você quer ver a entrada

1
Execute MCP: Open User Configuration pela Command Palette. Isso abre o mcp.json do seu perfil de usuário, criando-o se preciso.

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

macOS

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

No Windows use esta entrada em vez disso.

Windows

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

4
Salve. O VS Code mostra Start acima da entrada; clique nele.
Você deve ver: O servidor em execução em MCP: List Servers.

Conferir se o VS Code está conectado

1
Execute MCP: List Servers pela Command Palette e selecione skillry.
Você deve ver: Um servidor em execução com ações como Stop, Restart e Show Output. Se estiver parado, escolha Start.
2
Abra o Chat, mude para o modo Agent e abra o seletor de ferramentas.
Você deve ver: As ferramentas da Skillry, começando por search_skills, prontas para marcar.

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 modo agente do Copilot Chat 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 agente 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 VS Code não vê a Skillry

O que você vê	Causa provável	O que fazer
MCP: Add Server não está na Command Palette	O Copilot não está logado ou os recursos de IA estão desabilitados	Entre no GitHub e habilite o Copilot. Os comandos MCP aparecem quando o Chat fica disponível.
O servidor está listado, mas parado ou com erro	Nunca foi iniciado, ou o `npx` falhou	Escolha Start em MCP: List Servers e depois Show Output para ler o erro. Um `npx` ausente significa que o Node.js não está instalado para o shell que o VS Code usa.
As ferramentas nunca aparecem no Chat	O Chat não está no modo Agent, ou as ferramentas estão desmarcadas	Mude para o modo Agent, abra o seletor de ferramentas e marque as ferramentas da Skillry.
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
Execute MCP: List Servers, selecione skillry e depois Uninstall; ou apague a entrada do arquivo que a contém.
Você deve ver: skillry some da lista.

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

Arquivo	macOS	Windows
`mcp.json` do perfil de usuário (chave `servers`)	`~/Library/Application Support/Code/User/mcp.json`	`%APPDATA%\Code\User\mcp.json`
Arquivo do Copilot (chave `mcpServers`)	`~/.copilot/mcp-config.json`	`%USERPROFILE%\.copilot\mcp-config.json`
Arquivo do workspace	`.vscode/mcp.json` no projeto	igual
Comando de inicialização	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`

A entrada que o VS Code guarda no mcp.json (macOS)

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

Todos os campos, o formato da URL de instalação e os dois formatos de arquivo estão na referência de configuração MCP.

Perguntas frequentes

Preciso do Copilot?

Sim. O suporte a MCP do VS Code vive no modo agente do Copilot Chat. O plano gratuito do Copilot basta.

Qual arquivo devo usar?

Qualquer um deles. O link e code --add-mcp escrevem no mcp.json do perfil de usuário; MCP: Add Server escreve no arquivo do Copilot. Não adicione a Skillry nos dois.

Posso compartilhar com o meu time?

Coloque a entrada em .vscode/mcp.json no repositório (formato servers). Os colegas recebem um aviso de confiança na primeira vez que o VS Code o inicia.

Fontes

Este guia ajudou?

AnteriorCursor PróximoGemini CLI / Antigravity