Codex Plugins

O que é Codex Plugins?

Codex Plugins são pacotes que expandem o que o Codex pode fazer, combinando “skills” reutilizáveis, integrações de apps e servidores MCP em fluxos disponíveis no Codex. O objetivo é permitir que o Codex acesse ferramentas e fluxos estruturados para tarefas como ler e gerenciar e-mails, trabalhar com documentos e arquivos, ou redigir e resumir mensagens em ferramentas de equipe.

Por exemplo, você pode instalar um plugin do Gmail para que o Codex leia e gerencie o Gmail, um plugin do Google Drive para trabalhar em Drive, Docs, Sheets e Slides, ou um plugin do Slack para resumir canais ou redigir respostas. Plugins também podem incluir servidores MCP para dar ao Codex acesso a ferramentas adicionais ou informações compartilhadas — muitas vezes de sistemas fora do projeto local.

Principais Recursos

• Plugins agrupam fluxos reutilizáveis: Um plugin pode empacotar múltiplas capacidades (skills, apps e/ou servidores MCP) para que o Codex as use como parte de uma tarefa.
• Skills para instruções específicas de tarefas: Skills são instruções reutilizáveis para tipos específicos de trabalho; o Codex carrega os passos e referências certos (incluindo scripts auxiliares) quando necessário.
• Apps para ler e agir em ferramentas externas: Conexões de apps (ex.: GitHub, Slack, Google Drive) permitem que o Codex leia informações de ferramentas e execute ações nelas.
• Servidores MCP para acesso a ferramentas adicionais: Servidores MCP fornecem acesso a ferramentas extras ou informações compartilhadas, incluindo de sistemas fora do projeto local.
• Fluxo de instalação curado no app e CLI: Você pode navegar e instalar plugins curados no app do Codex, ou abrir a lista de plugins pelo Codex CLI (via codex /plugins).
• Controles de permissões e compartilhamento de dados permanecem ativos: Instalar um plugin torna os fluxos disponíveis, mas as configurações de aprovação existentes ainda se aplicam; serviços externos conectados seguem suas próprias políticas de autenticação, privacidade e compartilhamento de dados.

Como Usar Codex Plugins

1. Abra o navegador de plugins: No app do Codex, abra Plugins e navegue pelo diretório curado. No Codex CLI, execute codex /plugins para abrir a lista de plugins.
2. Instale um plugin: Selecione o botão de instalar (app) ou “Install plugin” (CLI). Se o plugin precisar de um app externo, conecte-o quando solicitado. Alguns plugins exigem autenticação na instalação; outros adiam até o primeiro uso.
3. Inicie uma nova thread e peça ao Codex: Após a instalação, inicie uma nova thread e solicite a tarefa (por exemplo, resumir threads não lidas do Gmail de hoje ou buscar notas de lançamento no Google Drive).
4. Escolha entre seleção automática e invocação explícita:
   • Peça o resultado diretamente e deixe o Codex usar as ferramentas instaladas certas.
   • Especifique um plugin ou skill agrupado usando @ para invocar o plugin/skill explicitamente.

Casos de Uso

• Triagem e resumo de e-mails: Instale o plugin do Gmail e peça ao Codex para resumir threads não lidas do Gmail de um período específico.
• Recuperação de conteúdo em suítes de produtividade: Instale o plugin do Google Drive e solicite as notas de lançamento mais recentes, com o Codex trabalhando em Drive, Docs, Sheets e Slides.
• Suporte à comunicação em equipe: Instale o plugin do Slack para resumir um canal ou redigir respostas com base no contexto do canal.
• Automação de fluxos com ferramentas integradas: Use plugins que agrupam apps e skills para que o Codex siga os passos e referências apropriados para uma tarefa enquanto interage com sistemas externos.
• Acesso a sistemas externos via MCP: Para fluxos que exigem ferramentas ou informações compartilhadas fora do projeto local, use plugins que incluem servidores MCP.

FAQ

• O que acontece quando eu instalo um plugin? Instalar um plugin torna seus fluxos disponíveis no Codex, mas suas configurações de aprovação existentes ainda se aplicam.

• As integrações de plugins alteram minhas aprovações ou controles de privacidade existentes? Não—as configurações de aprovação que você já tem continuam a se aplicar. Para dados acessados ou ações realizadas por meio de serviços conectados, as políticas de autenticação, privacidade e compartilhamento de dados desses serviços externos se aplicam.

• Quando eu autentico com apps externos? Alguns plugins solicitam autenticação durante a instalação, enquanto outros esperam até a primeira utilização. O Codex pode solicitar durante a configuração ou primeira utilização quando o plugin inclui apps.

• Como desativo ou removo um plugin? Para removê-lo, desinstale pelo navegador de plugins no app Codex. A desinstalação remove o pacote do plugin do Codex, mas os apps incluídos podem permanecer instalados até você gerenciá-los no ChatGPT. Para desativar um plugin sem desinstalá-lo, defina enabled = false na entrada do plugin em ~/.codex/config.toml e reinicie o Codex.

• Posso criar meu próprio plugin? Sim. A documentação aponta para uma página “Build plugins” que cobre scaffolding local, configuração manual do marketplace, manifests de plugins e orientações de empacotamento.

Alternativas

• Codex sem plugins: Use as capacidades nativas do Codex para tarefas que não exigem acesso direto a sistemas externos como Gmail, Drive ou Slack.
• Automação de propósito geral via apps/APIs externos: Se precisar de ações em múltiplos passos entre ferramentas, uma alternativa é criar ou usar fluxos de automação que chamem as APIs relevantes diretamente, em vez de usar plugins Codex.
• Outras integrações de assistentes usando conectores de ferramentas: Em vez de plugins Codex, você pode usar plataformas de assistentes que suportam integrações de ferramentas (ex.: conectores e “actions”) para trazer dados e ações externas em fluxos de chat.
• Acesso a ferramentas baseado em MCP sem wrapper de plugin Codex: Para usuários que querem especificamente acesso a servidores MCP, uma abordagem alternativa é integrar servidores MCP e ferramentas de forma que se adeque ao seu fluxo existente, em vez de instalar um pacote de plugin Codex.