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

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

MCP-сервер працює через той самий публічний API, тому асистенту доступні ті самі можливості.

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

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

Claude у браузері (claude.ai)

У claude.ai Telegrin підключається як власний конектор (custom connector): додайте конектор з адресою https://mcp-tg.grinfi.io/mcp і увійдіть своїм акаунтом Telegrin. Такий конектор потрібен, наприклад, завданню Claude, яке саме розбирає нових лідів, - покроково в статті «Telegrin → Claude: завдання Claude саме розбирає нових лідів».

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

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

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

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

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

Адреса API: https://tg.grinfi.io/api/v1/ext. Опис усіх операцій: tg.grinfi.io/api/v1/ext/reference.

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

💡 Порада: якщо інтеграції потрібно лише читати дані (наприклад, вивантажувати лідів у звіт), видайте їй ключ із правами Лише читання.

Що покриває API

Ті самі групи операцій доступні і через MCP:

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

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

API і MCP доступні на всіх тарифах, зокрема на пробному періоді.

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

«Telegrin → Claude: завдання Claude саме розбирає нових лідів» · «Кілька каналів доставки лідів і їхній порядок» · «Агенти в кампанії» · «План і ліміти»