For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Plugins

Explore, instale e use plugins nas interfaces compatíveis do ChatGPT e do Codex

Visão geral

Os plugins reúnem recursos em fluxos de trabalho reutilizáveis no ChatGPT e no Codex. Eles podem incluir habilidades e servidores MCP. Os dois produtos compartilham um diretório universal de plugins. Assim, você pode encontrar os mesmos plugins públicos nas interfaces compatíveis de ambos.

Os plugins funcionam nos modos Chat e Work do ChatGPT na web, em computadores e em dispositivos móveis. Também funcionam no Codex dentro do aplicativo ChatGPT para desktop. A CLI do Codex tem um navegador de plugins para ambientes do Codex. A extensão para IDE não oferece suporte a plugins.

Em dispositivos móveis, você pode usar os plugins disponíveis para sua conta no modo Chat ou no modo Work.

Para administradores de espaços de trabalho: consulte Conexões do espaço de trabalho para configurar contas de aplicativos gerenciadas pela empresa e controlar quem pode usá-las. O método de autenticação determina qual identidade externa e quais permissões cada solicitação usa.

Os plugins marcados como Somente para desktop exigem o aplicativo ChatGPT para desktop. Você pode encontrá-los na web, mas precisa abrir o aplicativo para desktop para instalá-los e usá-los. Eles não estão disponíveis em dispositivos móveis.

Para saber como instalar e usar plugins, consulte Plugins no ChatGPT e no Codex na Central de Ajuda.

Abra a aba Plug-ins para explorar e instalar plugins. Depois de instalá-los, você pode usá-los no modo Chat ou no modo Work do ChatGPT, ou no Codex. Os plugins instalados podem adicionar habilidades e ferramentas MCP a novas conversas.

Veja alguns exemplos de como ampliar os recursos do ChatGPT e do Codex:

  • Instale o plugin Codex Security para analisar código que você tem autorização para verificar e confirmar possíveis vulnerabilidades identificadas na análise.
  • Instale o plugin do Gmail para trabalhar com o Gmail.
  • Instale o plugin do Google Drive para trabalhar com o Drive, o Documentos Google, o Planilhas Google e o Apresentações Google.
  • Instale o plugin do Slack para resumir conversas em canais ou redigir respostas.

Um plugin pode conter um ou mais destes componentes:

  • Habilidades: instruções reutilizáveis para tipos específicos de trabalho. O ChatGPT e o Codex podem carregá-las quando necessário para seguir as etapas adequadas e usar as referências ou os scripts auxiliares apropriados para cada tarefa.
  • Servidores MCP: serviços que conectam o ChatGPT e o Codex a ferramentas e informações em sistemas como GitHub, Slack ou Google Drive. Eles definem ferramentas, exigem autenticação, retornam dados estruturados e executam ações em sistemas externos. Também podem incluir uma interface personalizada.
  • Extensões de navegador: recursos do navegador de que o plugin precisa para executar seu fluxo de trabalho.
  • Hooks: comandos executados em pontos configurados do ciclo de vida do ambiente de execução do Codex. O ChatGPT Work não oferece suporte a hooks de plugins quando a execução é orquestrada na nuvem. O modo Work sincronizado aceita apenas hooks MCP definidos por administradores e configurados em Segurança do agente. Consulte Compatibilidade da sincronização de conversas do modo Work. Os scripts dos hooks precisam estar disponíveis no ambiente de execução. Instalar um plugin pela web não implanta esses scripts. Administradores do Enterprise podem implantar os scripts necessários por meio do gerenciamento de dispositivos móveis (MDM). Antes que os hooks de um plugin sejam executados, revise-os e verifique se são confiáveis. Consulte Hooks para saber como configurá-los e conhecer as políticas para hooks gerenciados.

Para compartilhar plugins, publique-os em uma fonte de marketplace, como um marketplace mantido no repositório de um projeto ou de uma equipe. Consulte Criar plugins para saber como configurar o marketplace, empacotar os plugins e distribuí-los.

Se você está criando uma integração, comece por Criar um servidor MCP. Se o plugin precisar de uma interface personalizada, consulte o guia de interface opcional.

Usar e instalar plugins

Diretório universal de plugins

O ChatGPT e o Codex usam o mesmo catálogo público de plugins. Na web ou no aplicativo ChatGPT para desktop, abra a aba Plug-ins para explorar e instalar plugins.

O diretório de plugins organiza os plugins em abas:

  • OpenAI: plugins desenvolvidos pela OpenAI.
  • Nome do seu espaço de trabalho: plugins disponibilizados pelo seu espaço de trabalho.
  • Pessoal: plugins do seu marketplace pessoal. As seções Criados por mim e Compartilhados comigo aparecem quando há plugins disponíveis nessas categorias.

Na linha Instalados, exibida separadamente, você pode conferir os plugins que já instalou.

Administradores de espaços de trabalho podem importar e sincronizar um marketplace do GitHub para a equipe. Consulte Importar e sincronizar plugins do GitHub para conhecer os requisitos de configuração e acesso.

Instalar e usar um plugin

Depois de abrir o diretório de plugins:

  1. Pesquise um plugin ou navegue pelo catálogo até encontrá-lo. Em seguida, abra os detalhes do plugin.
  2. Selecione o botão com o sinal de mais para instalar o plugin.
  3. Se o plugin precisar de uma conexão com um servidor MCP, faça a conexão quando solicitado. Alguns plugins pedem que você se autentique durante a instalação. Outros só pedem autenticação no primeiro uso.
  4. Após a instalação, inicie uma nova conversa e peça ao ChatGPT ou ao Codex que use o plugin.

Conectar serviços de parceiros compatíveis com a opção Entrar com o ChatGPT

A opção Entrar com o ChatGPT está sendo disponibilizada gradualmente em versão beta para plugins compatíveis e sites parceiros, incluindo Airtable, GitLab, HubSpot, Notion, Supabase e Vercel. Quando a opção estiver disponível, selecione Entrar com o ChatGPT ao conectar o plugin para criar ou vincular sua conta nesse serviço.

Ao entrar, você compartilha com o parceiro apenas seu nome, endereço de e-mail e foto de perfil, quando disponível. Isso não dá ao plugin acesso aos seus dados nem aprova ações automaticamente. Antes de usar a conexão, revise e aprove as permissões solicitadas pelo plugin em uma etapa separada.

Depois de instalar um plugin, você pode usá-lo diretamente no campo de mensagem:

Descreva a tarefa diretamente

Peça o resultado que você quer, por exemplo: “Resuma as conversas não lidas de hoje no Gmail” ou “Busque as notas de lançamento mais recentes no Google Drive.”

Use essa abordagem quando quiser que o ChatGPT escolha, entre as ferramentas instaladas, as mais adequadas para a tarefa.

Escolha um plugin específico

Digite @ para chamar explicitamente o plugin ou uma das habilidades incluídas nele.

Use essa abordagem quando quiser indicar qual plugin ou habilidade o ChatGPT deve usar. Consulte Habilidades e plug-ins.

Plugins em Sites

Use plugins em Sites para criar um Site que use as contas conectadas e as permissões de cada visitante. Consulte Usar dados dos usuários no seu Site com plugins para conhecer os requisitos de configuração e de acesso dos visitantes.

Usar o Mensagens da Apple no Codex

O plugin do Mensagens da Apple está disponível em todos os planos no aplicativo ChatGPT para desktop no macOS. No Codex e no ChatGPT Work, o plugin pode ler e pesquisar conversas de iMessage, SMS e RCS no seu Mac e enviar mensagens em seu nome pelo aplicativo Mensagens. Ele não permite interagir remotamente com o ChatGPT pelo Mensagens e não funciona nas conversas comuns do ChatGPT.

Nesta versão, o plugin do Mensagens está incluído apenas na versão do aplicativo ChatGPT para desktop destinada a Macs com Apple Silicon (arm64).

  1. Abra Plug-ins, encontre o plugin do Mensagens da Apple e instale-o.
  2. Inicie uma nova conversa no Codex ou no ChatGPT Work e peça para encontrar, resumir, redigir ou enviar uma mensagem.
  3. Conceda as permissões solicitadas pelo macOS antes que o ChatGPT leia as conversas no Mensagens.
  4. Confira a mensagem e os destinatários antes de autorizar o envio.

Por padrão, o ChatGPT só envia mensagens depois que você aprova a mensagem e os destinatários. Selecione Permitir uma vez para aprovar apenas aquele envio. Se você selecionar Sempre permitir o envio para esta conversa, o ChatGPT poderá enviar outras mensagens para essa conversa no Mensagens sem pedir nova aprovação.

Mantenha a aprovação a cada envio nas conversas que possam conter instruções enganosas ou de fontes não confiáveis. Com a aprovação permanente, você perde a última oportunidade de revisar uma mensagem antes que o ChatGPT a envie em seu nome. Use essa opção apenas se aceitar esse risco.

Para voltar a aprovar cada envio, abra Configurações > Uso do computador e selecione Gerenciar ao lado de Mensagens. Em Envio sempre permitido, selecione o ícone da lixeira ao lado da conversa e confirme em Remover. O ChatGPT voltará a pedir aprovação antes de enviar mensagens para essa conversa.

Problema conhecido: se a tarefa estiver configurada com Acesso completo ou se as solicitações de aprovação estiverem desativadas de outra forma, o Mensagens da Apple talvez não consiga exibir a confirmação necessária para o envio. Mude para Pedir aprovação ou Aprovar por mim e tente novamente.

O Mensagens da Apple é executado no seu Mac. Ele não está disponível diretamente no ChatGPT na web ou em dispositivos móveis, na CLI do Codex nem na extensão para IDE.

Em espaços de trabalho gerenciados, os administradores podem desativar o Mensagens da Apple usando o controle existente de Uso do computador.

Disponibilidade com chave de API

Se você entrar no Codex com uma chave de API da OpenAI, poderá explorar, instalar e gerenciar os plugins compatíveis selecionados pela OpenAI tanto na CLI do Codex quanto no Codex dentro do aplicativo ChatGPT para desktop. Alguns plugins não estão disponíveis com autenticação por chave de API porque seus fluxos de conexão exigem recursos de OAuth que esse método não oferece. Consulte o uso dos plugins na página de uso da plataforma.

Como funcionam as permissões e o compartilhamento de dados

Quando um recurso de um plugin é executado em um host do Codex, aplica-se a política de sandbox e aprovação desse host. As conexões com serviços externos usam os mecanismos de autenticação e os controles de acesso do próprio serviço.

  • As habilidades incluídas no plugin ficam disponíveis quando você inicia uma nova conversa ou sessão da CLI após a instalação.
  • Se o plugin incluir servidores MCP, talvez seja necessário fazer configurações adicionais ou se autenticar antes de usá-los.
  • Quando o ChatGPT envia dados por meio de um servidor MCP, aplicam-se os termos e a política de privacidade desse serviço.

Remover um plugin

Para remover um plugin, abra-o em um navegador de plugins compatível e selecione Desinstalar plugin quando a opção estiver disponível. Essa opção pode não aparecer para plugins padrão ou instalados pelo espaço de trabalho. Nesses casos, o administrador do espaço de trabalho gerencia os plugins.

Ao desinstalar um plugin, você remove o pacote desse ambiente do ChatGPT ou do Codex. As integrações com servidores MCP que você conectou separadamente no ChatGPT continuam ativas até que você as desconecte no próprio ChatGPT.

Criar seu próprio plugin

Para criar ou editar um plugin em uma conversa no ChatGPT, comece por Criar plugins. O guia mostra como descrever um fluxo de trabalho, adicionar arquivos de referência, testar o fluxo e fazer alterações quando o Criador de plugins estiver disponível no seu espaço de trabalho.

Para criar, testar ou distribuir seu próprio plugin, consulte nosso guia de desenvolvimento de plugins. O guia explica como gerar a estrutura inicial do plugin localmente, configurar o marketplace manualmente, compartilhar plugins no espaço de trabalho, usar manifestos e empacotar plugins.

Se o plugin incluir recursos que dependem de um servidor, consulte Criar um servidor MCP. As ferramentas MCP podem funcionar sem uma interface personalizada ou retornar uma interface quando uma apresentação visual facilitar o fluxo de trabalho.

Quando o plugin estiver pronto para revisão, consulte Enviar plugins para revisão para conhecer o processo de envio à plataforma da OpenAI, as permissões necessárias, os materiais para revisão, as verificações de MCP e os requisitos para os casos de teste.

Guias de plugins

  • Gravar e reproduzir: mostre um fluxo de trabalho ao ChatGPT uma vez e transforme-o em uma habilidade reutilizável.
  • Plugin Codex Security: analise código que você tem autorização para verificar, confirme os resultados e prepare correções revisadas.