Интенсив 21–22.11 · БесплатноБесплатный 2-дневный интенсив по вайбкодингу 21–22 ноября в 16:00 МСК (Сб–Вс) · Живой Поток 3 стартует 23.11Записаться бесплатно →Поток 3 (23.11)
Безопасность и правоAPI / Продукт · В работуHabr AI→ оригинал

Как встроить своё приложение в ChatGPT: MCP Apps показал галерею раскрасок прямо в чате

Чтобы ChatGPT оценил риски релиза в пятницу, ему нужен доступ к GitHub, трекеру и календарю, и этот мост строит MCP Server. Но таблицу из полусотни задач в чате читать неудобно, и тут помогает MCP Apps: он показывает интерактивный интерфейс прямо в диалоге. Автор так встроил в ChatGPT галерею раскрасок на React и Supabase. Для короткой сводки хватит сервера, а для фильтров и действий нужен MCP Apps.

AI-обработка оригинала Habr AI; редакция Hamidun News
Как встроить своё приложение в ChatGPT: MCP Apps показал галерею раскрасок прямо в чате
Источник: Habr AI. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникHabr AI ↗
Главный редактор
Ключевой факт #1Сервер работает как Supabase Edge Function с той же PostgreSQL
Ключевой факт #2Удаление раскраски требует диалога подтверждения и параметра DELETE
Миниатюры UI подгружает саммодель получает только идентификаторы

Представьте, что руководитель проекта спрашивает у ИИ: «Какие риски есть для релиза в пятницу? Проверь незакрытые задачи, PR без ревью и ближайшие сроки». Данные лежат в GitHub, внутреннем таск-трекере и корпоративном календаре, и без подключения к ним модель ответить не сможет. Для таких подключений существует Model Context Protocol (MCP). Когда одного текстового ответа мало и нужно полистать картинки, отфильтровать задачи или скачать файл, поверх MCP работает расширение MCP Apps. Автор разбора на Habr показал обе части на живом проекте. Это хороший ориентир для тех, кто собирается встраивать своё приложение в ИИ-клиенты.

Что делает MCP Server

MCP не заменяет существующие API. Он даёт стандартный интерфейс, через который ИИ-клиент находит и вызывает инструменты (tools) и ресурсы (resources). Внутри сервер сам обращается к вашим REST или GraphQL API, базе данных и другим сервисам. Бизнес-логика и контроль доступа остаются на стороне компании.

В примере с релизом можно сделать один сервер с инструментом вроде get_release_readiness. Он соберёт незакрытые задачи, проверит PR без ревью, сопоставит сроки и вернёт сводку. Другой вариант: несколько независимых серверов, по одному на каждую систему. Выбор зависит от того, где удобнее держать логику объединения данных и обработки ошибок. Плюс подхода в том, что один сервер работает с разными клиентами, которые поддерживают протокол. Правда, возможности и ограничения у этих клиентов различаются.

Что добавляет MCP Apps

Обычно сервер возвращает JSON, например «релиз 2.4.0, 3 блокирующие задачи, 5 PR без ревью, статус at_risk», а модель пересказывает его текстом. Для маленькой сводки этого достаточно. Но десятки задач, фильтры по командам и сравнение релизов в тексте неудобны, а бесконечные уточняющие вопросы к модели утомляют. MCP Apps связывает инструмент с UI-ресурсом. Клиент загружает интерфейс и показывает таблицу, карточки, диаграмму или форму прямо в разговоре.

Роли разделены. Сервер отвечает за операции, данные, авторизацию и обращения к внешним системам. Приложение отвечает за отображение и при поддержке хоста само вызывает инструменты сервера. Полноценное веб-приложение при этом остаётся на месте, а в чат выносится только та его часть, которая нужна пользователю рядом с моделью.

Пример: галерея раскрасок в ChatGPT

Автор взял свой сервис персонализированных сказок и раскрасок на React, TypeScript и Supabase. Переносить всё приложение он не стал и оставил в чате три действия с готовыми раскрасками: просмотр, скачивание и удаление. По просьбе «Покажи мои последние раскраски» ChatGPT вызывает инструмент get_coloring_gallery, и в диалоге открывается галерея.

Как это устроено:

  • MCP Server работает как Supabase Edge Function на пакете @modelcontextprotocol/server и использует ту же PostgreSQL, что и основное приложение.
  • Авторизация идёт через Supabase Auth по OAuth. Доступ ограничен семейным аккаунтом, а принадлежность изображений дополнительно проверяется на сервере.
  • Инструмент связан с интерфейсом через _meta.ui.resourceUri. Сам UI регистрируется отдельным ресурсом с mimeType text/html;profile=mcp-app.
  • React и CSS собираются через esbuild и встраиваются в HTML, поэтому внешний JavaScript-файл не нужен. UI работает в изолированном окружении и не получает произвольного доступа к странице ChatGPT.
  • На клиенте используется пакет @modelcontextprotocol/ext-apps: объект App подключается к хосту, получает результат инструмента и реагирует на смену светлой и тёмной темы.

Передача данных устроена экономно. Инструмент галереи возвращает только идентификаторы раскрасок, а миниатюры React подгружает сам через служебный инструмент get_coloring_gallery_thumbnail с пометкой visibility: ['app']. Тяжёлые картинки не проходят через модель, и ей достаточно списка идентификаторов.

Скачивание работает через инструмент get_coloring_image и метод app.downloadFile(). Приложение получает PNG от сервера и отдаёт файл хосту, без ссылки на приватное хранилище. Удаление устроено строже, потому что меняет данные. Сначала показывается диалог подтверждения, и только после согласия пользователя вызывается delete_coloring с параметром confirmation: 'DELETE'. Операции чтения и изменения на сервере разделены.

Ограничения и вывод

Не все MCP-клиенты умеют показывать MCP Apps, поэтому инструменты стоит проектировать так, чтобы они оставались полезными и без интерфейса. Аргументам, которые приходят от клиента, доверять нельзя: модель может ошибиться с инструментом или параметрами, так что права и валидацию проверяйте на сервере. Кроме того, это дополнительная инфраструктура. Сервер нужно развернуть, протестировать и поддерживать, а MCP Apps добавляет разработку интерфейса и проверку совместимости.

Практическое правило простое. Если пользователю хватает ответа или короткой сводки, делайте только MCP Server. Если нужны фильтры, выбор нескольких элементов, файлы или подтверждение опасных действий, добавляйте MCP Apps. Перед этим прикиньте, окупится ли такой интерфейс стоимостью его поддержки.

Сюжет

Вопросы и ответы по материалу

Что известно по теме: что делает MCP Server?

MCP не заменяет существующие API. Он даёт стандартный интерфейс, через который ИИ-клиент находит и вызывает инструменты (tools) и ресурсы (resources). Внутри сервер сам обращается к вашим REST или GraphQL API, базе данных и другим сервисам. Бизнес-логика и контроль доступа остаются на стороне компании. В примере с релизом можно сделать один сервер с инструментом вроде get_release_readiness. Он соберёт незакрытые задачи, проверит PR без ревью, сопоставит сроки и вернёт сводку.

Что известно по теме: что добавляет MCP Apps?

Обычно сервер возвращает JSON, например «релиз 2.4.0, 3 блокирующие задачи, 5 PR без ревью, статус at_risk», а модель пересказывает его текстом. Для маленькой сводки этого достаточно. Но десятки задач, фильтры по командам и сравнение релизов в тексте неудобны, а бесконечные уточняющие вопросы к модели утомляют. MCP Apps связывает инструмент с UI-ресурсом. Клиент загружает интерфейс и показывает таблицу, карточки, диаграмму или форму прямо в разговоре. Роли разделены.

Что известно по теме: пример: галерея раскрасок в ChatGPT?

Автор взял свой сервис персонализированных сказок и раскрасок на React, TypeScript и Supabase. Переносить всё приложение он не стал и оставил в чате три действия с готовыми раскрасками: просмотр, скачивание и удаление. По просьбе «Покажи мои последние раскраски» ChatGPT вызывает инструмент get_coloring_gallery, и в диалоге открывается галерея. Как это устроено: MCP Server работает как Supabase Edge Function на пакете @modelcontextprotocol/server и использует ту же PostgreSQL, что и основное приложение.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ Практика · Hamidun Academy

Соберите рабочего ИИ-агента или сервис своими руками без ручного кода

В Академии Жемала Хамидуна (academy.hamidun.com) открыт бесплатный 72-часовой тест-драйв: интерактивные скетч-уроки по Claude Code и Cursor, живой Tech Radar и готовые шаблоны агентов.

Открыть 72ч бесплатный доступ →Интенсив по Вайб-кодингу
Что вы думаете?
Загружаем комментарии…