Arquitetura: Ferramentas, Recursos e Interface
Nesta página
Lição reescrita a 3 de novembro de 2026 com base nas páginas MCP server, Plugin architecture e Skills da documentação de Plugins da OpenAI. A antiga arquitetura de “ações, widgets e comércio” descrevia um SDK que já não existe. Fontes: MCP server · Plugin architecture · Skills.
Visão Geral
Um plugin consiste em camadas independentes. As Skills fornecem o guião, o servidor MCP fornece as capacidades e a interface oferece uma forma visual de interagir, quando necessário.
Plugin
├── Skills
└── Servidor MCP (opcional)
├── Ferramentas e resultados estruturados
└── Recursos de interface (opcional)
Cada camada tem um papel distinto. A documentação resume esta fronteira da seguinte forma: o servidor MCP fornece dados, autenticação, autorização e ações; a skill fornece instruções reutilizáveis, exemplos e modelos de documentos.
O que um Servidor MCP Expõe
Um servidor MCP pode expor quatro tipos de entidades:
- Ferramentas: Funções que o modelo chama com entradas estruturadas.
- Recursos: Dados ou conteúdo que o cliente pode ler.
- Prompts: Modelos de prompts reutilizáveis.
- Instruções: Diretivas que se aplicam a todo o servidor.
Os plugins dependem principalmente de ferramentas. Cada ferramenta tem um nome, uma descrição, um esquema de entrada e, opcionalmente, um esquema de saída. Estes campos permitem ao modelo decidir quando chamar a ferramenta e como utilizar o seu resultado.
O Fluxo do Pedido
Quando um utilizador faz um pedido que corresponde a uma ferramenta, ocorrem quatro passos sequenciais:
- O cliente descobre as ferramentas expostas pelo servidor MCP.
- O modelo seleciona uma ferramenta e fornece argumentos que respeitam o seu esquema de entrada.
- O servidor valida o pedido, executa a operação e devolve um resultado.
- O modelo utiliza esse resultado para continuar a conversa.
Um resultado de ferramenta pode conter três partes. O structuredContent transporta dados concisos que o modelo pode inspecionar e reutilizar em chamadas subsequentes. O content transporta texto ou outro conteúdo MCP que ajuda o modelo a formular uma resposta. O _meta transporta dados destinados ao cliente e ocultos do modelo — ocultos, mas não protegidos. Este campo não substitui a autorização nem o armazenamento seguro.
Transporte e Autorização
Em produção, implemente um servidor MCP num endereço HTTPS estável utilizando o transporte streamable HTTP do protocolo, tipicamente num caminho /mcp. Se as ferramentas lerem dados privados ou atuarem em nome de um utilizador, proteja o servidor com o fluxo de autorização definido pela especificação MCP — OAuth, que a Lição 8 detalha.
A Interface: Uma Camada Opcional
Uma ferramenta deve funcionar sem interface: texto conciso e um resultado estruturado são frequentemente suficientes para o modelo responder. Uma interface faz sentido quando o utilizador precisa de inspecionar, comparar, modificar, confirmar ou navegar em informações estruturadas — uma comparação de produtos, um horário editável ou um mapa. Uma simples verificação de estado geralmente não necessita de uma.
Quando presente, a interface é um recurso que o servidor declara. O ChatGPT exibe-a num iframe quando a ferramenta associada a devolve. O ChatGPT implementa o padrão aberto MCP Apps: a interface comunica com o anfitrião via JSON-RPC utilizando postMessage. Extensões específicas do ChatGPT, acessíveis via window.openai, complementam o padrão quando este não cobre uma necessidade específica. A Lição 6 aborda este tema.
Skills: A Camada de Fluxo de Trabalho
Uma skill é uma pasta que contém um ficheiro SKILL.md — um nome, uma descrição que indica ao modelo quando a deve considerar, instruções — e, se necessário, referências, scripts ou modelos. O modelo vê inicialmente apenas o nome e a descrição; carrega as instruções completas quando o pedido corresponde à skill ou quando o utilizador a invoca diretamente. Daí o conselho da OpenAI: escreva a descrição em torno do objetivo do utilizador e das condições de acionamento, e mantenha os detalhes passo a passo no corpo do ficheiro.
E o Comércio?
Vender através de um plugin não é uma camada separada. É uma jornada que a interface opcional pode suportar, alavancando a API de Checkout documentada pela OpenAI. A Lição 7 explica como funciona e quais as suas limitações.
Pontos-chave
- Um servidor MCP expõe ferramentas, recursos, prompts e instruções; os plugins dependem principalmente de ferramentas
- Um resultado de ferramenta combina
structuredContent,contente_meta(oculto do modelo, mas não seguro) - Produção: HTTPS estável, transporte streamable HTTP, autorização conforme a especificação MCP
- A interface é um recurso opcional exibido pelo ChatGPT segundo o padrão MCP Apps
- As Skills gerem o fluxo de trabalho; o servidor gere dados, autorização e ações