Интеграции / MCP

MCP-сервер для AI-агентов

Один интеграционный слой, который превращает Telegram, n8n, GigaChat и базу знаний в инструменты, доступные любому AI-клиенту. Подключается к n8n, Qwen Code и другим MCP-клиентам по HTTPS — без отдельного API под каждого агента.

Проверяю статус сервера…

01 / Зачем это нужно

Чтобы агент не был чатом, который умеет только говорить

MCP даёт агенту руки: отправить уведомление, запустить пайплайн, классифицировать обращение, найти ответ в документации. Четыре сценария, которые закрываются без ручных переносов данных.

01

Заявки без ручного копирования

Агент принимает обращение и запускает n8n-пайплайн по событию lead: CRM, письмо, уведомление в Telegram. Менеджер не переносит данные между окнами и не теряет заявки.

02

Ответы по документации клиента

Ресурсы kb:// отдают статьи из Supabase с read-only RLS. Ассистент отвечает фактами из регламентов и инструкций, а не догадками, и не получает доступ к лишним таблицам.

03

Сортировка обращений до менеджера

classify_ticket относит обращение к продажам, поддержке, жалобе или спаму и ставит приоритет. Работает через GigaChat, без LLM переключается на эвристику.

04

Один слой вместо зоопарка интеграций

n8n, Qwen Code и другие MCP-клиенты используют одни и те же инструменты. Не нужно писать отдельный API под каждого агента и дублировать логику.

02 / Как это работает

Клиент → инструмент → результат

Транспорт streamable HTTP, протокол JSON-RPC. Тот же сервер запускается в stdio для локального Qwen Code, поэтому сценарии одинаково работают на VPS и на машине разработчика.

  1. 01

    Клиент

    n8n, Qwen Code или ваш агент отправляет JSON-RPC на /mcp и передаёт Bearer-токен.

  2. 02

    MCP-сервер

    Проверяет авторизацию, валидирует вход и вызывает Telegram, n8n, GigaChat или Supabase.

  3. 03

    Результат

    Возвращает данные или подтверждение. Базы и секреты остаются на сервере, наружу не уходят.

Внутри контейнера доступ к Telegram, n8n, GigaChat и Supabase идёт по их API. Наружу открыты только /mcp (с токеном) и /health (без данных).

03 / Инструменты

Что умеет сервер

Четыре инструмента и два ресурса. Этого достаточно, чтобы агент принимал заявки, запускал пайплайны и отвечал по документации.

send_telegram_notification

Уведомления в Telegram

Отправляет сообщение в разрешённый чат или канал. Список chat_id ограничен allowlist, чтобы агент не писал куда попало.

run_n8n_workflow

Запуск n8n-пайплайнов

Триггерит workflow по событию lead, support или billing. Payload ограничен по размеру, события — по списку.

classify_ticket

Классификация обращений

Относит текст к категории продажи, поддержка, жалоба или спам и ставит приоритет. Работает через GigaChat, без LLM переключается на эвристику.

get_capabilities

Состояние интеграций

Возвращает, какие сервисы настроены и какие инструменты доступны. Удобно для health-check и диагностики.

Ресурсы

  • kb://articles/{query} Поиск по базе знаний клиента в Supabase с read-only RLS.
  • kb://article/{article_id} Полная статья базы знаний по ID.

04 / Подключение

Как подключить

Транспорт streamable HTTP. Авторизация — Bearer-токен, который выдаю после брифа. Внутри одного VPS n8n ходит к серверу по внутренней сети без интернета.

  • HTTPS и Let's Encrypt, без самоподписанных сертификатов
  • Bearer-токен на уровне приложения, health открыт отдельно
  • Supabase — read-only ключ с RLS, не service_role
  • Telegram — allowlist чатов, n8n — enum событий и лимит payload
  • Секреты только в переменных окружения на сервере
HTTP / streamable mcp.eduardwit.ru
POST /mcp
Authorization: Bearer <token>
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"initialize",
 "params":{"protocolVersion":"2025-06-18",
           "capabilities":{},
           "clientInfo":{"name":"n8n","version":"1"}}}

05 / Статус

Живое состояние

Данные приходят с самого сервера, без ручных обновлений. Если интеграция выключена, это видно сразу.

Telegram
—
n8n
—
GigaChat
—
База знаний
—

Проверяю health…

Нужен такой слой под ваш процесс?

Соберу MCP-сервер под ваши сервисы: CRM, оплата, база знаний, уведомления. С авторизацией, ограничениями доступа и без публичных портов.