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

# Quickstart

> Підключи MCP клієнт до Brama за 5 хвилин – через OAuth, без конфіг-файлів.

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

## Передумови

* **MCP клієнт з підтримкою remote OAuth** – поточні підтверджені варіанти у [таблиці нижче](#підтверджені-клієнти)
* Active subscription у одну з [інтегрованих систем](/integrations/ringostat) (наприклад 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](/connect).

## Steps

<Steps>
  <Step title="Активуй tenant + інтеграцію">
    Зайди у [`app.brama.work`](https://app.brama.work) → увійди → onboarding створює tenant.

    Далі **Integrations → Ringostat → Connect**: введи свій Ringostat Auth-key. Він зберігається зашифрованим і ізольованим per-tenant.
  </Step>

  <Step title="Додай Brama як MCP server у клієнті">
    Endpoint URL: `https://mcp.brama.work/mcp`

    Спосіб конфігурації залежить від клієнта (див. [таблицю вище](#підтверджені-клієнти)). Жодного API ключа на цьому етапі – клієнт сам пройде OAuth.
  </Step>

  <Step title="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 – кожен клієнт підключається окремо.
  </Step>

  <Step title="Verify">
    У будь-якому чаті спитай:

    > Які дзвінки в Ringostat були за сьогодні?

    Агент викличе `brama_ringostat_list_calls` і поверне реальний call log твого tenant – з recording URLs, UTM, тривалістю.

    Готово. Агент тепер бачить твої бізнес-дані через Brama.
  </Step>
</Steps>

## Доступні tools

Повний перелік + signatures – у [Ringostat integration](/integrations/ringostat). Коротко:

* `brama_ringostat_get_online_sips` – хто з SIP-акаунтів зараз онлайн
* `brama_ringostat_list_calls` – call log за період з фільтрами

## Troubleshooting

<AccordionGroup>
  <Accordion title="Couldn't reach MCP server / Connect не працює">
    Переконайся що URL точно `https://mcp.brama.work/mcp` (з суфіксом `/mcp`). MCP server вимагає OAuth 2.0 + RFC 9728 discovery – manual config-файли не підтримуються.
  </Accordion>

  <Accordion title="Gemini CLI: 'Protected resource ... does not match expected ...'">
    Стара версія brama-mcp повертала `resource` без `/mcp` суфіксу – Gemini справедливо валідує строго. Виправлено у May 2026. Якщо бачиш цю помилку сьогодні – звітуй у `viktor@brama.work`.
  </Accordion>

  <Accordion title="Tool каже '... integration not connected'">
    Інтеграція не активована для tenant. Зайди у `app.brama.work` → Integrations → обери систему ([Ringostat](/integrations/ringostat), [Google Ads](/integrations/google-ads), [Whoop](/integrations/whoop) чи [Nova Post](/integrations/novapost)) → пройди підключення.
  </Accordion>

  <Accordion title="Треба авторизуватись знову">
    MCP токени персистяться (Postgres) і **переживають redeploy сервера** – повторний OAuth при кожному оновленні Brama більше не потрібен. Re-auth знадобиться лише якщо: токен дійсно протух (30 днів), був відкликаний, або спрацював захист від повторного використання refresh-токена. Тоді просто пройди OAuth consent знову (2 кліки, якщо вже залогінений).
  </Accordion>
</AccordionGroup>

## Питання

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