> For the complete documentation index, see [llms.txt](https://docs.flowlity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowlity.com/ru/mcp.md). # Coplanner/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-совместимым инструментом.