> 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/ii-i-avtomatizacii/co-planner/mcp.md).

# Co-planner в ваших ИИ-инструментах (MCP)

Используйте Co-planner из собственного ИИ-ассистента (Claude, ChatGPT или Microsoft Copilot Studio), подключив его к Flowlity через MCP.

Co-planner встроен в приложение Flowlity: см. [Co-planner](/ru/ii-i-avtomatizacii/co-planner.md). Если вы предпочитаете работать из собственного ИИ-ассистента, его можно подключить к Flowlity через MCP (Model Context Protocol), открытый стандарт, который позволяет ассистенту пользоваться внешними инструментами. После этого ваш ассистент читает данные Flowlity так же, как Co-planner, рядом с другими вашими инструментами, например CRM или электронными таблицами.

{% hint style="info" %}
Поддерживаемые ассистенты: **Claude** (веб-версия, десктоп и Claude Code), **ChatGPT** и **Microsoft Copilot Studio**, который также публикует агентов в Microsoft 365 и Teams.
{% endhint %}

{% embed url="<https://app.arcade.software/share/McpxHRqhSSnSKnhrxSyV>" %}
Посмотрите MCP-сервер Flowlity в действии
{% endembed %}

## Что может ваш ассистент

**Читать ваши данные** по площадкам и продуктам, которые видит ваш аккаунт:

* уровни запасов, покрытие запасом и историю запасов
* спрос, прогнозы, точность прогноза и историю My Forecast
* заказы, оповещения по заказам, дефициты без подтверждённых заказов и еженедельный обзор поставок
* детали продуктов, планирование, а также ограничения продуктов, поставщиков и тегов
* KPI, тренды, оповещения и мощности
* промоакции и их результаты, клиентов, позиции на выводе из ассортимента, комментарии и сохранённые представления

**Вносить несколько изменений**, и только эти:

* создавать промоакции и события прогноза
* создавать сохранённые представления, а также изменять или удалять созданные вами представления
* публиковать результат в виде веб-страницы и давать вам ссылку на неё (без изменения ваших данных во Flowlity)

Ассистент не может подтверждать или изменять заказы, вручную править значения прогноза или менять настройки.

**Следовать процедурам Flowlity** для регулярных задач, например еженедельного обзора пополнения. См. [Skills](/ru/ii-i-avtomatizacii/co-planner/mcp/skills.md).

## Перед началом

* Аккаунт Flowlity. Ваш ассистент видит ровно то, что этот аккаунт видит в приложении.
* Доступ к Claude, ChatGPT или Microsoft Copilot Studio с тарифом, который позволяет подключать собственные коннекторы.
* URL сервера Flowlity: `https://co-planner.app.flowlity.com/mcp`

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

{% stepper %}
{% step %}

### Добавьте собственный коннектор

На [claude.ai](https://claude.ai) откройте **Settings** > **Connectors** и нажмите **Add custom connector**.
{% endstep %}

{% step %}

### Заполните данные коннектора

Введите `Flowlity` в качестве имени и `https://co-planner.app.flowlity.com/mcp` в качестве URL сервера. Оставьте расширенные настройки пустыми, если только ваш Customer Success Manager не выдал вам client ID. Нажмите **Add**.
{% endstep %}

{% step %}

### Войдите

Нажмите **Connect** и войдите с тем же email, что и в вашем аккаунте Flowlity.
{% endstep %}

{% step %}

### Проверьте подключение

Начните новый разговор и попросите: «Покажи все мои площадки Flowlity». Если ваши площадки появились, подключение работает.
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}

### Включите режим разработчика

На [chatgpt.com](https://chatgpt.com) откройте **Settings**, перейдите в расширенные настройки и включите **Developer mode**.
{% endstep %}

{% step %}

### Создайте приложение

В разделе **Apps** создайте новое приложение и введите `https://co-planner.app.flowlity.com/mcp` в качестве URL сервера. Способ входа определяется автоматически: client ID не нужен.
{% endstep %}

{% step %}

### Войдите и проверьте

Авторизуйтесь с помощью аккаунта Flowlity, затем попросите: «Покажи все мои площадки Flowlity».
{% endstep %}
{% endstepper %}

## Как подключить Microsoft Copilot Studio и Teams

Copilot Studio добавляет Flowlity как инструмент собственного агента, которого затем можно опубликовать в Microsoft 365 и Teams.

{% stepper %}
{% step %}

### Создайте агента

Пропустите этот шаг, если агент у вас уже есть. Задайте ему имя, например `coplanner`, и нажмите **Create**.

<figure><img src="https://622083814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5NOvQppKEgHym8wX2Q9V%2Fuploads%2Fgit-blob-da4d4839ccd49529084a31707e80d7cde0c20bef%2Fmcp-copilot-01-create-agent.png?alt=media" alt="Окно Copilot Studio для задания имени и создания нового агента"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Добавьте инструмент

Откройте вкладку агента **Tools** и нажмите **Add a tool**.

<figure><img src="https://622083814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5NOvQppKEgHym8wX2Q9V%2Fuploads%2Fgit-blob-01f1f476f93b0401ad3259a80eb26a366780b030%2Fmcp-copilot-02-add-tool.png?alt=media" alt="Вкладка Tools в Copilot Studio с кнопкой Add a tool"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Выберите MCP

В окне **Add tool** выберите **Add new MCP**.

<figure><img src="https://622083814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5NOvQppKEgHym8wX2Q9V%2Fuploads%2Fgit-blob-ae18494c5fe9f6efd67821d5ee2022f87cd07489%2Fmcp-copilot-03-add-mcp.png?alt=media" alt="Окно Add tool с выделенным вариантом Add new MCP"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Опишите сервер Flowlity

Заполните форму **Model Context Protocol server**:

* **Server name**: например `flowlity mcp`.
* **Server description**: например `Flowlity Co-planner, for data analysis on Flowlity's data.`
* **Server URL**: `https://co-planner.app.flowlity.com/mcp`
* **Authentication**: **OAuth 2.0**, тип **Dynamic discovery**.

<figure><img src="https://622083814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5NOvQppKEgHym8wX2Q9V%2Fuploads%2Fgit-blob-e38394c2b068c6db4ce1b3043e4cd3225cb81796%2Fmcp-copilot-04-add-server.png?alt=media" alt="Форма добавления сервера Model Context Protocol с именем, описанием, URL и OAuth 2.0"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Создайте подключение

В разделе **Connection** нажмите **Create new connection**. На странице регистрации создайте аккаунт с тем же email, что и в вашем аккаунте Flowlity, подтвердите email, затем вернитесь и войдите.

<figure><img src="https://622083814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5NOvQppKEgHym8wX2Q9V%2Fuploads%2Fgit-blob-61a366dd626830510daea05e17d6564dd127259d%2Fmcp-copilot-05-create-connection.png?alt=media" alt="Экран Add tool с предложением создать новое подключение для MCP-сервера Flowlity"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Опубликуйте в Microsoft 365 и Teams

Откройте вкладку **Channels**, выберите **Microsoft 365 and Microsoft Teams**, включите **Make available in Microsoft 365 Copilot**, затем опубликуйте агента.

<figure><img src="https://622083814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5NOvQppKEgHym8wX2Q9V%2Fuploads%2Fgit-blob-fe02278bfe8ed47844e17ad8ab40c0106db26faa%2Fmcp-copilot-06-enable-teams-1.png?alt=media" alt="Навигация агента в Copilot Studio с выделенной вкладкой Channels"><figcaption></figcaption></figure>

<figure><img src="https://622083814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5NOvQppKEgHym8wX2Q9V%2Fuploads%2Fgit-blob-3aa221f652c69d433a62d4567066861414b8290c%2Fmcp-copilot-07-enable-teams-2.png?alt=media" alt="Список каналов Microsoft с Microsoft 365 и Microsoft Teams"><figcaption></figcaption></figure>

<figure><img src="https://622083814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5NOvQppKEgHym8wX2Q9V%2Fuploads%2Fgit-blob-9a8aaed9e3d4b89455189f81c3547c4456e5151f%2Fmcp-copilot-08-enable-teams-3.png?alt=media" alt="Панель канала Microsoft 365 и Teams с включённой опцией Make available in Microsoft 365 Copilot"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Проверьте подключение

Начните разговор с агентом и попросите: «Покажи все мои площадки Flowlity».
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}

### Добавьте сервер

В терминале выполните:

```bash
claude mcp add --transport http flowlity https://co-planner.app.flowlity.com/mcp
```

Добавьте `--scope user`, чтобы использовать сервер во всех ваших проектах.
{% endstep %}

{% step %}

### Войдите

В Claude Code введите `/mcp`, выберите `flowlity` и выполните вход в браузере с тем же email, что и в вашем аккаунте Flowlity.
{% endstep %}
{% endstepper %}

Чтобы вместо этого сделать сервер общим для проекта, добавьте его в файл `.mcp.json` проекта:

```json
{
  "mcpServers": {
    "flowlity": {
      "type": "http",
      "url": "https://co-planner.app.flowlity.com/mcp"
    }
  }
}
```

## Как проверить, что подключение работает

{% stepper %}
{% step %}

### Запросите список площадок

В новом разговоре попросите: «Покажи все мои площадки Flowlity».
{% endstep %}

{% step %}

### Если ни одна площадка не появилась

Проверьте, что вы вошли с тем же email, что и в вашем аккаунте Flowlity, затем отключите и снова подключите коннектор. Если ошибка повторяется, обратитесь к вашему Customer Success Manager.
{% endstep %}

{% step %}

### Задайте первый вопрос

Например: «Дай сводку моих KPI по площадке Paris», «У каких продуктов покрытие запасом меньше 7 дней?» или «Покажи 5 продуктов с самой низкой точностью прогноза».
{% endstep %}
{% endstepper %}

## Безопасность и конфиденциальность <a href="#security-and-privacy" id="security-and-privacy"></a>

* **Тот же аккаунт, те же права**: подключение использует ваш аккаунт Flowlity. Вы видите только те площадки и данные, к которым у вас уже есть доступ.
* **OAuth 2.0**: вы входите с аккаунтом Flowlity по стандарту OAuth 2.0. Ваш пароль никогда не передаётся ассистенту, и ключ API не нужен.
* **Закрытый доступ к базе данных**: подключения к базе данных идут через частные сети.
* **Реальные данные**: когда ассистент вызывает инструмент Flowlity, инструмент выполняет реальный запрос к вашим данным. Различаться могут только формулировки и интерпретация ассистента.

### Куда уходят ваши данные?

Это зависит от того, каким Co-planner вы пользуетесь.

* **Co-planner в приложении Flowlity**: разговор, вызовы инструментов и модель работают на стороне Flowlity. Модель размещена в Microsoft Azure в облаке Flowlity в рамках корпоративных соглашений Flowlity. Ваши данные исключены из обучения моделей, и сторонний ИИ-аккаунт не задействован. Этот вариант рекомендуется для конфиденциальных данных.
* **Ваш собственный ИИ-ассистент**: сервер Flowlity возвращает только те данные, которые разрешено видеть вашему аккаунту, и только когда ассистент их запрашивает. Затем ваш ИИ-провайдер обрабатывает эти результаты в рамках вашего собственного договора с ним, как документ, который вы вставляете в ассистент. Flowlity не контролирует, как ваш провайдер хранит или использует эти данные, поэтому используйте бизнес- или корпоративный тариф, который исключает ваши данные из обучения, или ассистента, развёрнутого в вашем собственном облаке (например, Copilot Studio в вашем тенанте Microsoft).

В обоих случаях сервер никогда не раскрывает больше, чем ваш аккаунт уже видит в приложении.

## Частые вопросы

<details>

<summary>Видит ли ассистент все данные моей компании?</summary>

Нет. Он видит площадки и продукты, назначенные вашему аккаунту Flowlity, так же, как вы в приложении.

</details>

<details>

<summary>Может ли ассистент придумывать цифры?</summary>

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

</details>

<details>

<summary>Это платно?</summary>

Нужен аккаунт Flowlity. Расходы на использование ИИ (подписки, токены) зависят от выбранного вами ИИ-провайдера.

</details>

<details>

<summary>Можно ли использовать Flowlity вместе с другими инструментами в одном разговоре?</summary>

Да. В одном разговоре ваш ассистент может использовать Flowlity рядом с вашей CRM, ERP, электронными таблицами или любым другим подключённым инструментом.

</details>