Telegrin можна підключити до ваших інструментів двома шляхами:

• MCP-сервер - для AI-асистентів (Claude, ChatGPT, Cursor): асистент отримує прямий доступ до стрічки, кампаній і воронки - задачі вирішуються прямо в чаті.
• Публічний API - для власних інтеграцій і скриптів: ті самі можливості через REST-запити.

MCP-сервер - це дзеркало публічного API один до одного: все, що вміє API (близько 90 операцій), доступне й асистенту через MCP.

MCP: підключення за 2 хвилини

1. Відкрийте розділ MCP у навігації застосунку.
2. Оберіть вкладку вашого клієнта - Claude Code, Claude Desktop або Cursor - і скопіюйте готовий сніпет кнопкою копіювання:
   • Claude Code - одна команда в терміналі, сервер додається сам;
   • Claude Desktop - вставка в claude_desktop_config.json (Settings → Developer → Edit Config);
   • Cursor - вставка у файл ~/.cursor/mcp.json і перезапуск.
3. Адреса сервера (вже всередині сніпетів): https://mcp-tg.grinfi.io/mcp.
4. При першому підключенні відкриється вікно авторизації - увійдіть зі своїм акаунтом Telegrin. Окремий ключ для MCP не потрібен.

Що вміє асистент через MCP

• читає стрічку і схвалює сигнали прямо з чату;
• керує кампаніями - запуск, пауза, ключові слова;
• показує баланс кредитів і ліміти;
• рухає лідів стадіями воронки;
• віддає статистику моніторингу й метрики.

Приклади запитів асистенту: «покажи нові сигнали за сьогодні й схвали релевантні», «постав кампанію Х на паузу», «скільки кредитів залишилось і на що витратились останні».

Публічний API: ключі й доступ

1. Відкрийте Налаштування → API-ключі.
2. Натисніть «Створити ключ», дайте йому назву.
3. Скопіюйте ключ одразу - він показується лише один раз.
4. Передавайте ключ у заголовку Authorization: Bearer <ключ>.

⚠️ Важливо: ключ дає програмний доступ до всього воркспейса, тому створювати й відкликати ключі може лише адмін воркспейса. Компрометований ключ відкличте на тому ж екрані - це миттєво.

Що покриває API

Групи операцій (ті самі доступні через MCP):

• Кампанії - список, створення, редагування, запуск/пауза, доставщики кампанії.
• Сигнали і ліди - стрічка, схвалення/відхилення, картки лідів, стадії воронки.
• Агенти - список агентів і шаблони.
• AI-ядра - читання й оновлення ядер.
• Відстежувані пости - підключення й архівація постів.
• Аналітика - метрики дашборда, воронка моніторингу.
• Білінг - баланс кредитів і ліміти (без оплат - покупки лише в застосунку).
• Блок-лист - додавання й видалення записів.
• Вебхуки - керування ендпоінтами доставки (деталі - стаття «Вебхук-доставка лідів у вашу CRM»).
• Сканування історії, воркспейс, пошук чатів - службові операції.

На яких тарифах доступно

API і MCP доступні на всіх тарифах - і на тріалі, і на платних (Starter, Growth і Scale). Ключі створює адміністратор воркспейса в Налаштування → API-ключі.

Пов'язані статті

«Вебхук-доставка лідів у вашу CRM» · «Кілька каналів доставки лідів і їхній порядок» · «План і ліміти»