Do SDK de Aplicações aos Plugins do ChatGPT
Nesta página
Curso reescrito a 3 de novembro de 2026 com base na documentação de Plugins da OpenAI. A versão anterior baseava-se num pacote
@openai/apps-sdkinexistente (que incluíadefineAction,defineWidgete um manifestochatgpt-app.json). Agora, constrói aplicações para o ChatGPT utilizando o protocolo MCP, os seus SDK oficiais e a norma de interface MCP Apps. Reescrevemos todas as catorze lições e removemos as listas de compatibilidade de modelos não suportadas, as estruturas de comissões e os passos de publicação da versão antiga. Fontes: Início Rápido · Arquitetura de Plugins.
O que é um plugin?
Um plugin é o pacote que descobre, instala, partilha e publica no ChatGPT e no Codex. Este estende as capacidades do assistente, fornecendo novos conhecimentos, ferramentas ou ambos. A documentação da OpenAI identifica quatro blocos de construção:
- Competências (Skills), que fornecem ao modelo instruções e recursos para lidar com fluxos de trabalho recorrentes;
- Um servidor MCP, que expõe ferramentas e liga o assistente a sistemas externos — a sua API, base de dados ou serviço;
- Ambos, quando o modelo necessita tanto de um manual de procedimentos como de capacidades servidas pela sua infraestrutura;
- Ganchos de ciclo de vida (Lifecycle hooks), comandos executados em momentos específicos no ambiente de execução do Codex, incluindo no ChatGPT Work.
O ChatGPT e o Codex partilham um único diretório de plugins: um plugin público é publicado uma vez e torna-se visível em todas as superfícies compatíveis de ambos os produtos. Algumas capacidades permanecem específicas da superfície — por exemplo, um script de gancho deve existir no ambiente de execução, pelo que instalar o plugin na web não o implementa automaticamente lá.
E quanto ao “Apps SDK”?
Este termo refere-se ao conjunto de ferramentas da OpenAI para criar aplicações dentro do ChatGPT: o protocolo MCP e os seus SDK oficiais, a norma aberta MCP Apps que o ChatGPT implementa para renderizar interfaces, extensões específicas do ChatGPT, um sistema de design (@openai/apps-sdk-ui) e um repositório de exemplos. A documentação agrupa agora estes elementos sob “Plugins do ChatGPT e Apps SDK”: uma aplicação centra-se num servidor MCP, inclui uma interface opcional e distribui-se como parte de um plugin.
A escolha do MCP é deliberada. O Model Context Protocol é uma especificação aberta para ligar clientes de IA a ferramentas e dados. O servidor que escreve para o ChatGPT fala um protocolo que outros anfitriões compreendem, e uma interface compatível com o MCP Apps funciona em qualquer anfitrião que suporte essa norma.
Quatro formas possíveis
Comece pela forma mais pequena que cubra os seus casos de uso; pode adicionar um servidor ou uma interface mais tarde sem alterar o propósito central do plugin.
| Forma | Escolha isto quando |
|---|---|
| Apenas Competências | As instruções e ferramentas existentes são suficientes para lidar com o fluxo de trabalho |
| Apenas servidor MCP | O plugin necessita de ferramentas MCP, mas não de instruções adicionais de fluxo de trabalho |
| Competências e servidor MCP | As competências devem guiar o modelo através de fluxos de trabalho que utilizam as suas ferramentas |
| Servidor MCP com interface | A interação visual melhora significativamente parte do fluxo de trabalho |
Um plugin que redige atas de reuniões de acordo com as regras da sua empresa pode necessitar apenas de competências. Assim que tiver de ler dados em tempo real, autenticar um utilizador ou atuar num sistema que opera, requer um servidor MCP. Por fim, uma interface nunca é obrigatória: uma ferramenta deve permanecer útil sem ela.
Onde o plugin é executado
No ChatGPT, invoca um plugin instalado diretamente escrevendo @ no campo de entrada e selecionando-o. O modelo também o pode chamar automaticamente quando um pedido corresponde às suas ferramentas ou competências. O guia de início rápido da OpenAI recomenda testar o seu primeiro plugin no ChatGPT Work, o separador Work na página inicial web do ChatGPT. Os mesmos plugins aparecem no Codex, limitados pelas capacidades específicas de cada superfície.
O que vai construir
Este curso segue o caminho delineado na documentação. Começará por definir as suas ferramentas com base nas necessidades do utilizador, ligar um primeiro servidor MCP ao ChatGPT e, em seguida, construir o seu próprio: ferramentas bem documentadas, uma interface MCP Apps onde esta agrega valor, autenticação OAuth para dados privados e, se o seu modelo de negócio o permitir, um fluxo de compra utilizando a API Checkout. Terminará com o empacotamento, as regras de publicação e a submissão ao diretório.
Pontos-chave
- Um plugin combina competências, um servidor MCP ou ambos; a interface é opcional
- O ChatGPT e o Codex partilham um único diretório de plugins
- “Apps SDK” refere-se às ferramentas da OpenAI para criar aplicações: MCP, a norma MCP Apps, extensões do ChatGPT e o sistema de design
- Não existe nenhum pacote
@openai/apps-sdk: comece com os SDK MCP oficiais - Escolha a forma de plugin mais pequena que cubra os seus casos de uso