Skip to main content
Brama – self-serve: зареєструйся на brama.work і підключи інтеграції в адмінці. Питання – viktor@brama.work.

​
Передумови

  • MCP клієнт з підтримкою remote OAuth – поточні підтверджені варіанти у таблиці нижче
  • Active subscription у одну з інтегрованих систем (наприклад Ringostat)
  • Tenant акаунт у Brama (зареєструйся на brama.work – self-serve)

​
Як це працює

Brama – remote MCP server з OAuth 2.0. Жодних API ключів у конфіг-файлах: клієнт сам виконує discovery + OAuth consent flow, токен прив’язаний до твого tenant і ротується автоматично.

​
Підтримувані клієнти

Стислий перелік: Claude Desktop / Claude.ai web ✅, Gemini CLI ✅, ChatGPT (Plus/Pro/Team/Enterprise + Developer Mode – vendor підтверджує підтримку, але самі не верифікували). Повна таблиця з статусом verification + посиланнями на vendor-канонічну документацію та per-client швидкими підказками – у Connect a client.

​
Steps

1

Активуй tenant + інтеграцію

Зайди у app.brama.work → увійди → onboarding створює tenant.Далі Integrations → Ringostat → Connect: введи свій Ringostat Auth-key. Він зберігається зашифрованим і ізольованим per-tenant.
2

Додай Brama як MCP server у клієнті

Endpoint URL: https://mcp.brama.work/mcpСпосіб конфігурації залежить від клієнта (див. таблицю вище). Жодного API ключа на цьому етапі – клієнт сам пройде OAuth.
3

Authorize (OAuth consent)

Запусти OAuth з клієнта (Claude Desktop: натисни Connect у діалозі Connector; Gemini CLI: /mcp auth brama).Браузер відкриє consent-сторінку Brama: “Allow Brama on behalf of {your tenant}”. Якщо не залогінений – пройдеш login на app.brama.work і повернешся на consent автоматично. Натисни Allow access.Клієнт отримає тривалий MCP token (30 днів, rotates automatically). Токен прив’язаний до цього tenant – кожен клієнт підключається окремо.
4

Verify

У будь-якому чаті спитай:
Які дзвінки в Ringostat були за сьогодні?
Агент викличе brama_ringostat_list_calls і поверне реальний call log твого tenant – з recording URLs, UTM, тривалістю.Готово. Агент тепер бачить твої бізнес-дані через Brama.

​
Доступні tools

Повний перелік + signatures – у Ringostat integration. Коротко:
  • brama_ringostat_get_online_sips – хто з SIP-акаунтів зараз онлайн
  • brama_ringostat_list_calls – call log за період з фільтрами

​
Troubleshooting

Переконайся що URL точно https://mcp.brama.work/mcp (з суфіксом /mcp). MCP server вимагає OAuth 2.0 + RFC 9728 discovery – manual config-файли не підтримуються.
Стара версія brama-mcp повертала resource без /mcp суфіксу – Gemini справедливо валідує строго. Виправлено у May 2026. Якщо бачиш цю помилку сьогодні – звітуй у viktor@brama.work.
Інтеграція не активована для tenant. Зайди у app.brama.work → Integrations → обери систему (Ringostat, Google Ads, Whoop чи Nova Post) → пройди підключення.
MCP токени персистяться (Postgres) і переживають redeploy сервера – повторний OAuth при кожному оновленні Brama більше не потрібен. Re-auth знадобиться лише якщо: токен дійсно протух (30 днів), був відкликаний, або спрацював захист від повторного використання refresh-токена. Тоді просто пройди OAuth consent знову (2 кліки, якщо вже залогінений).

​
Питання

Натрапив на проблему? Напиши viktor@brama.work.