> ## 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.

# Introduction

> Why Brama exists and who it's for.

## Хто це

**ICP:** UA SMB (5-50 employees), що вже використовує одну з інтегрованих систем (наприклад Ringostat call tracking або Google Ads) і хоче дати AI-агенту доступ до своїх даних поверх цих систем.

**Buyer:** операційний директор / власник.

**Pain:** дані живуть у silo'ах, LLM-агенти не мають доступу. Custom Python інтеграції – крихкі, не підтримуються. No-code (n8n/Zapier) – не дають LLM-tool semantics + audit trail + multi-tenant isolation.

## Що Brama робить

1. **OAuth proxy** – твій агент підключається до `mcp.brama.work/mcp` (Custom Connector, OAuth 2.0)
2. **Tenant resolution** – Brama резолвить tenant з access token, бере vendor-креди (зашифровані, ключі поза базою)
3. **Vendor call** – ходить у vendor API від імені tenant'а
4. **Result normalization** – повертає structured response у LLM-friendly форматі
5. **Audit** – запис в audit log: tool, tenant, hashed params, status

## Що Brama НЕ робить

* ❌ Не клонує vendor native MCP. Якщо у Ringostat є офіційний MCP – використовуй той, не Brama.
* ❌ Не custom one-off integrations. Кожна нова integration = generic vendor-клієнт + MCP tool surface.
* ❌ Не no-code automation builder. Це не Zapier alternative.

## Безпека та ізоляція

* **Один endpoint, OAuth 2.0** – агент підключається до `mcp.brama.work/mcp`; токен прив'язаний до одного tenant'а.
* **Per-tenant ізоляція** – дані одного tenant'а недосяжні іншому на рівні сховища.
* **Креди зашифровані at rest** – ключі шифрування поза базою; на диск не пишуться, тримаються в пам'яті лише на час запиту; у логи не потрапляють.
* **Audit-first** – кожен tool call фіксується (tenant, tool, hashed params, status); сирі параметри й креди не логуються.
* **Read-only** – поточні tools нічого не змінюють у твоїх системах.

## Status

**Поточна стадія:** live (self-serve).

* ✅ **[Ringostat](/integrations/ringostat)** – call tracking: останні дзвінки, онлайн-оператори, AI-summary дзвінків.
* ✅ **[Google Ads](/integrations/google-ads)** – ефективність реклами: read-only GAQL-звіти по кампаніях і витратах.
* ✅ **[Google Analytics (GA4)](/integrations/google-analytics)** – трафік сайту: користувачі, сесії, топ-сторінки, канали та realtime-активність.
* ✅ **[Google Search Console](/integrations/google-search-console)** – пошукова ефективність: топ-запити, сторінки, кліки, покази й позиція для верифікованих сайтів.
* ✅ **[Google Merchant Center](/integrations/google-merchant-center)** – здоров'я фіду: статуси лістингів і причини відхилень + керування продуктами, інвентарем, промо й доставкою.
* ✅ **[Whoop](/integrations/whoop)** – recovery, сон, тренування та цикли.
* ✅ **[Oura](/integrations/oura)** – readiness, сон, активність і heart-rate.
* ✅ **[Nova Post](/integrations/novapost)** – трекінг відправлень за номером ТТН (Україна).
* ✅ **[OLX.ua](/integrations/olx)** – оголошення: перегляд, статистика, публікація й (де)активація через крок підтвердження.
* ✅ **[Telegram](/integrations/telegram)** – читання історії повідомлень і надсилання відповідей від твого підключеного бота.
* ✅ **[Monobank Personal](/integrations/monobank-personal)** – рахунки, виписки та курси валют для персонального/ФОП рахунку, нуль зберігання транзакцій.
* 🔜 Нові інтеграції – за demand signal