Conecte a Skillry MCP no Codex (CLI, app ChatGPT e extensão do IDE)

A resposta curta

1Execute codex mcp add skillry -- npx --yes skillry-cli@latest mcp uma vez; no Windows, envolva a inicialização em cmd /c.
2Confirme com codex mcp list, ou digite /mcp na interface do Codex.
3O app ChatGPT para desktop e a extensão do IDE compartilham a entrada: configure uma vez, use nos três.

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

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.

Codex logado: a CLI, o app ChatGPT para desktop com Codex, ou a extensão do IDE. Eles compartilham uma configuração.
Node.js 22 ou mais recente (node --version). O Codex inicia o servidor com npx.
Um .codex/config.toml no nível do projeto também funciona, mas só em projetos que você marcou como confiáveis. Este guia usa o arquivo global.

Adicionar a Skillry ao Codex

O mais rápido quando você usa a Codex CLI

1
Execute isto em qualquer terminal:
macOS
```
codex mcp add skillry -- npx --yes skillry-cli@latest mcp
```
Você deve ver: Nenhum erro, e codex mcp list agora inclui skillry.
2
No Windows, execute isto em vez disso para que o Windows consiga iniciar o npx:
Windows (PowerShell ou Prompt de Comando)
```
codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Inicie o Codex de novo, ou reinicie o app ou a extensão se algum estiver aberto.
Você deve ver: skillry na lista do /mcp dentro do Codex.

Sem terminal

1
No app ChatGPT para desktop abra Settings e depois MCP servers. Na extensão do IDE abra o menu da engrenagem e depois MCP servers.
2
Escolha Add server. Digite o nome skillry, escolha STDIO e digite o comando npx --yes skillry-cli@latest mcp (no Windows cmd /c npx --yes skillry-cli@latest mcp).
3
Salve e escolha Restart no app ou Restart extension no IDE.
Você deve ver: skillry listado como habilitado na lista de servidores MCP.

Quando você mantém as configurações do Codex no arquivo

1
Abra ~/.codex/config.toml em um editor; crie-o se não existir.
2
Acrescente esta tabela. Se já existir uma tabela [mcp_servers.skillry], substitua-a.
macOS
```
[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]
```

No Windows use esta tabela em vez disso.

Windows

[mcp_servers.skillry]
command = "cmd"
args = ["/c","npx","--yes","skillry-cli@latest","mcp"]

4
Se a primeira inicialização estourar o tempo, adicione startup_timeout_sec = 60 abaixo da tabela. O padrão é 10 segundos, e a primeira execução do npx baixa o pacote.
5
Salve e inicie o Codex de novo.
Você deve ver: skillry em codex mcp list e em /mcp.

Conferir se o Codex está conectado

1
Em um terminal, liste os servidores configurados:
Terminal
```
codex mcp list
```
Você deve ver: skillry com o comando npx que você digitou.
2
Na interface do Codex, digite /mcp.
Você deve ver: skillry entre os servidores ativos, com as suas ferramentas.

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 Codex 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 Codex 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 Codex não vê a Skillry

O que você vê	Causa provável	O que fazer
`skillry` está faltando em `codex mcp list`	A tabela foi para um arquivo de projeto em um projeto não confiável, ou o nome da tabela tem um erro de digitação	Coloque a tabela em `~/.codex/config.toml` e confira se ela diz exatamente `[mcp_servers.skillry]`.
O servidor nunca fica pronto, ou o Codex relata um tempo de inicialização esgotado	O primeiro download do `npx` levou mais do que `startup_timeout_sec` (10 segundos por padrão)	Adicione `startup_timeout_sec = 60` à tabela, ou rode o comando de inicialização uma vez à mão para deixar o pacote em cache.
Funciona na CLI, mas não no app ChatGPT	O app estava aberto enquanto o arquivo mudava	Feche e reabra o app ChatGPT para desktop, ou escolha Restart extension no IDE.
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
Apague a tabela [mcp_servers.skillry] de ~/.codex/config.toml, ou use o comando de remoção que codex mcp --help lista para a sua versão. Para desligar sem apagar, adicione enabled = false à tabela.
2
Reinicie o Codex, o app ou a extensão.
Você deve ver: skillry some de codex mcp list.

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 global	`~/.codex/config.toml`	`%USERPROFILE%\.codex\config.toml`
Arquivo de configuração do projeto	`.codex/config.toml` (só projetos confiáveis)	igual
Comando de inicialização	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Conferir	`codex mcp list` ou `/mcp`	igual

A tabela que o Codex guarda (macOS)

[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]

Tempos limite, listas de ferramentas permitidas e modos de aprovação estão na documentação oficial de MCP do Codex.

Perguntas frequentes

Configuro separadamente para o app ChatGPT para desktop?

Não. O app, a CLI e a extensão do IDE leem o mesmo config.toml. Reinicie o app depois de alterá-lo.

Posso usar em um projeto só?

Sim. Em um projeto confiável, coloque a tabela em .codex/config.toml dentro desse projeto em vez do arquivo global.

Por que a primeira inicialização é lenta?

A primeira execução do npx baixa o skillry-cli. Aumente startup_timeout_sec ou rode o comando de inicialização uma vez à mão; depois disso ele inicia na hora.

Fontes

Este guia ajudou?

AnteriorClaude Code PróximoCursor