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

Plug-ins

Explore, instale e use plug-ins nas interfaces compatíveis do ChatGPT e do Codex

Visão geral

Os plug-ins reúnem capacidades em fluxos de trabalho reutilizáveis no ChatGPT e no Codex. Eles podem incluir habilidades, servidores MCP e ganchos de ciclo de vida. Ambos os produtos usam um diretório universal de plug-ins, permitindo encontrar os mesmos plug-ins públicos nas interfaces compatíveis.

Os plug-ins funcionam no Chat e no Work no ChatGPT na Web, no desktop e em dispositivos móveis, e no Codex no aplicativo do ChatGPT para desktop. O Codex CLI também tem um navegador de plug-ins para ambientes do Codex. A extensão para IDE não oferece suporte a plug-ins.

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

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

Abra a aba Plug-ins para explorar e instalar plug-ins. Após a instalação, você pode usar plug-ins no Chat ou no Work no ChatGPT, ou no Codex. Os plug-ins instalados podem adicionar habilidades e ferramentas MCP a novos chats.

Amplie o que o ChatGPT e o Codex podem fazer, por exemplo:

  • Instale o plugin Codex Security para analisar código que você tem autorização para examinar e confirmar possíveis vulnerabilidades identificadas.
  • Instale o plug-in do Gmail para trabalhar com o Gmail.
  • Instale o plug-in do Google Drive para trabalhar com o Drive, Docs, Sheets e Slides.
  • Instale o plug-in do Slack para resumir canais ou redigir rascunhos de respostas.

Um plug-in 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 corretas e usar as referências ou os scripts auxiliares adequados à 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. Opcionalmente, podem incluir uma interface personalizada.
  • Extensões do navegador: recursos do navegador de que um plug-in precisa para seu fluxo de trabalho.
  • Ganchos: comandos executados em pontos configurados do ciclo de vida no ambiente de execução do Codex, incluindo o ChatGPT Work e o Codex. Os scripts dos ganchos precisam estar disponíveis no ambiente de execução; instalar um plug-in na Web não implanta esses scripts. Administradores de empresas podem implantar os scripts necessários por meio do gerenciamento de dispositivos móveis (MDM). Revise os ganchos dos plug-ins e confirme que são confiáveis antes de executá-los. Consulte Ganchos para saber mais sobre a configuração e as políticas de ganchos gerenciados.

Você pode compartilhar plug-ins publicando-os por meio de uma fonte de marketplace, como um marketplace em repositório para um projeto ou uma equipe. Consulte Criar plugins para obter orientações sobre configuração de marketplace, empacotamento e distribuição.

Se você está desenvolvendo uma integração, comece por Criar um servidor MCP. Se o plug-in precisar de uma interface personalizada, use o guia de interface opcional.

Use e instale plug-ins

Diretório universal de plug-ins

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

O Diretório de plug-ins organiza os plug-ins em abas:

  • OpenAI: plug-ins criados pela OpenAI.
  • Nome do seu workspace: plug-ins fornecidos pelo seu workspace.
  • Pessoal: plug-ins de marketplaces pessoais, incluindo as seções Criados por mim e Compartilhados comigo quando esses plug-ins estiverem disponíveis.

Use a linha separada Instalados para conferir os plug-ins que você já instalou.

Administradores de workspaces podem importar e sincronizar um marketplace do GitHub para sua equipe. Consulte Gerenciamento de plug-ins para ver os requisitos de configuração e acesso.

Instale e use um plug-in

Depois de abrir o Diretório de plug-ins:

  1. Pesquise ou explore o catálogo para encontrar um plug-in e abra seus detalhes.
  2. Selecione o botão de adição para instalar o plug-in.
  3. Se o plug-in precisar de uma conexão com um servidor MCP, conecte-o quando solicitado. Alguns plug-ins pedem que você se autentique durante a instalação. Outros só solicitam a autenticação na primeira vez que você os usa.
  4. Após a instalação, inicie um novo chat e peça ao ChatGPT ou ao Codex para usar o plug-in.

Conecte serviços de parceiros compatíveis com Entrar com o ChatGPT

A opção Entrar com o ChatGPT está sendo disponibilizada em versão beta para plug-ins compatíveis e sites de parceiros, incluindo Airtable, GitLab, HubSpot, Notion, Supabase e Vercel. Quando a opção estiver disponível, selecione Entrar com o ChatGPT ao conectar o plug-in 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 concede ao plug-in acesso aos seus dados nem aprova ações automaticamente. Revise e aprove as permissões solicitadas pelo plug-in em uma etapa separada antes de usar a conexão.

Depois de instalar um plug-in, você pode usá-lo diretamente na janela de prompt:

Descreva a tarefa diretamente

Peça o resultado que deseja, como "Resuma as conversas não lidas do Gmail de hoje" ou "Busque as notas de lançamento mais recentes no Google Drive."

Use essa opção quando quiser que o ChatGPT escolha as ferramentas instaladas mais adequadas para a tarefa.

Escolha um plug-in específico

Digite @ para invocar explicitamente o plug-in ou uma das habilidades incluídas nele.

Use essa opção quando quiser especificar qual plug-in ou habilidade o ChatGPT deve usar. Consulte Habilidades e Plug-ins.

Use o Apple Messages pelo Codex

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

Nesta versão, o plug-in Messages está incluído apenas na compilação para Apple Silicon (arm64) do aplicativo do ChatGPT para desktop.

  1. Abra Plug-ins, encontre o plug-in Apple Messages e instale-o.
  2. Inicie um novo chat no Codex ou no ChatGPT Work e peça para encontrar, resumir, redigir um rascunho ou enviar uma mensagem.
  3. Conceda as permissões solicitadas do macOS antes que o ChatGPT leia o Messages.
  4. Revise a mensagem e seus destinatários antes de permitir o envio.

Por padrão, o ChatGPT só envia mensagens depois que você aprova a mensagem e seus destinatários. Escolha Permitir uma vez para aprovar apenas esse envio. Se você selecionar Sempre permitir o envio para esta conversa, o ChatGPT poderá enviar mensagens futuras para essa conversa do Messages sem uma nova aprovação de envio.

Mantenha a aprovação a cada envio para conversas que possam conter instruções não confiáveis ou enganosas. A aprovação persistente elimina sua última chance de revisar uma mensagem antes que o ChatGPT a envie em seu nome. Use-a somente se aceitar esse risco.

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

Problema conhecido: se sua tarefa estiver configurada como Acesso completo ou desativar de outra forma as solicitações de aprovação, o Apple Messages talvez não consiga exibir a confirmação necessária para enviar. Mude para Pedir aprovação ou Aprovar por mim e tente novamente.

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

Em workspaces gerenciados, os administradores podem desativar o Apple Messages pelo controle existente de Uso do computador.

Disponibilidade com chave de API

Se você entrar no Codex com uma chave de API da OpenAI, poderá procurar, instalar e gerenciar os plug-ins compatíveis selecionados pela OpenAI no Codex CLI e no Codex no aplicativo ChatGPT para desktop. Alguns plug-ins não estão disponíveis com autenticação por chave de API porque seus fluxos de conexão exigem recursos OAuth não compatíveis. Consulte o uso dos plug-ins na página de uso da plataforma.

Como funcionam as permissões e o compartilhamento de dados

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

  • As habilidades incluídas ficam disponíveis quando você inicia um novo chat ou uma nova sessão da CLI após a instalação.
  • Se um plug-in incluir servidores MCP, eles poderão exigir configuração adicional ou autenticação antes de você poder 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 plug-in

Para remover um plug-in, abra-o em um navegador de plug-ins compatível e selecione Desinstalar plug-in quando essa ação estiver disponível. Plug-ins instalados pelo workspace ou incluídos por padrão podem não oferecer essa ação; nesse caso, eles são gerenciados pelo administrador do seu workspace.

A desinstalação de um plug-in remove o pacote do plug-in daquele ambiente do ChatGPT ou do Codex. As integrações com servidores MCP conectadas separadamente permanecem conectadas no ChatGPT até que você as desconecte por lá.

Criar seu próprio plug-in

Se você quiser criar, testar ou distribuir seu próprio plug-in, consulte Criar plugins. Essa página aborda a criação local da estrutura inicial, a configuração manual do marketplace, o compartilhamento no workspace, os manifestos de plug-ins e as orientações de empacotamento.

Se o seu plug-in incluir recursos que dependem de servidores, consulte Criar um servidor MCP. As ferramentas MCP podem funcionar sem uma interface personalizada ou retornar uma interface quando um elemento visual ajudar no fluxo de trabalho.

Quando seu plug-in estiver pronto para revisão, consulte Enviar plug-ins para saber mais sobre o fluxo de envio na plataforma da OpenAI, as permissões necessárias, os materiais para revisão, as verificações de MCP e os requisitos dos casos de teste.

Guias de plug-ins

  • Gravar e reproduzir: Mostre um fluxo de trabalho ao ChatGPT uma única vez e transforme-o em uma habilidade reutilizável.
  • Plugin Codex Security: Analise código com autorização, confirme os problemas encontrados e prepare correções revisadas.