Entenda o que é um plugin
Sem plugin, a Paula fazia o papel de carteira: copiava o e-mail do cliente, colava no Codex, pegava a resposta, colava de volta no Gmail. O Codex não enxergava a caixa de entrada dela.
Um plugin é uma conexão pronta entre o Codex e um aplicativo. Gmail, Google Drive, GitHub, Canva, ClickUp, LinkedIn e muitos outros. Com o plugin ligado, ele lê e age no aplicativo direto, dentro das permissões que você deu.
🆕 Novo aqui? Quatro palavras deste módulo
- Plugin — conexão pronta com um aplicativo. Você instala e entra com a sua conta uma vez.
- Autorizar — a tela em que o aplicativo pergunta "deixar o Codex ver e mexer nisto?". Você escolhe o que liberar.
- MCP — um padrão aberto para ligar agentes a ferramentas externas. Muitos plugins usam MCP por baixo.
- Chave de API — uma senha especial que um programa usa para falar com um serviço. Nunca vai em arquivo de regras.
Como ler o desenho: o círculo roxo é o Codex trabalhando no seu projeto. Cada pequena peça roxa nas linhas é um plugin: a "tomada" que liga o agente a um aplicativo. Sem a peça, a linha não existe e você volta a copiar e colar.
✗ Sem plugin
- ✗ Você copia e cola entre o app e o Codex
- ✗ Ele só vê o pedaço que você colou
- ✗ Fácil esquecer um anexo ou um e-mail antigo
- ✗ Cada tarefa leva vários vaivéns
✓ Com plugin
- ✓ Ele busca direto no aplicativo
- ✓ Vê o contexto inteiro (conversa, anexos, datas)
- ✓ Prepara a resposta onde ela vai ser usada
- ✓ Um pedido em vez de dez cliques
Conecte seu primeiro aplicativo
No aplicativo do Codex existe uma área de Plugins. Você procura o aplicativo, clica para conectar e entra com a sua conta. O nome do botão pode mudar entre versões; procure por "Plugins" ou pelo ícone de peça.
Comece por um aplicativo que você usa todo dia e cujo conteúdo não é crítico. A Paula começou pelo Google Drive, só para leitura das pastas de modelos. O e-mail veio depois, quando ela já confiava no processo.
Abra a área de Plugins
No aplicativo do Codex, procure a seção de plugins na barra lateral ou no menu.
Escolha o aplicativo
Busque pelo nome (ex.: "Drive") e abra a página do plugin para ver o que ele faz.
Entre com a sua conta
Abre a tela de autorização do próprio aplicativo. Leia o que está sendo pedido antes de aceitar.
Teste com uma pergunta simples
"Liste as 5 pastas mais recentes do meu Drive." Se ele responder com nomes reais, a conexão funcionou.
Como ler o desenho: é um esboço, não uma cópia exata da tela. O que importa é o caminho: área de Plugins na lateral, busca pelo nome do aplicativo e o botão de conectar no cartão dele.
Objetivo: ver os plugins que você já tem e instalar um novo sem abrir o aplicativo. Troque <nome> pelo nome do plugin.
codex plugin list codex plugin add <nome>
codex plugin list de novo. O plugin novo tem de aparecer na lista. Depois, numa conversa, faça a pergunta simples do passo 4.Busque o plugin que você precisa
O catálogo de plugins cresce o tempo todo e está dividido em categorias: criatividade, ferramentas de desenvolvimento, negócios, dados e comunicação. Em vez de instalar tudo, parta da tarefa.
O Rui perguntou a si mesmo: "o que eu faço toda semana fora do Codex?". Resposta: arte da promoção e lista de tarefas da equipe. Foi atrás de um plugin de design e de um de tarefas. Nada além disso.
Como ler o desenho: as cinco gavetas são as categorias do catálogo. As duas acesas em roxo são as que o Rui abriu, porque batiam com tarefas reais dele. As outras continuam lá para quando houver necessidade.
| Tarefa que se repete | Categoria | Exemplo de plugin |
|---|---|---|
| Responder e-mails de clientes | Comunicação | Gmail |
| Buscar modelos e contratos | Dados | Google Drive |
| Arte da promoção da semana | Criatividade | Canva |
| Lista de tarefas da equipe | Negócios | ClickUp |
| Publicar no perfil profissional | Comunicação |
O que olhar na tabela: a primeira coluna é a que importa. Escreva as suas três tarefas mais repetidas e só depois procure no catálogo.
💡 Peça a sugestão ao Codex
Diga "estas são as tarefas que eu faço toda semana fora do Codex: <lista>. Que tipo de plugin me ajudaria em cada uma?". Ele aponta a categoria, e você confere no catálogo o que está disponível.
Use o plugin numa conversa
Depois de conectado, você não precisa "chamar" o plugin. Basta pedir em português, citando o aplicativo quando quiser ser claro. O Codex percebe que precisa do Drive ou do Gmail e usa a conexão dentro do mesmo ciclo do agente (pensa, usa a ferramenta, responde).
A Paula pede: "veja no Gmail os e-mails de candidatos desta semana que ainda não respondi e prepare rascunhos com a minha skill de resposta". Plugin e skill trabalham juntos: um traz o material, o outro dá o padrão.
Como ler o desenho: leia de cima para baixo. As setas roxas são a conversa entre a Paula e o Codex; as azuis são o Codex usando o plugin do Gmail. Repare que a última seta entrega rascunhos, não e-mails enviados.
Objetivo: usar um aplicativo conectado para trazer o material e uma skill para dar o padrão, sem nada sair sem a sua revisão.
Use o plugin do <aplicativo> para encontrar <o que procurar, ex.: e-mails de candidatos desta semana sem resposta>. Para cada item, prepare um rascunho usando a skill <nome-da-skill>. Não envie nem publique nada: me mostre a lista de rascunhos e espere a minha aprovação.
💡 Rascunho primeiro, sempre
Enviar e-mail e publicar post são ações que não voltam atrás. Até você confiar no processo, peça rascunho e aprove na mão. Combine isso com o modo de permissão "Pedir aprovação" do módulo 3.3.
Saiba o que fazer quando não há plugin
O sistema de vendas da loja do Rui é de uma empresa pequena e não aparece no catálogo. Isso não fecha a porta. Existem três outros caminhos, do mais organizado ao mais improvisado.
Primeiro, uma conexão MCP, se o serviço oferecer. Segundo, uma chave de API guardada num arquivo .env, para o Codex escrever um pequeno programa que fala com o serviço. Terceiro, o navegador: o Codex usa o site como você usaria (módulo 4.1).
Como ler o desenho: desça a escada só quando a resposta for "não". Quanto mais acima você parar, mais estável e seguro é o caminho. O navegador fica por último porque depende de o site não mudar de layout.
Objetivo: ver as conexões MCP que você já tem e adicionar uma nova. O serviço informa o <comando> na documentação dele; <nome> é um apelido que você escolhe.
codex mcp list codex mcp add <nome> -- <comando>
codex mcp list e veja o apelido novo na lista. Numa conversa, pergunte "que ferramentas da conexão <nome> você consegue usar?".✓ Chave de API do jeito certo
- ✓ Num arquivo
.env(arquivo de variáveis secretas) - ✓ O
.envfora de qualquer envio ou compartilhamento - ✓ Uma chave por serviço, com o mínimo de permissão
- ✓ Peça ao Codex: "leia a chave do .env, nunca a escreva na conversa"
✗ Chave de API do jeito errado
- ✗ Colada no AGENTS.md ou numa skill
- ✗ Colada no meio da conversa
- ✗ Num arquivo de texto qualquer da pasta
- ✗ A mesma chave "mestra" para tudo
Cuide da segurança das conexões
Cada plugin é uma porta aberta entre o Codex e uma conta sua. Portas abertas são úteis, mas precisam de chave e de alguém que confira de tempos em tempos. A regra de ouro é conceder só o que a tarefa precisa.
A Paula fez uma revisão no fim do trimestre: tinha um plugin de design que nunca usou e um de agenda com permissão para apagar eventos, sem necessidade. Desconectou o primeiro e refez a autorização do segundo só para leitura.
Como ler o desenho: os quatro cadeados azuis são os hábitos que mantêm o escudo de pé. O quadro vermelho fora do escudo é o risco mais comum: um plugin ligado meses atrás, com permissão ampla, que ninguém lembra mais.
✓ Faça
- ✓ Leia a tela de autorização antes de aceitar
- ✓ Prefira "só leitura" quando bastar
- ✓ Revise a lista de plugins a cada trimestre
- ✓ Desconecte com
codex plugin remove <nome>o que não usa
✗ Evite
- ✗ Aceitar "acesso total" por pressa
- ✗ Plugin com poder de enviar ou apagar sem você revisar
- ✗ Conectar a conta de um cliente sem a permissão dele
- ✗ Juntar plugins amplos com o modo "Acesso total"
Objetivo: listar tudo o que está conectado e remover o que não tem mais uso.
codex plugin list codex mcp list codex plugin remove <nome>
codex plugin list outra vez: o plugin removido não aparece mais. Para os que ficaram, abra as configurações de segurança do próprio aplicativo (Google, por exemplo) e confira o que cada um pode fazer.Teste rápido (opcional): o sistema da loja do Rui não tem plugin, mas oferece uma chave de API. Onde a chave deve ficar?
🎓 Resumo do módulo
codex plugin add.Próxima trilha:
Trilha 4 — Ferramentas e escala: navegador, sites, subagentes, tarefas agendadas e modo de voz