Model Context Protocol (MCP) — це новий стандарт, що дозволяє AI-асистентам використовувати зовнішні інструменти. Obriym постачає MCP-сервер як тонкий третій рівень над тими самими спільними операціями, що й Public API — кожен інструмент перевіряє scope вашого токена та підписку workspace перед запуском, і ніщо не звертається до бази напряму. Спрямуйте будь-якого MCP-асистента на нього — і він працює у вашій CRM природною мовою.
Що може асистент
Читати весь CRM
search_leads, get_lead, search_contacts, get_contact, search_companies, get_company, search_deals, get_deal, list_activities, get_activity, list_customers, get_customer, list_orders, get_order, search_products, get_product, get_dashboard_overview, get_report, get_workspace_info, list_workspaces.
Виконувати захищені дії
convert_lead, assign_lead, transition_deal, create_order з позиціями, створення/оновлення лідів, контактів, компаній і угод, створення й завершення активностей, зміна статусу замовлення — кожна за відповідним :write-scope вашого токена.
Бачити й налаштовувати конфігурацію
list_pipeline_stages, list_lead_sources, configure_pipeline і set_lead_sources — асистент читає конфігурацію workspace і може змінити стадію воронки чи джерело лідів.
Підключення
Віддалений, stateless сервер Streamable HTTP — нічого не треба встановлювати.
- Endpoint
- https://obriym-crm.com/api/mcp
- Протокол
- Model Context Protocol (Streamable HTTP, stateless)
- Авторизація
- OAuth 2.1 вхід в один клік або Authorization: Bearer <ваш API-токен workspace>
- Scopes
- ті самі scopes, що й REST API (products, leads, deals, orders, …)
Підключіть свій AI-асистент
Додайте MCP-сервер у ваш AI-клієнт. Cursor і VS Code — в один клік; для решти візьміть URL вище та увійдіть через OAuth.
URL MCP-сервера
https://obriym-crm.com/api/mcpВхід через акаунт Obriym CRM — без токена й без створення застосунку.
Cursor
Додати в CursorVS Code
Додати в VS CodeClaude Code
claude mcp add --transport http obriym-crm https://obriym-crm.com/api/mcpВиконайте в терміналі, потім /mcp для входу.
ChatGPT
Вручну- 1Settings → Connectors → Add custom connector (Developer Mode).
- 2Вставте URL MCP-сервера вище та оберіть OAuth.
- 3Увійдіть акаунтом Obriym CRM.
Claude (веб і десктоп)
Вручну- 1Settings → Connectors → Add custom connector.
- 2Вставте URL MCP-сервера вище.
- 3Увійдіть акаунтом Obriym CRM.
Налаштування
- 1
Увійдіть або створіть API-токен
Для особистого AI-клієнта оберіть OAuth: Obriym покаже активну CRM-сесію, імʼя та email перед підтвердженням. Для серверної автоматизації створіть scoped Bearer-токен.
- 2
Додайте сервер у клієнт
Додайте URL сервера. При OAuth підтвердьте показаний акаунт або натисніть «Використати інший акаунт»; з Bearer передайте токен у заголовку Authorization.
- 3
Працюйте природною мовою
Попросіть асистента знайти застійні ліди, підсумувати угоду чи оновити статус замовлення — він викличе відповідний інструмент.
Безпечно за задумом
- Платна per-workspace можливість — MCP потребує тарифу Team або Scale. OAuth використовує активну CRM-сесію, але завжди показує імʼя й email та вимагає явного підтвердження нового AI-клієнта.
- Кілька workspace — явно, без сюрпризів: до вибору всі CRM-дані заблоковані; get_workspace_info показує підключений акаунт і простір, list_workspaces перелічує доступні, а select_workspace перемикає лише за вашим проханням.
- Відкликання доступу в Центрі інтеграцій видаляє access token, refresh token, OAuth-згоду та привʼязку до workspace — повторне підключення знову потребує підтвердження.
- Ті самі дозволи, що й API — інструмент ніколи не виходить за межі scopes вашого токена.
- Неактивні платні workspace заблоковані, так само як в API.
- Rate-limit на кожен інструмент; жодного прямого доступу до бази — лише спільні, аудитовані операції.
- Opt-in на рівні деплою — endpoint повертає 404, доки не увімкнено.
Часті запитання
Які асистенти працюють?
Будь-який MCP-сумісний клієнт — Claude (десктоп і веб), ChatGPT, Gemini, Cursor та інші MCP-інструменти.
Це те саме, що REST API?
Він переюзує ті самі спільні операції, токен і scopes, що й Public API — MCP є третім протокольним рівнем над ними, а не новою поверхнею даних.
Чи треба щось встановлювати?
Ні. Додайте URL і увійдіть через OAuth — перед дозволом Obriym покаже активний акаунт і дасть перейти на інший. Bearer-токен лишається альтернативою для машинних клієнтів.
У мене кілька workspace — куди асистент пише дані?
Рівно в один. Якщо доступно кілька просторів, зʼєднання стартує заблокованим і асистент має запитати ваш вибір до будь-якого читання даних. get_workspace_info показує також імʼя та email підключеного акаунта; list_workspaces і select_workspace дозволяють перевірити або змінити простір.
Нехай AI-асистент керує вашою CRM
MCP входить у тарифи Team і Scale. Оберіть тариф, згенеруйте scoped-токен і підключіть Obriym до улюбленого MCP-клієнта за кілька хвилин.
Переглянути тарифи