A resposta curta
- 1Gemini CLI: execute
gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp. Sem--scope user, vale só para o projeto atual. - 2Antigravity: mescle a entrada
skillryem~/.gemini/config/mcp_config.jsone digite/mcpno Antigravity CLI. - 3Em qualquer das duas ferramentas,
/mcpdentro de uma sessão lista o servidor e as suas ferramentas.
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.
- Gemini CLI (
gemini --version) ou Antigravity CLI (agy) instalado e logado. Se ogeminidisser que foi substituído, use a aba Antigravity. - Node.js 22 ou mais recente (
node --version).
| Ferramenta | Arquivo de configuração | Conferir |
|---|---|---|
| Gemini CLI | ~/.gemini/settings.json (usuário) ou .gemini/settings.json (projeto) | gemini mcp list ou /mcp |
| Antigravity CLI, app e IDE | ~/.gemini/config/mcp_config.json (global) ou .agents/mcp_config.json (workspace) | /mcp na CLI; Installed MCP Servers no app |
Adicionar a Skillry ao Gemini CLI ou ao Antigravity
- 1
Execute isto em qualquer terminal. O
--separa as opções do próprio Gemini dos argumentos passados aonpx.macOS gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcpVocê deve ver: Nenhum erro, e
gemini mcp listagora incluiskillry. - 2
No Windows, execute isto em vez disso para que o Windows consiga iniciar o
npx:Windows (PowerShell ou Prompt de Comando) gemini mcp add --scope user --transport stdio skillry cmd -- /c npx --yes skillry-cli@latest mcp - 3
Inicie uma nova sessão do Gemini CLI.
Você deve ver:
skillryna lista do/mcpcom as suas ferramentas.
- 1
Abra
~/.gemini/settings.json(para um projeto só,.gemini/settings.jsondentro dele). - 2
Mescle isto no objeto
mcpServers, mantendo os servidores que já estiverem lá.macOS { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
No Windows use esta entrada em vez disso.
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
Salve e inicie uma nova sessão.
Você deve ver:
skillryna lista do/mcp.
- 1
Abra ou crie
~/.gemini/config/mcp_config.json. Para um workspace só, use.agents/mcp_config.jsondentro dele. - 2
Mescle isto no objeto
mcpServers. O formato é o mesmo do Gemini CLI.macOS { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
No Windows use esta entrada em vez disso.
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
No Antigravity CLI digite
/mcppara abrir o gerenciador MCP e atualizar. No app Antigravity abra Settings, depois Customizations, encontre Installed MCP Servers e escolha Refresh.Você deve ver:
skillrylistado com as suas ferramentas.
Conferir se a conexão funciona
- 1
Gemini CLI: liste os servidores configurados.
Terminal gemini mcp listVocê deve ver:
skillrycom o seu comando e um status conectado. - 2
Qualquer das ferramentas: digite
/mcpem uma sessão.Você deve ver:
skillrycom as suas ferramentas, começando porsearch_skills.
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 Gemini CLI ou Antigravity 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
| O que você vê | Causa provável | O que fazer |
|---|---|---|
gemini mcp list está vazio em outra pasta | O servidor foi adicionado com o escopo de projeto padrão | Adicione de novo com --scope user, ou mova a entrada para ~/.gemini/settings.json. |
gemini diz que a CLI foi substituída | O seu plano foi movido para o Antigravity CLI | Use a aba Antigravity. A entrada é o mesmo JSON em outro arquivo. |
| O Antigravity não reconhece o arquivo | O arquivo tem um erro de JSON, ou não foi atualizado | Valide o JSON, depois /mcp na CLI ou Refresh no app. |
| 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
Gemini CLI: remova o servidor das suas configurações de usuário.
Terminal gemini mcp remove -s user skillry - 2
Antigravity: apague a entrada
skillrydomcp_config.jsone atualize. Para manter sem carregar, defina"disabled": truena entrada.
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 |
|---|---|---|
| Configurações de usuário do Gemini CLI | ~/.gemini/settings.json | %USERPROFILE%\.gemini\settings.json |
| Configuração global do Antigravity | ~/.gemini/config/mcp_config.json | %USERPROFILE%\.gemini\config\mcp_config.json |
| Comando de inicialização | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| Conferir | gemini mcp list ou /mcp | igual |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}As opções --scope, --timeout e --trust do Gemini CLI estão na documentação MCP do Gemini CLI; o formato de arquivo do Antigravity e as configurações MCP do app estão na documentação MCP do Antigravity.
Perguntas frequentes
O Gemini CLI vai acabar?
O Google moveu usuários do plano gratuito e do Google One para o Antigravity CLI em 18 de junho de 2026; planos pagos mantêm o Gemini CLI. A entrada da Skillry é o mesmo JSON nas duas ferramentas.
Por que --scope user?
O escopo padrão do Gemini CLI é o projeto atual. O escopo de usuário coloca a entrada em ~/.gemini/settings.json, então ela funciona em todas as pastas.
O app Antigravity e a CLI compartilham a entrada?
Sim. O app, a CLI e o IDE leem todos ~/.gemini/config/mcp_config.json.
Fontes
Este guia ajudou?
