> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Подключите свой MCP-совместимый агент к Flowglad

Подключите MCP-совместимый агент к Flowglad, чтобы работать с бизнес-знаниями и операционным контекстом вашей организации.

Коннектор может находить и редактировать Pages, читать файлы и подключённые записи, создавать Tasks, управлять переиспользуемыми Skills, а также создавать и запускать Automations. Доступные инструменты зависят от подключённой идентичности, выданных разрешений и включённых функций продукта.

## Применение шаблона

Если `templates.apply` доступен в `tools/list`, передайте опубликованный `templateId` и существующий `spaceId`, чтобы создать все ресурсы шаблона. Applications, Automations и обычные копии файлов принадлежат этому Space; Skills принадлежат организации. Файлы получают настроенные имена в корне Space и никогда не перезаписывают существующие файлы. Конфликт одинаковых имён приводит к сбою этого компонента, при этом независимые компоненты могут продолжить работу. Завершение создания файла означает, что байты и метаданные надёжно сохранены; индексация при этом не ожидается.

При необходимости передайте `connections` в виде массива объектов `{ connector, connectionId }`, не более одного подключения на провайдера. Переданные подключения должны быть доступны, совместимы и, если это требуется, уже назначены Space. Если подключения не указаны, ресурсы остаются в ожидании настройки. В ответе рекомендуются подходящие подключения или, если их нет, создание нового подключения.

Создание выполняется в одной задаче Trigger.dev в порядке зависимостей, а результаты по каждому компоненту записываются в метаданные и вывод задачи. Автоматические повторные попытки всей задачи отключены; задача, завершившаяся сбоем или прерванная, может оставить часть ресурсов. Ответ подтверждает, что создание поставлено в очередь, и содержит запланированные компоненты и рекомендации по подключениям; он не подтверждает, что создание ресурсов завершено. Чтобы найти и изучить ресурсы, используйте их инструменты list/get. Успешно созданные ресурсы сохраняются, даже если другой компонент завершится сбоем.

Применение шаблона откладывает проверку исполнения и не активирует и не запускает его ресурсы. Каждый вызов применения создаёт новые копии, в том числе при повторных попытках. Чтобы посмотреть, что было создано, используйте инструменты ресурсов.

## Перед подключением

Вам понадобятся:

* Аккаунт Flowglad с доступом к организации, которую вы хотите использовать.
* Продакшн-URL MCP вашей организации.
* Агент или клиент, поддерживающий удалённый MCP-сервер через Streamable HTTP и OAuth.
* Разрешения на уровне организации и Space, необходимые для предполагаемой работы.
* Любые исходные Connection или файлы, уже доступные в соответствующем Space.

В опубликованном разделе цен на [главной странице Flowglad](https://www.flowglad.com/) MCP включён в тарифы Free, Plus и Max. Разрешения организации и Space, выдача OAuth и доступ к подключённым источникам по-прежнему применяются.

Подключения к внешним бизнес-системам должны быть настроены во Flowglad и открыты для нужного Space, прежде чем агент сможет их использовать. См. [Connectors](/docs/ru/connectors.md) и [Spaces](/docs/ru/spaces.md).

## Найдите URL вашей организации

Продакшн-коннектор использует URL, специфичный для организации:

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

Замените `{orgId}` фактическим ID вашей организации во Flowglad. Сохраните ID полностью, включая префикс `org_`. Не вводите фигурные скобки или выдуманный ID организации.

Во Flowglad откройте **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website**. Скопируйте показанный там URL MCP организации. Для удалённого URL используйте инструкции **Website**; на отдельной вкладке **Desktop app** приведены инструкции по настройке через командную строку.

Если у вас нет доступа к этим настройкам, обратитесь к администратору Flowglad или в [поддержку](mailto:support@flowglad.com).

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

## Подключение из Claude Desktop

Посмотрите [видео по настройке Claude Desktop](https://youtu.be/6qqSnrqDJ2o) или выполните шаги ниже.

[Как подключить Flowglad к Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o)

Используйте в Claude Desktop процесс добавления пользовательского коннектора, чтобы добавить Flowglad и авторизовать доступ к своему аккаунту.

**1. Откройте форму пользовательского коннектора.**

В Claude Desktop перейдите в **Customize** → **Connectors** → **+ Add** → **Add Custom Connector**.

**2. Добавьте коннектор Flowglad.**

Введите **Flowglad** в качестве имени коннектора или выберите другое имя.

Вставьте полный URL MCP вашей организации в поле URL. Его можно скопировать в [Settings > MCP](https://dashboard.flowglad.com/settings/mcp). Он должен выглядеть так: `https://dashboard.flowglad.com/api/mcp/orgs/org_...`

Не меняйте другие настройки коннектора. Нажмите **Add**, чтобы продолжить. В некоторых версиях Claude Desktop эта кнопка может называться **Continue**.

**3. Предоставьте Claude доступ к Flowglad.**

Пройдите процесс подключения, чтобы авторизовать доступ Claude к вашему аккаунту Flowglad. При появлении запроса войдите в систему, подтвердите нужную организацию Flowglad и проверьте запрашиваемый доступ перед авторизацией.

Когда процесс завершится, вернитесь в Claude Desktop и убедитесь, что подключение Flowglad доступно. Попросите Claude проверить подключение Flowglad и вывести список доступных вам Spaces.

Предусмотренный способ подключения — OAuth Dynamic Client Registration. Не добавляйте в URL сервера пароль, токен доступа, API-ключ или client secret.

Эти инструкции описывают прямое подключение Flowglad в качестве пользовательского коннектора; доступность в каталоге — отдельный вопрос.

## Подключение другого MCP-клиента

Добавьте тот же URL организации как удалённый MCP-сервер Streamable HTTP. Пройдите процесс OAuth в клиенте с вашим аккаунтом Flowglad, затем проверьте организацию и доступные инструменты.

Поддержка зависит от клиента. Успешное подключение к серверу не означает, что клиент автоматически импортирует Skills Flowglad. Расширение для обнаружения Skills и инструмент `skills.list` — разные интерфейсы. Поддерживаемое поведение обнаружения и управления пакетами описано в разделе [Skills](/docs/ru/skills.md).

## Обработка данных

Использование MCP Flowglad регулируется [Политикой конфиденциальности Flowglad](https://www.flowglad.com/privacy-policy). Администраторы организации могут просматривать все вызовы инструментов MCP, выполненные в их организации, в [Settings > Audit](https://dashboard.flowglad.com/settings/audit).

## Устранение неполадок

| Симптом | Следующий шаг |
| - | - |
| Подключение не удаётся до входа в систему | Проверьте полный HTTPS URL и ID организации. Убедитесь, что клиент поддерживает удалённый MCP с OAuth. |
| Вход выполнен успешно, но работа недоступна | Проверьте выбранную организацию, membership в Space, выдачу MCP и доступные в Space Connections. |
| Инструмент записи недоступен или запрещён | Убедитесь в наличии необходимых разрешений организации и Space. Переподключитесь, если нужна вновь выданная область OAuth. |
| Не удаётся прочитать подключённого провайдера | Убедитесь, что его авторизация активна и Connection открыт для нужного Space. |
| Не удаётся найти Page или файл | Проверьте, что выбран правильный Space, его прямой и связанный доступ, а также что источник по-прежнему доступен. |
| Операция возвращает ID задания или запуска | Проверьте её итоговый статус жизненного цикла или запуска, прежде чем сообщать об успехе или повторять попытку. |
| Истекает время ожидания записи | Прежде чем повторять попытку, проверьте, не завершилась ли она. Некоторые операции создают новую запись или ставят работу в очередь при каждом вызове. |
| Доступ истёк или отозван | Переподключитесь через OAuth и проверьте нужную организацию и выдачу. Если переподключение по-прежнему не удаётся, обратитесь в поддержку. |

Общую информацию о безопасности см. в разделе [Security](/docs/ru/security.md) и в нашем [Trust Center](https://trust.flowglad.com). Если у вас возникли проблемы с подключением, [свяжитесь с нами](mailto:support@flowglad.com).

Обращаясь в поддержку, укажите время, клиент, затронутый инструмент, безопасный код ошибки и ID запроса, если он есть. Никогда не включайте пароли, bearer-токены, cookie, подписанные URL для загрузки/скачивания или данные клиентов.


## Related topics

- [Skills](/docs/ru/skills.md)
- [Добро пожаловать](/docs/ru/agents/introduction.md)
- [Automations](/docs/ru/automations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.