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