Документация · Коннектор MCP
Подключите свои приложения с ИИ к базе знаний Bayan Flow
Ищите в базе знаний компании, создавайте и обновляйте документы, а также управляйте рабочим пространством из Claude, ChatGPT или любого приложения MCP. Вы входите через аккаунт Bayan Flow, выбираете, что может делать приложение, и остаётесь в контроле.
- OAuth 2.0 с PKCE
- Удаленный MCP · Потоковый HTTP
- Одобрение владельца для рискованных изменений
Адрес сервера
https://bayanflow.tech/api/v1/mcpВставьте этот адрес в своё приложение AI как пользовательский соединитель MCP. Больше ничего копировать не нужно.
Что AI приложения могут делать с Bayan Flow
Bayan Flow превращает собственные документы компании в точные ответы для её команды поддержки. Этот MCP коннектор позволяет AI приложениям, таким как Claude и ChatGPT, работать с выбранными вами базами знаний и рабочим пространством, исключительно с вашего разрешения.
Ответы из ваших собственных документов
Приложение ищет в разрешённых базах знаний и читает отрывки, поэтому его ответы основаны на вашей политике и информации о продукте, а не на предположениях.
Держите базу знаний в актуальном состоянии
Создавайте базы знаний и документы, сохраняйте изменения как новые версии. Ничего при этом никогда не удаляется.
Понять своё рабочее пространство
Смотрите участников (с скрытой электронной почтой), команды, использование и журнал активности. Секреты и данные платежей никогда не показываются.
Приложение предлагает, вы решаете
Приложение может предложить добавить или удалить участников, изменить роли, отредактировать настройки или удалить знания. Каждое предложение ждёт одобрения владельца рабочего пространства, который подтверждает его в Bayan Flow с помощью своего пароля.
Что можно спросить у вашего приложения AI
- Найдите в базе знаний Bayan Flow нашу политику возврата и кратко резюмируйте её в три пункта.
- Какие документы упоминают сроки доставки? Перечислите их с указанием базы знаний, в которой они находятся.
- Создайте в базе Help Center документ «Returns checklist» с этапами, которые мы согласовали.
- Показать использование за этот месяц и последние десять записей журнала активности.
- Предложить удаление уехавшего сотрудника. Я одобрю это в Bayan Flow.
Подключите Claude в три шага
Это для Claude.ai и Claude Desktop. Нет ключа для копирования: вы входите в Bayan Flow и подтверждаете подключение.
Вам нужна учётная запись Bayan Flow, владельца рабочей области, или администратора, которому владелец разрешил управление интеграциями. Все остальные увидят, что они не могут подключить приложение, и смогут попросить доступ у владельца.
Добавьте коннектор в Claude
Откройте «Параметры» → «Коннекторы» → «Добавить коннектор», вставьте адрес сервера ниже и сохраните.
https://bayanflow.tech/api/v1/mcpНажмите "Подключить"
Страница Bayan Flow откроется в вашем браузере. Если потребуется, войдите в систему.
Выберите рабочее пространство и разрешения
Выберите рабочее пространство, отметьте, что может делать Claude, и нажмите «Разрешить». Любые действия сверх чтения потребуют вашего пароля, после чего вы автоматически вернётесь в Claude.
Начните новый чат и напишите: «Найди в моей базе знаний Bayan Flow политику возврата.»
Claude Code
Добавьте сервер, затем выполните команду /mcp в Claude Code и выберите Authenticate. Откроется страница подтверждения.
claude mcp add --transport http bayan-flow https://bayanflow.tech/api/v1/mcpКлиенты, которые не могут открыть страницу входа
Для Cursor, VS Code или скрипта создайте MCP-ключ в Integrations → MCP и отправьте его как bearer-токен. Храните его в переменной окружения, никогда в общем файле.
Authorization: Bearer $BAYAN_MCP_KEYЧтобы отключиться, откройте Интеграции → MCP в Bayan Flow и отозвите доступ. Приложение потеряет доступ немедленно.
ChatGPT и другие приложения AI
Любое приложение, поддерживающее удалённые MCP-серверы через HTTPS, может подключиться. Приложения с входом через OAuth используют тот же однозвённый процесс, что и Claude. Названия меню отличаются в разных приложениях и меняются со временем: ищите «custom connector», «developer mode» или «add MCP server».
ChatGPT
Доступно в платных планах ChatGPT, которые поддерживают пользовательские соединители MCP. В корпоративной рабочей области администратор может потребовать предварительное разрешение.
- В настройках ChatGPT включите режим разработчика (найдите в разделе «Connectors» или «Security»).
- Создайте новый коннектор (или приложение): вставьте адрес сервера и выберите OAuth в качестве аутентификации. Идентификатор клиента и секрет не требуются, так как ChatGPT регистрируется автоматически.
- Нажмите "Подключить". Откроется страница Bayan Flow: выберите рабочее пространство и разрешения, затем нажмите "Разрешить".
https://bayanflow.tech/api/v1/mcpДругие приложения с OAuth
Вставьте адрес сервера и оставьте аутентификацию на OAuth или автоматической. Приложение зарегистрируется и перенаправит вас на страницу подтверждения Bayan Flow.
Приложения, работающие только с локальными серверами
Используйте помощник mcp-remote (требует Node.js), который преобразует удалённый сервер в локальный. Готовые примеры кода в Integrations → MCP.
Приложения, использующие ключ
Cursor, VS Code, Windsurf, Gemini CLI, Codex CLI и аналогичные инструменты поддерживают пользовательский заголовок. Создайте MCP ключ в разделе «Интеграции» → MCP и сохраните его в переменную окружения. Названия параметров немного отличаются между приложениями, но важны адрес и заголовок.
{
"mcpServers": {
"bayan-flow": {
"url": "https://bayanflow.tech/api/v1/mcp",
"headers": { "Authorization": "Bearer ${BAYAN_MCP_KEY}" }
}
}
}На странице одобрения отображаются название приложения и адрес, на который оно вернётся. Приложения от Anthropic и OpenAI отмечены как проверенные; для любого другого приложения проверьте адрес перед разрешением.
Инструменты
25 инструментов, все перечислены ниже. Каждый имеет название и отмечен как доступный только для чтения или нет, чтобы приложение и его пользователи могли понять, что делает инструмент перед его запуском.
ЧтениеИнструменты только для просмотра
Ничего не изменяется и кредиты не расходуются.
knowledge_list_basesknowledge:readПеречисляет базы знаний, которые может читать этот ключ, с уровнем доступа и количеством документов.
knowledge_searchknowledge:readИщет в вашей базе знаний и возвращает лучшие отрывки с их источниками. Только поиск: без AI-текста, без кредитов.
knowledge_list_documentsknowledge:readВыводит список документов одной базы знаний.
knowledge_get_documentknowledge:readЧитает текст одного документа страница за страницей.
workspace_getworkspace:readНазвание рабочего пространства, языки, план и использование мест.
workspace_list_membersworkspace:readУчастники с их ролью и статусом. Адреса электронной почты скрыты.
workspace_list_teamsworkspace:readКоманды и количество участников в каждой.
workspace_usageworkspace:readИтоги запросов, кредитов и активности за недавние дни.
workspace_audit_logworkspace:readНедавние записи журнала активности: кто что сделал, никогда не содержимое.
workspace_list_pending_actionsworkspace:readПредложенные изменения ключей и их результаты.
store_order_statusworkspace:readСтатус одного заказа подключённого магазина: доставка, отслеживание, товары, сумма. Никогда данные клиента.
ЗаписьИнструменты для записи в базу знаний
Они создают или редактируют знания. Правки сохраняются как новые версии, ничего не удаляется.
knowledge_create_baseknowledge:writeСоздаёт общую базу знаний компании. Не подходит для ключей, ограниченных выбранными базами.
knowledge_create_documentknowledge:writeДобавляет новый документ в базу знаний. Индексируется в фоне.
knowledge_update_documentknowledge:writeСохраняет новый текст как новую версию. Старые версии хранятся, ничего не удаляется.
Требует одобренияИнструменты, предлагающие изменения
Они никогда не вносят изменения сами. Они создают предложение, которое владелец рабочего пространства утверждает или отклоняет в Bayan Flow.
knowledge_delete_documentworkspace:adminПредлагает удалить документ. Ничего не удаляется до утверждения владельцем.
knowledge_archive_baseworkspace:adminПредлагает архивировать базу знаний, чтобы она перестала выдавать ответы.
member_inviteworkspace:adminПредлагает пригласить человека по адресу электронной почты. Отправляется только после одобрения.
member_change_roleworkspace:adminПредлагает изменить роль участника на администратора или участника. Никогда владельца.
member_disableworkspace:adminПредлагает отключить члена: они теряют доступ и место освобождается.
member_removeworkspace:adminПредлагает удалить участника из рабочего пространства.
team_createworkspace:adminПредлагает создать команду.
team_updateworkspace:adminПредлагает переименовать команду или изменить её описание.
team_deleteworkspace:adminПредлагает удалить команду.
team_set_membersworkspace:adminПредлагает заменить список членов команды.
workspace_update_settingsworkspace:adminПредлагает изменить название, языки или права администраторов. Никогда — интеграции или биллинг.
Приложение видит только инструменты, к которым вам разрешён доступ. Если инструмент не отображается, подключитесь снова и отметьте дополнительные разрешения.
Разрешения
Вы выбираете их на странице подтверждения. Подключение никогда не может делать больше, чем вы отметили, и вы можете его отозвать в любой момент.
Читать базу знаний
knowledge:readПоиск и чтение баз знаний, которые может использовать ключ. Ничего не изменяется и кредиты не расходуются.
Одного клика, чтобы разрешить.
Написать знания
knowledge:writeСоздавать базы знаний и документы, сохранять правки как новые версии. Ничего не удаляет.
Требует вашего пароля.
Читать рабочее пространство
workspace:readПросмотр членов (имена, роли, замаскированный e-mail), команд, использования и журнала действий. Никаких секретов и платёжных данных.
Одного клика, чтобы разрешить.
Предложить изменения рабочего пространства
workspace:adminПредлагать изменения участникам, командам, настройкам и удалениям информации. Каждое ждёт одобрения владельца.
Только владельцы рабочего пространства, требует вашего пароля, и каждое изменение нуждается в одобрении владельца.
Безопасность и конфиденциальность
Коннектор разработан так, чтобы ошибка, утёкший токен или некорректно работающий ассистент имели минимальное влияние.
Вход под вашим контролем
Код авторизации OAuth 2.0 с PKCE. Приложение никогда не видит ваш пароль, а Bayan Flow никогда не видит учётные данные приложения. Страница утверждения показывает имя приложения и адрес, на который оно вернётся.
Только то, что вы разрешите
Подключение ограничено одним рабочим пространством и выбранными вами разрешениями. Лицо, утвердившее подключение, должно всё ещё управлять интеграциями, иначе подключение прекращается.
Подтверждение владельца
Опасные изменения — это только предложения. Владелец одобряет их с помощью своего пароля; 5 неправильных попыток блокируют одобрение на 15 минут, и предложение, по которому никто не принял решение, истекает через 24 часов.
Кратковременный доступ
Токены доступа действуют один час и обновляются автоматически. Если токен обновления используется дважды, всё соединение отменяется.
Отозвать в любой момент
Отозвите подключение в разделе «Интеграции» → MCP или из приложения. Ожидающие предложения отклоняются и доступ прекращается немедленно.
Журнал аудита
Bayan Flow записывает, какой инструмент был вызван и как это завершилось, но никогда не записывает содержание. Владельцы рабочего пространства также получают письмо при установлении соединения.
Ваши данные
Отрывки, которые запрашивает приложение, отправляются поставщику этого приложения и обрабатываются в соответствии с условиями вашего плана с ним. Подключайте только помощников, которым ваша компания доверяет работать с ними. Текст из ваших документов помечается как данные, а не инструкции, чтобы предотвратить атаки через промпт-инъекции. Bayan Flow видит вызовы инструментов, которые делает приложение, но не вашу беседу с ним.
Никогда невозможно через MCP, независимо от ваших разрешений
- Удаление рабочего пространства
- Передача собственности или смена владельца
- Пароли, сеансы, двухфакторная аутентификация и вход
- Создание, список или отзыв ключей API
- Включение или отключение интеграций, или выбор того, кто их контролирует
- Планы, места, способы оплаты, счета и возвраты
- Экспорт личных данных
- Всё на уровне платформы Bayan Flow
- Что-либо в другом рабочем пространстве
Прочитайте нашу Политика конфиденциальности · Условия использования
Решение проблем
Кнопка «Разрешить» неактивна
Сначала выберите рабочее пространство. Если их несколько, ни одно не выбирается автоматически. Строка над кнопкой указывает, что не хватает.
На странице подтверждения не отображается ни одного рабочего пространства
Подключать приложения могут только владельцы рабочего пространства и администраторы, которым владелец разрешил управлять интеграциями. Попросите владельца подключить приложение или дать вам это разрешение.
На странице указано, что интеграция отключена
Bayan Flow отключил MCP для этого рабочего пространства. Свяжитесь с поддержкой со страницы контактов.
Приложение сообщает, что соединение истекло или требуется повторная аутентификация
Соединения продлеваются автоматически при использовании. По истечении года или если соединение было отозвано, нажмите «Подключить» в приложении.
Почему потребовался мой пароль?
Любые действия сверх чтения требуют вашего пароля, как и создание ключа API. Если вы входите только через Google, сначала установите пароль в разделе Параметры → Безопасность.
Ожидаемый инструмент не найден
Приложение видит только те инструменты, к которым разрешает доступ ваша роль. Подключитесь заново и отметьте больше разрешений.
Приложение сообщает о слишком большом количестве запросов
Каждое соединение позволяет 120 вызовов инструментов и 30 записей в минуту. Подождите немного и попробуйте снова.
Рабочая область уже имеет максимальное количество подключений
Рабочая область может иметь до пяти подключений MCP одновременно. Отозвите неиспользуемые в Интеграции → MCP.
Остались вопросы? Напишите нам из страница контактов
Техническая документация
Для разработчиков и рецензентов, проверяющих подключение.
- Адрес сервера
- https://bayanflow.tech/api/v1/mcp
- Транспорт
- Потоковый HTTP, без состояния: только POST, без сессий и потоков событий.
- Версии протокола MCP
- 2025-11-25, 2025-06-18, 2025-03-26
- Авторизация
- OAuth 2.0 с кодом авторизации и PKCE (S256), публичные клиенты, динамическая регистрация клиентов (RFC 7591), обнаружение по RFC 9728 и RFC 8414.
- Метаданные защищённого ресурса
- https://bayanflow.tech/.well-known/oauth-protected-resource/api/v1/mcp
- Метаданные сервера авторизации
- https://bayanflow.tech/.well-known/oauth-authorization-server
- Точка авторизации
- https://bayanflow.tech/oauth/authorize
- Endpoint токена
- https://bayanflow.tech/api/oauth/token
- Регистрация клиента
- https://bayanflow.tech/api/oauth/register
- Endpoint отзыва
- https://bayanflow.tech/api/oauth/revoke
- Токены
- Токен доступа действует один час. Токен обновления ротируется при каждом использовании: 60 дней с момента последнего использования, максимум один год. Предыдущий токен обновления становится недействительным.
- Области доступа
- knowledge:read, knowledge:write, workspace:read, workspace:admin
- Ограничения
- На соединение: 120 вызовов инструментов и 30 записей в минуту. Один ответ обрезается на 100 КБ.
Готовы подключиться?
Создайте рабочее пространство или войдите, затем выполните три шага выше.

