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

# Connect a client

> Як підключити MCP клієнт до Brama – таблиця підтримуваних клієнтів з посиланнями на vendor-канонічну документацію.

Brama – **remote MCP server** з OAuth 2.0. Один endpoint, discovery + consent – без API ключів у конфіг-файлах:

```
https://mcp.brama.work/mcp
```

Auth via RFC 9728 (Protected Resource Metadata) + RFC 8414 (Auth Server Metadata) + RFC 7591 (Dynamic Client Registration). Token прив'язаний до tenant, ротується автоматично (30 днів).

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

| Клієнт                             | Статус                  | План / вимога                                   | Vendor canonical docs                                                                                                                                      |
| ---------------------------------- | ----------------------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Claude Desktop / Claude.ai web** | ✅ Verified              | Pro / Team / Enterprise                         | [Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) |
| **Gemini CLI**                     | ✅ Verified              | вільно (Gemini Code Assist)                     | [MCP Server Integration](https://www.geminicli.com/docs/tools/mcp-server)                                                                                  |
| **ChatGPT**                        | 🧪 Documented, untested | Plus / Pro / Team / Enterprise + Developer Mode | [Connect from ChatGPT – Apps SDK](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt)                                                           |

<Note>
  Статуси:

  * **Verified** – owner протестував OAuth + tool call end-to-end проти `mcp.brama.work`.
  * **Documented, untested** – vendor офіційно підтримує remote MCP з OAuth; ми ще не пройшли flow самі. Звітуй на `viktor@brama.work` якщо побачиш баг.
</Note>

Не бачиш свій клієнт? Якщо він підтримує RFC 9728 (Protected Resource Metadata) – мав би просто працювати з endpoint'ом вище. Напиши на `viktor@brama.work` для додавання у таблицю після verification.

## Per-client швидкі підказки

### Claude Desktop / Claude.ai web

**Settings → Connectors → Add Custom Connector** з URL `https://mcp.brama.work/mcp`. Натисни **Connect** → пройдеш OAuth consent → готово.

Деталі та edge-cases (re-auth, Claude.ai web vs desktop, OAuth Client ID/Secret для self-hosted): див. [Anthropic canonical docs](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

### Gemini CLI

У `~/.gemini/settings.json` додай:

```json theme={null}
{
  "mcpServers": {
    "brama": {
      "httpUrl": "https://mcp.brama.work/mcp",
      "timeout": 5000
    }
  }
}
```

Потім у CLI: `/mcp auth brama` → відкриє браузер → consent → готово. `/mcp` покаже тули.

Більше про config + scopes: [geminicli.com – MCP Server Integration](https://www.geminicli.com/docs/tools/mcp-server).

<Warning>
  Якщо побачиш `Protected resource ... does not match expected ...` – стара версія brama-mcp повертала `resource` без `/mcp` суфіксу; виправлено у May 2026 (brama-mcp PR #19). У актуальної версії має працювати; інакше report на `viktor@brama.work`.
</Warning>

### ChatGPT (Plus / Pro / Team / Enterprise)

1. **Settings → Apps & Connectors → Advanced settings → Developer Mode → ON**.
2. **Add new connector** → URL `https://mcp.brama.work/mcp`.
3. Пройди OAuth consent.

Перейти на [Connect from ChatGPT – Apps SDK](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt) для повного flow. Не підтверджено owner'ом end-to-end проти Brama – якщо щось не так, [report](mailto:viktor@brama.work).

## Що дальше

Після підключення спитай агента: «які доступні brama тули?» – він викличе discovery + покаже список з твоїх активних інтеграцій (Ringostat, Google Ads, Google Analytics, Search Console, Merchant Center, Whoop, Oura, Nova Post, Telegram – [повний перелік](/introduction#status)).