chat

Что такое chat?

chat — универсальный AI-чат-клиент, предназначенный для работы с MCP-сервером сервиса. Он предоставляет интерфейс на естественном языке, который подключается к внешнему MCP-серверу и взаимодействует с его инструментами независимо от домена (например, доставка, бронирование или управление задачами).

Проект построен как приложение Next.js App Router и фокусируется на практических аспектах UI и интеграции для чат-опыта: подключение инструментов через MCP, потоковые ответы, история сообщений и поддержка мультимодального контента, такого как ввод изображений и выводы ассистента на базе Markdown.

Ключевые возможности

• Интеграция MCP-инструментов через Streamable HTTP: подключается к одному внешнему MCP-серверу, настраивается через MCP_URL (любой бэкенд) или MCP_APPS_URL (TypeScript + встроенный UI); приложение отклоняет наличие обеих настроек во время выполнения.
• Потоковые ответы ИИ с индикаторами набора в реальном времени: вывод ассистента передается по потоку по мере генерации, а не целиком.
• Рендеринг Markdown для сообщений ассистента: сообщения ассистента отображаются как Markdown, включая таблицы, списки, блоки кода и ссылки.
• Прикрепление изображений с обрезкой перед отправкой: пользователи могут прикреплять изображения, им предлагается обрезать перед отправкой, изображение сжимается и загружается только при отправке (чтобы избежать преждевременных загрузок).
• Поддержка вывода изображений LLM: ассистент может включать изображения в ответы с использованием стандартного синтаксиса Markdown, например ![alt](url); изображения отображаются как квадратные карточки с ленивой загрузкой и открываются в полном размере по клику.
• История разговоров с пагинацией на основе курсора: постоянная история чата загружается страницами с бесконечной прокруткой.
• Поддержка аутентификации и локализации: email/пароль с верификацией, сбросом и Google OAuth; определение локали по IP-геолокации (IPinfo Lite) с fallback на Accept-Language и переопределяемая настройка пользователя.

Как использовать chat

1. Запустите приложение (см. prerequisites) и создайте файл .env.local в корне проекта.
2. Настройте параметры подключения MCP с помощью MCP_URL или MCP_APPS_URL (выберите один). Опционально задайте переменные брендинга и контекста персоны, такие как NEXT_PUBLIC_APP_NAME и APP_PERSONA_CONTEXT.
3. Войдите с использованием поддерживаемых методов аутентификации.
4. Начните разговор в UI чата. Ассистент может передавать ответы по потоку и вызывать MCP-инструменты, доступные на вашем MCP-сервере.
5. Если включить лимиты сообщений (WEEKLY_MESSAGE_LIMIT), UI покажет предупреждение при низком остатке квоты и заблокирует отправку при исчерпании.

Сценарии использования

• Ассистент для доставки или диспетчеризации: подключите MCP-сервер, связанный с доставкой, чтобы помогать пользователям координировать запросы и отслеживать их в разговорном workflow.
• Бронирование мастера: подключите MCP-сервер для бронирования услуг, чтобы ассистент вел пользователей через задачи и собирал детали через вызовы инструментов.
• Интерфейс управления задачами: используйте MCP-сервер для управления задачами, чтобы переводить естественный язык в действия вашего бэкенда.
• Мультимодальная помощь с изображениями: загрузите изображение (обрежьте перед отправкой) и попросите ассистента проанализировать его или интегрировать в workflow; также поддерживайте ответы ассистента с карточками изображений.
• Многоязычная поддержка для команд: полагайтесь на встроенное определение локали и кастомную i18n-систему для локализации строк UI и системных промптов ИИ на языках EN, ID, KR, JP, ES, ZH, DE, NL, FR и IT.

FAQ

Какие конфигурации MCP поддерживает приложение?

Приложение поддерживает подключение к одному MCP-серверу. Оно использует либо MCP_URL, либо MCP_APPS_URL. Установка обоих отклоняется во время выполнения.

Как передаются ответы ИИ в UI?

Ответы передаются по потоку в реальном времени с индикаторами набора во время генерации.

Могут ли пользователи отправлять изображения, и может ли ассистент их показывать?

Да. Пользователи прикрепляют изображения через流程 обрезки перед отправкой; изображения сжимаются и загружаются только при отправке сообщения. Ассистент также может встраивать изображения в ответы с использованием синтаксиса Markdown для изображений.

Сохраняется ли история chat?

Да. Приложение поддерживает постоянную историю разговоров и использует пагинацию на основе курсора с бесконечной прокруткой.

Есть ли лимиты на количество сообщений?

Опционально можно настроить еженедельный лимит на пользователя с WEEKLY_MESSAGE_LIMIT. При включении UI предупреждает при низком остатке и возвращает 429 при исчерпании.

Альтернативы

• Универсальные AI-чат веб-приложения без интеграции с инструментами MCP: они ориентированы на чат на основе промптов, но не обеспечивают структурированное подключение к протоколу инструментов вашего сервиса.
• Собственные реализации MCP-клиентов (другой UI/стек): вы можете создать другой клиент для вызова инструментов MCP, но рабочий процесс и функции (обработка изображений, история сообщений, локализация) могут отличаться.
• RAG/чат-решения, ориентированные на поиск, а не на вызов инструментов: они сосредоточены на поиске знаний и заземлении документов вместо оркестрации действий через инструменты MCP.
• Универсальные мультимодальные чат-интерфейсы: они поддерживают ввод/вывод изображений, но могут не включать такой же рабочий процесс на базе MCP для подключения к инструментам внешних сервисов.