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» · «Несколько каналов доставки лидов и их порядок» · «План и лимиты»