MCP-сервер і публічний API
Telegrin можна підключити до власних інструментів двома способами: через публічний REST API або через MCP-сервер для
AI-асистентів (наприклад, Claude). Обидва способи працюють з тими самими даними, що й застосунок: кампанії, сигнали,
ліди, CRM, статистика.
Де знайти налаштування
У застосунку відкрийте Робочий простір → вкладка API. Тут створюються API-ключі та знаходиться блок Підключити до Claude
(MCP).
Публічний REST API
API дає програмний доступ до робочого простору: читання сигналів і лідів, керування кампаніями, CRM-стадії, статистика
тощо.
1. На вкладці API натисніть Створити ключ. Вкажіть назву і рівень доступу: Лише читання або Читання та запис.
2. Скопіюйте ключ одразу - після закриття вікна він більше не відображатиметься.
3. Надсилайте ключ у заголовку Authorization: Bearer у кожному запиті.
4. Базова адреса: https://tg.grinfi.io/api/v1/ext
Повний перелік методів з прикладами - в інтерактивній документації: https://tg.grinfi.io/api/v1/ext/reference (посилання
Повна документація API є й на вкладці).
⚠️ Важливо: API-ключ відкриває доступ до даних робочого простору. Зберігайте його як пароль, не публікуйте в коді та
відкликайте ключі, якими більше не користуєтеся.
MCP-сервер: керуйте Telegrin у чаті з Claude
MCP (Model Context Protocol) дозволяє AI-асистенту працювати з Telegrin від вашого імені: переглянути нові сигнали,
схвалити відповідь, створити кампанію, вивантажити лідів - звичайним текстом у чаті.
Як підключити (потрібні права адміністратора робочого простору):
1. Скопіюйте адресу MCP-сервера на вкладці API: https://mcp-tg.grinfi.io/mcp
2. У Claude відкрийте Settings → Connectors → Add custom connector, вставте адресу і натисніть Connect.
3. У вікні, що відкриється, увійдіть у свій акаунт Telegrin.
Після підключення Claude бачить ваші кампанії, сигнали і лідів - а перед кожною важливою дією (надсилання відповіді,
видалення) запитує підтвердження.
Що обрати
- Потрібна інтеграція з вашою CRM, скриптами чи звітами - використовуйте REST API.
- Хочете керувати Telegrin розмовою, без коду - підключіть MCP до Claude.
Обидва способи можна використовувати одночасно.