Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoAnálise · No radarHabr AI→ original

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
Como integrar seu aplicativo ao ChatGPT: MCP Apps mostrou uma galeria de colorir direto no chat
Fonte: Habr AI. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalHabr AI ↗
Editor-chefe
Dado-chave #1O servidor funciona como uma Supabase Edge Function, com o mesmo PostgreSQL
Dado-chave #2Excluir uma colorir exige um diálogo de confirmação e o parâmetro DELETE
Dado-chave #3As miniaturas são carregadas pela própria UI: o modelo recebe apenas os identificadores

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.

História

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.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Hands-On AI Engineering · Hamidun Academy

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.

Start 72h Free Trial →Vibe-Coding Intensive
O que você acha?
Carregando comentários…