Перейти к содержимому

Документация · Коннектор 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, владельца рабочей области, или администратора, которому владелец разрешил управление интеграциями. Все остальные увидят, что они не могут подключить приложение, и смогут попросить доступ у владельца.

  1. Добавьте коннектор в Claude

    Откройте «Параметры» → «Коннекторы» → «Добавить коннектор», вставьте адрес сервера ниже и сохраните.

    https://bayanflow.tech/api/v1/mcp
  2. Нажмите "Подключить"

    Страница Bayan Flow откроется в вашем браузере. Если потребуется, войдите в систему.

  3. Выберите рабочее пространство и разрешения

    Выберите рабочее пространство, отметьте, что может делать 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. В корпоративной рабочей области администратор может потребовать предварительное разрешение.

  1. В настройках ChatGPT включите режим разработчика (найдите в разделе «Connectors» или «Security»).
  2. Создайте новый коннектор (или приложение): вставьте адрес сервера и выберите OAuth в качестве аутентификации. Идентификатор клиента и секрет не требуются, так как ChatGPT регистрируется автоматически.
  3. Нажмите "Подключить". Откроется страница 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 КБ.

Готовы подключиться?

Создайте рабочее пространство или войдите, затем выполните три шага выше.

MCP-коннектор для Claude, ChatGPT и приложений с ИИ · Bayan Flow