# MCP MCP (Model Context Protocol) — это открытый стандарт, позволяющий AI-ассистентам подключаться напрямую к внешним инструментам и источникам данных. Flowlity поддерживает собственный MCP-сервер, так что вы можете запрашивать данные цепочки поставок (supply chain), создавать промо, управлять представлениями и многое другое — прямо из чата. Представьте это как мост: AI становится интерфейсом, а Flowlity остаётся движком.
Интерфейс Claude с коннектором Ask Flowlity

Claude с коннектором Flowlity MCP — спрашивайте что угодно о данных вашей цепочки поставок.

{% hint style="info" %} MCP поддерживают **Claude**, **ChatGPT** и **GitHub Copilot**. По мере распространения протокола появляются и другие клиенты. {% endhint %} {% embed url="" %} Посмотрите MCP-сервер Flowlity в действии {% endembed %} ## Что можно делать ### Читать ваши данные Задавайте вопросы на естественном языке и получайте реальные ответы из вашего аккаунта Flowlity: * **Уровни запасов** — «Сколько запаса у меня на площадке Paris?» * **Точность прогноза** — «У каких продуктов самая низкая точность прогноза? Покажи топ-5.» * **Детали продукта** — «Расскажи о продукте X — что происходит с запасом и спросом?» * **KPI и тренды** — «Покажи тренды KPI за последние 6 месяцев.» * **Заказы и уведомления** — «Есть ли уведомления по заказам на площадке Lyon?» * **Мощности** — «Перечисли единицы мощностей и их уведомления.» ### Выполнять действия Возможности не ограничиваются только чтением — MCP-сервер также позволяет действовать с вашими данными: * **Создавать представления** — попросите AI настроить представление в модулях Спрос или Планирование с нужными колонками и фильтрами, не открывая приложение. * **Создавать промо** — «Создай промо для всех продуктов класса A с увеличением прогноза на 30 %.» AI сам найдёт продукты и создаст событие. * **Переопределять прогнозы** — корректируйте значения прогноза в разговоре. * **Моделировать спрос** — прорабатывайте сценарии «что если» и смотрите влияние на прогнозируемый запас. * **Импортировать данные** — загружайте CSV-файлы и запускайте пайплайны данных (Flowlity Lite). * **Применять рекомендованные заказы** — принимайте рекомендуемые Flowlity количества заказов. ### Сила кросс-инструментов Главное преимущество перед встроенной AI-боковой панелью: в одном и том же разговоре вы можете одновременно обращаться к **Flowlity + вашему CRM + вашему ERP + таблицам**. Например: вытащить сделки из CRM, сопоставить их с прогнозами Flowlity и выявить расхождения — всё в одном чате. ## Настройка ### Предварительные условия * Действующий **аккаунт Flowlity** * Доступ к поддерживаемому AI-ассистенту (Claude или ChatGPT) ### Подключение через Claude (рекомендуется) 1. Зайдите на [claude.ai](https://claude.ai) и откройте **Settings**. 2. Перейдите в **Connectors** и нажмите **Add custom connector**. 3. Заполните поля: * **Название**: `Flowlity` * **Server URL**: предоставляется вашим *Flowlity Customer Success Manager* * **Client ID**: предоставляется вашим *Flowlity Customer Success Manager* 4. Сохраните конфигурацию. 5. Вас перенаправит на страницу аутентификации — **войдите с тем же e-mail, что и в аккаунте Flowlity**. 6. Проверьте: начните новый разговор и спросите *«List all my Flowlity sites»*. Если площадки появились — соединение работает. ### Подключение через ChatGPT 1. Зайдите на [chatgpt.com](https://chatgpt.com) и откройте **Settings**. 2. Перейдите в **Advanced Settings** и включите **Developer Mode**. 3. Откройте **Apps** и создайте новое приложение. 4. Укажите **Server URL**, предоставленный вашим *Customer Success Manager* Flowlity. Аутентификация определяется автоматически — client ID не требуется. 5. Авторизуйтесь под своим аккаунтом Flowlity. 6. Проверьте: спросите *«List all my Flowlity sites»*. ### Подключение через Claude Code (CLI) Добавьте следующий фрагмент в MCP-конфигурацию Claude Code: ```json { "mcpServers": { "flowlity": { "type": "url", "url": "/mcp/" } } } ``` При первом использовании вам будет предложено пройти аутентификацию. ## Доступные инструменты MCP-сервер предоставляет следующие инструменты, сгруппированные по доменам: | Домен | Инструменты | Описание | | ------------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | **Sites** | `list_sites`, `get_site_config` | Просмотр площадок и их конфигурации | | **Продукты** | `list_products`, `get_product_detail`, `get_product_planning` | Поиск продуктов, просмотр деталей и доступ к временным рядам планирования | | **Заказы** | `list_orders`, `get_order_alerts` | Просмотр строк заказов и уведомлений | | **Demand** | `get_demand_summary`, `get_forecast_accuracy`, `override_forecast`, `simulate_demand` | Анализ спроса, проверка точности, переопределение прогнозов и симуляции | | **Inventory** | `get_stock_levels`, `get_stock_coverage` | Проверка уровней запасов и метрик покрытия | | **Capacity** | `list_capacity_units`, `get_capacity_alerts` | Мониторинг единиц мощностей и уведомлений | | **Теги** | `list_tags` | Список тегов и категорий продуктов | | **Промо** | `list_promotions`, `get_promotion_detail`, `create_promotion` | Просмотр, изучение и создание прогнозных событий | | **KPIs** | `get_site_kpis`, `get_kpi_trends`, `list_product_alerts` | KPI для дашборда, анализ трендов и уведомления по продуктам | | **Views** | `list_views`, `create_view`, `update_view`, `delete_view` | Управление сохранёнными представлениями в модулях Спрос и Планирование | | **Data** | `upload_import_file`, `trigger_import_dag`, `get_import_status`, `export_data` | Импорт CSV-данных, запуск пайплайнов и экспорт датасетов (Flowlity Lite) | | **Orders (write)** | `apply_recommended_orders` | Принятие рекомендуемых Flowlity количеств заказов | {% hint style="info" %} Вам не нужно запоминать названия инструментов. Просто опишите на естественном языке, что вам нужно, и AI-ассистент сам выберет подходящий инструмент. {% endhint %} ## Безопасность и приватность * **Те же учётные данные, те же права** — MCP-сервер аутентифицируется под вашим аккаунтом Flowlity. Вы видите только те площадки и данные, к которым у вас уже есть доступ. * **OAuth 2.0** — аутентификация использует отраслевой стандарт OAuth 2.0 с bearer-токенами. * **Никаких утечек данных** — все соединения с БД проходят через приватные сети. Публичного IP не существует. * **Детерминированные вызовы инструментов** — когда AI вызывает инструмент, он выполняет реальный запрос к базе данных. Возвращаемые данные всегда реальны и точны — меняться может только формулировка и интерпретация со стороны AI. ## Примеры запросов Вот несколько запросов для начала: | Цель | Пример запроса | | ----------------------- | ----------------------------------------------------------------------------------------------------- | | Обзор | *«Дай сводку по моим KPI для площадки Paris»* | | Разобраться с продуктом | *«Какая ситуация с запасом у продукта ABC-123?»* | | Найти проблемы | *«У каких продуктов покрытие запасом меньше 7 дней?»* | | Точность прогноза | *«Покажи 5 продуктов с худшим MAPE»* | | Создать промо | *«Создай увеличение прогноза на 20 % для всех продуктов с тегом „Summer" с 1 июля по 31 августа»* | | Смоделировать эффект | *«Что будет, если спрос вырастет на 15 % в следующем месяце на площадке Lyon?»* | | Настроить представление | *«Создай представление в Планировании с колонками stock value, demand 30d и MAPE, с фильтром по MTS»* | | Экспортировать данные | *«Экспортируй данные о спросе за последние 3 месяца по площадке Berlin в CSV»* | ## FAQ
Есть ли у AI доступ ко всем данным моей компании? Нет. MCP-сервер соблюдает те же права пользователя, что и приложение Flowlity. Вы видите только те площадки и продукты, которые назначены вашему аккаунту.
Может ли AI галлюцинировать данные? Вызовы инструментов детерминированы — они выполняют реальные запросы к базе данных и возвращают настоящие данные. AI не может выдумать цифры. Однако интерпретация или сводка, которую делает AI, иногда может быть неточной. Всегда сверяйте критичные решения с приложением Flowlity.
Какие AI-ассистенты поддерживаются? Сейчас MCP поддерживают Claude (Anthropic), ChatGPT (OpenAI) и GitHub Copilot. По мере распространения стандарта ожидаются и другие клиенты.
Есть ли плата за использование MCP? Для использования MCP-сервера нужен аккаунт Flowlity. Стоимость самого AI (токены, подписки) зависит от выбранного провайдера (например, Claude Pro, ChatGPT Plus).
Можно ли использовать MCP вместе с другими инструментами в одном разговоре? Да — это одно из ключевых преимуществ. В рамках одного разговора вы можете подключать Flowlity наряду со своим CRM, ERP, таблицами или любым другим MCP-совместимым инструментом.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.flowlity.com/ru/mcp.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.