MCP-подключение

Подключение Braily к AI-клиентам через Model Context Protocol.

Braily MCP — удалённый сервер на базе Model Context Protocol. После подключения AI-клиент сможет запускать генерацию изображений в Braily прямо из чата, без ручного написания API-запросов.

API-ключ для подключения не нужен. Клиент проходит OAuth-авторизацию через браузер, а доступ и списание средств выполняются в рамках вашего аккаунта Braily.

Параметры сервера

Настройка	Значение
Транспорт	Streamable HTTP
URL	`https://mcp.braily.ru/mcp`
Аутентификация	OAuth

Для подключения понадобится аккаунт Braily и AI-клиент, поддерживающий удалённые MCP-серверы.

При первом подключении клиент откроет страницу Braily в браузере. Войдите в аккаунт и подтвердите доступ. После этого клиент сохранит OAuth-сессию и не будет запрашивать авторизацию при каждом запросе.

Если у вас несколько аккаунтов или рабочих пространств, проверьте выбранный аккаунт перед подтверждением доступа. Чтобы сменить аккаунт, отключите сервер Braily в клиенте и подключите его заново.

Подключение

Выберите AI-клиент и следуйте инструкции.

Откройте настройки ChatGPT и перейдите в раздел Apps или Connectors.
Включите Developer mode, если этот пункт доступен в вашем тарифе.
Выберите добавление пользовательского приложения или MCP-сервера.
Укажите название Braily и вставьте URL сервера:

https://mcp.braily.ru/mcp

Выберите OAuth и завершите вход в Braily в открывшемся окне.
Начните новый чат и попросите ChatGPT сгенерировать изображение.

Для Claude Code выполните команду:

claude mcp add --transport http braily https://mcp.braily.ru/mcp

При первом обращении Claude Code откроет OAuth-авторизацию в браузере. После подтверждения перезапустите сессию или обновите список MCP-серверов.

Откройте настройки Cursor, перейдите в раздел MCP и добавьте пользовательский сервер. Для конфигурации mcp.json используйте:

{
  "mcpServers": {
    "braily": {
      "url": "https://mcp.braily.ru/mcp"
    }
  }
}

Сохраните файл, перезагрузите сервер и завершите OAuth-авторизацию в браузере.

Как использовать

После подключения попросите AI-клиент сгенерировать изображение, например:

Создай изображение футуристичных белых кроссовок в студийном свете, квадратный формат.

Клиент выберет подходящий инструмент, отправит задачу в Braily и вернёт результат после завершения генерации. Для более точного результата указывайте:

содержание и стиль изображения;
формат или соотношение сторон;
желаемое разрешение;
ограничения и объекты, которых нужно избежать.

Ошибки подключения

Если сервер не подключается, проверьте:

URL сервера — https://mcp.braily.ru/mcp.
Что ваш AI-клиент поддерживает удаленные MCP-серверы и OAuth.
Что в клиенте завершена авторизация Braily.
Что у аккаунта есть доступ к нужным возможностям и баланс.

Ошибки баланса, авторизации и параметров также можно проверить в разделе Ошибки API. Общие ограничения запросов описаны в разделе Лимиты запросов.

Безопасность

Не передавайте OAuth-коды и токены в промптах, логах или скриншотах. Не публикуйте конфигурацию MCP вместе с локальным хранилищем учётных данных. Если сессия оказалась доступна другим пользователям, отзовите доступ к приложению в настройках аккаунта Braily и пройдите авторизацию заново.