Como integrar seu aplicativo ao ChatGPT: MCP Apps mostrou uma galeria de colorir direto no chat
Para que o ChatGPT avalie os riscos de um lançamento na sexta-feira, ele precisa de acesso ao GitHub, ao tracker e ao calendário, e essa ponte é construída pelo MCP Server. Mas uma tabela com cerca de cinquenta tarefas é incômoda de ler no chat, e aí entra o MCP Apps, que exibe uma interface interativa diretamente no diálogo. O autor integrou ao ChatGPT uma galeria de colorir feita em React e Supabase. Para um resumo curto, o servidor basta; para filtros e ações, é preciso MCP Apps.
Processado por IA de Habr AI; editado por Hamidun News
Imagine que o gerente de projeto pergunta à IA: "Quais são os riscos para o lançamento na sexta-feira? Verifique as tarefas em aberto, os PRs sem revisão e os prazos mais próximos". Os dados estão no GitHub, no tracker interno de tarefas e no calendário corporativo, e sem a conexão a esses sistemas o modelo não consegue responder.
Para esse tipo de conexão existe o Model Context Protocol (MCP). Quando uma resposta em texto não basta e é preciso folhear imagens, filtrar tarefas ou baixar um arquivo, sobre o MCP funciona a extensão MCP Apps. O autor do artigo no Habr mostrou as duas partes em um projeto real.
Isso serve de referência para quem pretende integrar seu aplicativo a clientes de IA.
O que faz o MCP Server
O MCP não substitui as APIs existentes. Ele oferece uma interface padrão pela qual o cliente de IA encontra e chama ferramentas (tools) e recursos (resources). Por dentro, o servidor acessa suas APIs REST ou GraphQL, o banco de dados e outros serviços. A lógica de negócio e o controle de acesso continuam do lado da empresa.
No exemplo do lançamento, dá para criar um único servidor com uma ferramenta como get_release_readiness. Ela reúne as tarefas em aberto, verifica os PRs sem revisão, cruza os prazos e devolve um resumo. Outra opção é ter vários servidores independentes, um para cada sistema. A escolha depende de onde é mais conveniente manter a lógica de unificação dos dados e o tratamento de erros. A vantagem dessa abordagem é que um mesmo servidor funciona com diferentes clientes que suportam o protocolo. Só que as capacidades e as limitações desses clientes variam.
O que o MCP Apps acrescenta
Normalmente, o servidor devolve JSON, por exemplo "release 2.4.0, 3 tarefas bloqueantes, 5 PRs sem revisão, status at_risk", e o modelo reconta isso em texto. Para um resumo pequeno, isso basta. Mas dezenas de tarefas, filtros por equipe e comparação de releases são incômodos em texto, e perguntas de esclarecimento sem fim cansam. O MCP Apps associa a ferramenta a um recurso de UI. O cliente carrega a interface e mostra tabela, cartões, gráfico ou formulário diretamente na conversa.
Os papéis são separados. O servidor cuida das operações, dos dados, da autorização e das chamadas a sistemas externos. O aplicativo cuida da exibição e, com o suporte do host, chama ele mesmo as ferramentas do servidor. O aplicativo web completo permanece onde está, e para o chat é levada apenas a parte que o usuário precisa ao lado do modelo.
Exemplo: galeria de colorir no ChatGPT
O autor usou seu serviço de contos e colorir personalizados, feito em React, TypeScript e Supabase. Não migrou o aplicativo inteiro; manteve no chat três ações com as colorir prontas: visualizar, baixar e excluir. Ao pedido "Mostre minhas colorir mais recentes", o ChatGPT chama a ferramenta get_coloring_gallery, e a galeria se abre na conversa.
Como isso funciona:
- O MCP Server roda como uma Supabase Edge Function, usando o pacote @modelcontextprotocol/server e o mesmo PostgreSQL do aplicativo principal.
- A autorização passa pelo Supabase Auth via OAuth. O acesso é restrito a uma conta familiar, e a pertinência das imagens é verificada também no servidor.
- A ferramenta é vinculada à interface por meio de _meta.ui.resourceUri. A própria UI é registrada como um recurso separado com mimeType text/html;profile=mcp-app.
- React e CSS são compilados com esbuild e embutidos no HTML, por isso não é preciso um arquivo JavaScript externo. A UI roda em um ambiente isolado e não tem acesso arbitrário à página do ChatGPT.
- No cliente é usado o pacote @modelcontextprotocol/ext-apps: o objeto App se conecta ao host, recebe o resultado da ferramenta e reage à troca entre tema claro e escuro.
A transferência de dados é econômica. A ferramenta da galeria devolve apenas os identificadores das colorir, e as miniaturas são carregadas pelo próprio React por meio da ferramenta auxiliar get_coloring_gallery_thumbnail, marcada com visibility: ['app']. As imagens pesadas não passam pelo modelo, que recebe só a lista de identificadores.
O download funciona pela ferramenta get_coloring_image e pelo método app.downloadFile(). O aplicativo recebe o PNG do servidor e entrega o arquivo ao host, sem link para o armazenamento privado. A exclusão é mais rigorosa, pois altera dados. Primeiro aparece um diálogo de confirmação, e só depois da concordância do usuário é chamada a ferramenta delete_coloring com o parâmetro confirmation: 'DELETE'. As operações de leitura e de alteração ficam separadas no servidor.
Limitações e conclusão
Nem todos os clientes MCP sabem exibir o MCP Apps, por isso as ferramentas devem ser projetadas para continuar úteis mesmo sem interface. Os argumentos que chegam do cliente não merecem confiança: o modelo pode errar a ferramenta ou os parâmetros, então direitos e validação devem ser verificados no servidor. Além disso, trata-se de infraestrutura adicional. O servidor precisa ser implantado, testado e mantido, e o MCP Apps acrescenta o desenvolvimento da interface e a checagem de compatibilidade.
A regra prática é simples. Se o usuário se contenta com uma resposta ou um resumo curto, faça apenas o MCP Server. Se precisar de filtros, seleção de vários itens, arquivos ou confirmação de ações perigosas, acrescente o MCP Apps. Antes disso, calcule se essa interface compensa o custo de mantê-la.
- 21 de nov. de 2026As vagas de FDE cresceram 4,6 vezes em um ano: o que faz o engenheiro no cliente
- 21 de nov. de 2026Capitã de equipe de natação entregou três tarefas ao ChatGPT pela agenda e cortou a rotina em muitas vezes
- 21 de nov. de 2026OpenAI GPT-6 Cyber encontrou cerca de 35 falhas no iPhone, no Mac e em outros dispositivos da Apple
- 21 de nov. de 202622 agentes Claude passaram seis semanas atrás de respostas sobre buracos negros e resolveram dois problemas
Perguntas frequentes sobre a notícia
O que faz o MCP Server?
O MCP não substitui as APIs existentes. Ele oferece uma interface padrão pela qual o cliente de IA encontra e chama ferramentas (tools) e recursos (resources). Por dentro, o servidor acessa suas APIs REST ou GraphQL, o banco de dados e outros serviços. A lógica de negócio e o controle de acesso continuam do lado da empresa. No exemplo do lançamento, dá para criar um único servidor com uma ferramenta como get_release_readiness.
O que o MCP Apps acrescenta?
Normalmente, o servidor devolve JSON, por exemplo "release 2.4.0, 3 tarefas bloqueantes, 5 PRs sem revisão, status at_risk", e o modelo reconta isso em texto. Para um resumo pequeno, isso basta. Mas dezenas de tarefas, filtros por equipe e comparação de releases são incômodos em texto, e perguntas de esclarecimento sem fim cansam. O MCP Apps associa a ferramenta a um recurso de UI. O cliente carrega a interface e mostra tabela, cartões, gráfico ou formulário diretamente na conversa. Os papéis são separados.
O que se sabe sobre Exemplo: galeria de colorir no ChatGPT?
O autor usou seu serviço de contos e colorir personalizados, feito em React, TypeScript e Supabase. Não migrou o aplicativo inteiro; manteve no chat três ações com as colorir prontas: visualizar, baixar e excluir. Ao pedido "Mostre minhas colorir mais recentes", o ChatGPT chama a ferramenta get_coloring_gallery, e a galeria se abre na conversa. Como isso funciona: O MCP Server roda como uma Supabase Edge Function, usando o pacote @modelcontextprotocol/server e o mesmo PostgreSQL do aplicativo principal.
Build & Ship Production AI Agents Without Boilerplate Code
Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.
O essencial da IA — uma vez por semana
Sete histórias que realmente importaram, escolhidas a dedo. Sem ruído nem releases.
Pronto! Verifique seu e-mail para a confirmação.