Model Context Protocol (MCP) — це новий стандарт, що дозволяє AI-асистентам використовувати зовнішні інструменти. Obriym постачає MCP-сервер як тонкий третій рівень над тими самими спільними операціями, що й Public API — кожен інструмент перевіряє scope вашого токена та підписку workspace перед запуском, і ніщо не звертається до бази напряму. Спрямуйте будь-якого MCP-асистента на нього — і він працює у вашій CRM природною мовою.
Що може асистент
Читати воронку
search_leads, get_lead, search_deals, get_deal, list_orders, get_order, search_products, get_product, get_dashboard_overview, get_report.
Виконувати захищені дії
create_lead, update_lead, create_deal, create_activity, update_order_status — кожна за відповідним :write-scope вашого токена.
Підключення
Віддалений, stateless сервер Streamable HTTP — нічого не треба встановлювати.
- Endpoint
- https://obriym-crm.com/api/mcp
- Протокол
- Model Context Protocol (Streamable HTTP, stateless)
- Авторизація
- Authorization: Bearer <ваш API-токен workspace>
- Scopes
- ті самі scopes, що й REST API (products, leads, deals, orders, …)
Налаштування
- 1
Створіть API-токен
У Settings → Developers → API Tokens згенеруйте токен зі scopes, які хочете надати асистенту.
- 2
Додайте сервер у клієнт
У Claude, Cursor чи будь-якому MCP-клієнті додайте віддалений MCP-сервер із URL endpoint та заголовком Authorization: Bearer.
- 3
Працюйте природною мовою
Попросіть асистента знайти застійні ліди, підсумувати угоду чи оновити статус замовлення — він викличе відповідний інструмент.
Безпечно за задумом
- Ті самі дозволи, що й API — інструмент ніколи не виходить за межі scopes вашого токена.
- Неактивні платні workspace заблоковані, так само як в API.
- Rate-limit на кожен інструмент; жодного прямого доступу до бази — лише спільні, аудитовані операції.
- Opt-in на рівні деплою — endpoint повертає 404, доки не увімкнено.
Часті запитання
Які асистенти працюють?
Будь-який MCP-сумісний клієнт — Claude (десктоп і веб), ChatGPT, Gemini, Cursor та інші MCP-інструменти.
Це те саме, що REST API?
Він переюзує ті самі спільні операції, токен і scopes, що й Public API — MCP є третім протокольним рівнем над ними, а не новою поверхнею даних.
Чи треба щось встановлювати?
Ні. Це віддалений сервер — ви лише додаєте URL і ваш Bearer-токен у клієнт.
Нехай AI-асистент керує вашою CRM
Згенеруйте scoped-токен і підключіть Obriym до улюбленого MCP-клієнта за кілька хвилин.
Почати безкоштовно