MCP-сервер Telemetr.me

Спрашивайте про каналы обычными словами

Подключите Telemetr к Claude, Cursor или другому ИИ-ассистенту с поддержкой MCP — и запрашивайте данные о каналах прямо в чате.

Охваты, вовлечённость, динамика подписчиков, публикации, поиск по каталогу и другие данные Telemetr. Для Telegram и MAX используются разные API-ключи — площадку сервер определяет автоматически.

Адрес MCP-сервера https://mcp.telemetr.me/mcp Скопировать

Подключение за три шага

1. 1

   Получите API-ключ

   Создайте ключ в личном кабинете Telemetr. Ключей может быть несколько — например, отдельный для Claude и отдельный для Cursor.

   Для каждого ключа можно задать имя и собственный потолок расхода. Лимиты пакета при этом общие для всех ключей аккаунта: потолок только не даёт одному ключу израсходовать больше заданного.

   Для работы MCP нужен доступ к API. Выберите подходящий пакет на странице пакетов API.

   Если вы зарегистрировались меньше 30 дней назад и пользуетесь бесплатным тарифом, API можно бесплатно попробовать на канале @telemetr_me. Для пробного доступа аккаунт должен быть подтверждён через Telegram, MAX или Яндекс ID.

2. 2

   Добавьте Telemetr в свой ИИ-ассистент

   Выберите приложение ниже и добавьте MCP-сервер. Вместо ВАШ_КЛЮЧ укажите свой API-ключ.

   Claude Code

   Откройте терминал и выполните команду:

   терминалСкопировать

   claude mcp add --transport http telemetr https://mcp.telemetr.me/mcp \
     --header "Authorization: Bearer ВАШ_КЛЮЧ"

   После добавления можно проверить подключение командой claude mcp list.

   Claude

   Для Claude в браузере и в приложении откройте Customize → Connectors → Add custom connector. В Team и Enterprise собственный коннектор добавляет владелец организации — через Organization settings → Connectors.
   Укажите адрес сервера https://mcp.telemetr.me/mcp, в способе авторизации выберите No sign-in и в разделе Request headers добавьте заголовок:

   поле «Header name»Скопировать

   Authorization

   поле «Header value»Скопировать

   Bearer ВАШ_КЛЮЧ

   ⚠ Имя и значение заголовка вводятся в разные поля. В поле значения должно быть только Bearer ВАШ_КЛЮЧ — без второго Authorization:. Поменять заголовок у уже добавленного коннектора нельзя: ошиблись — удалите коннектор и добавьте заново.
   Раздел Request headers пока доступен не всем аккаунтам Claude. Если его нет, используйте Claude Code или способ из вкладки «Другие клиенты».

   Cursor

   Чтобы Telemetr был доступен во всех проектах, добавьте сервер в ~/.cursor/mcp.json. Этот файл лежит вне проектов, поэтому ключ можно вписать прямо в него:

   ~/.cursor/mcp.jsonСкопировать

   {
     "mcpServers": {
       "telemetr": {
         "url": "https://mcp.telemetr.me/mcp",
         "headers": {
           "Authorization": "Bearer ВАШ_КЛЮЧ"
         }
       }
     }
   }

   Для одного проекта используйте .cursor/mcp.json в его корне. Если этот файл хранится в Git, не вписывайте в него ключ открытым текстом — Cursor подставит его из переменной окружения TELEMETR_API_KEY:

   .cursor/mcp.jsonСкопировать

   {
     "mcpServers": {
       "telemetr": {
         "url": "https://mcp.telemetr.me/mcp",
         "headers": {
           "Authorization": "Bearer ${env:TELEMETR_API_KEY}"
         }
       }
     }
   }

   Переменная должна быть видна самому Cursor: задайте её в окружении, из которого он запускается, и перезапустите Cursor.

   VS Code

   Создайте файл .vscode/mcp.json в проекте. В формате VS Code верхний ключ — servers, а не mcpServers.

   .vscode/mcp.jsonСкопировать

   {
     "inputs": [
       {
         "type": "promptString",
         "id": "telemetr-key",
         "description": "Ключ API Telemetr.me",
         "password": true
       }
     ],
     "servers": {
       "telemetr": {
         "type": "http",
         "url": "https://mcp.telemetr.me/mcp",
         "headers": {
           "Authorization": "Bearer ${input:telemetr-key}"
         }
       }
     }
   }

   При первом запуске VS Code запросит API-ключ и сохранит его в защищённом хранилище. В самом файле ключа нет, поэтому в репозиторий он не попадёт.

   Devin Desktop

   Windsurf переименован в Devin Desktop, а агент Cascade из него убран: MCP-серверы теперь подключает агент Devin Local — так же, как Devin CLI. Проще всего добавить сервер командой в терминале:

   терминалСкопировать

   devin mcp add --scope user --transport http telemetr https://mcp.telemetr.me/mcp \
     --header "Authorization: Bearer ВАШ_КЛЮЧ"

   Или впишите сервер в файл ~/.config/devin/mcp_config.json (в Windows — %APPDATA%\devin\mcp_config.json). Адрес здесь задаётся полем url, а не serverUrl, как было в Windsurf:

   mcp_config.jsonСкопировать

   {
     "mcpServers": {
       "telemetr": {
         "url": "https://mcp.telemetr.me/mcp",
         "transport": "http",
         "headers": {
           "Authorization": "Bearer ВАШ_КЛЮЧ"
         }
       }
     }
   }

   Для одного проекта сервер можно описать в .devin/mcp_config.json, но этот файл хранится в Git — ключ держите в соседнем .devin/mcp_config.local.json, он в репозиторий не попадает.

   Другие клиенты

   Если ваш клиент поддерживает только локальные MCP-серверы через stdio, Telemetr можно подключить через мост mcp-remote. Для этого нужен установленный Node.js.

   конфигурация клиентаСкопировать

   {
     "mcpServers": {
       "telemetr": {
         "command": "npx",
         "args": [
           "-y", "mcp-remote", "https://mcp.telemetr.me/mcp",
           "--header", "Authorization:${AUTH_HEADER}"
         ],
         "env": {
           "AUTH_HEADER": "Bearer ВАШ_КЛЮЧ"
         }
       }
     }
   }

   API-ключ передаётся через переменную окружения. В строке Authorization:${AUTH_HEADER} после двоеточия намеренно нет пробела: часть клиентов (Cursor, Claude Desktop под Windows, Codex CLI) передаёт аргументы с пробелами некорректно, поэтому значение Bearer ВАШ_КЛЮЧ вынесено в переменную.

   ChatGPT

   В ChatGPT собственные MCP-серверы подключаются через режим разработчика. Возможности подключения зависят от тарифа и версии интерфейса.
   Режим разработчика поддерживает только вход через OAuth или подключение без авторизации. Передать API-ключ в заголовке Authorization там пока нельзя, поэтому напрямую подключить Telemetr не получится. Когда такая возможность появится, мы обновим инструкцию.

   Claude Code и Claude в браузере мы проверили вручную. Конфигурации остальных клиентов подготовлены по их документации. Если подключение не заработало — напишите в поддержку, разберёмся.

3. 3

   Задайте вопрос

   После подключения ассистент сам выберет нужные инструменты Telemetr. Например:

   • Разбери канал @telemetr_me: покажи охваты, вовлечённость и динамику подписчиков.
   • Найди русскоязычные каналы о финансах от 50 000 подписчиков с ER выше 5%.
   • Найди публикации о нейросетях за прошлую неделю и покажи самые просматриваемые.
   • Найди 10 каналов, похожих на @telemetr_me, и сравни их по охвату.

Что можно делать через MCP

• Получить данные о канале

  telemetr_channel_overview

  Основные данные канала за один вызов: карточка, охваты и вовлечённость, индекс цитирования, динамика подписчиков и последние публикации.

  Расход лимитов: при первом обращении канал занимает один канал из лимита на текущий период, повторные обращения к нему лимит каналов не расходуют. Запросы считаются за каждый блок данных: по умолчанию их два — карточка и статистика.

• Найти каналы

  telemetr_find_channels

  Поиск по каталогу с фильтрами: подписчики, вовлечённость, прирост, стоимость рекламы, пол аудитории, тематика, язык и другие параметры.

  Расход лимитов: один запрос плюс одна строка каталога за каждый результат. Лимит каналов не расходуется.

• Найти публикации

  telemetr_search_posts

  Поиск публикаций по всей собранной базе за выбранный период: текст, показатели поста и канал-источник.

  Расход лимитов: один запрос плюс одна публикация за каждый найденный пост.

• Найти похожие каналы

  telemetr_similar_channels

  Каналы, похожие на указанный по тематике и аудитории.

  Расход лимитов: один запрос, один канал за исходный канал и одна строка каталога за каждый найденный результат.

• Получить справочники

  telemetr_reference

  Тематики, языки и другие значения, которые используются в фильтрах.

  Расход лимитов: не больше одного запроса на каждый справочник — дальше данные берутся из кэша без дополнительного расхода.

• Проверить остаток лимитов

  telemetr_budget

  Сколько осталось по каждому лимиту: запросы, каналы, каталог и публикации.

  Лимиты не расходуются. Инструмент работает, даже когда один из лимитов закончился.

Как MCP расходует лимиты

Telegram и MAX

Telegram и MAX работают как две отдельные площадки. Для каждой нужен свой API-ключ, свой пакет и свои лимиты.

Площадку выбирать вручную не нужно — MCP определяет её по ключу.

Если вам нужны обе площадки, добавьте Telemetr в настройках клиента дважды с разными ключами и названиями, например telemetr-telegram и telemetr-max.

Что доступно по MAX

По MAX история данных пока короче, чем по Telegram. Динамика подписчиков доступна по дням.

Список упоминаний по MAX уже можно получать напрямую через API, но отдельного MCP-инструмента для упоминаний пока нет ни для Telegram, ни для MAX.

Счётчики упоминаний в карточке MAX пока не показываем: история по MAX короткая, и маленькое число создало бы впечатление, что канал почти не упоминают.

Подробнее о доступных данных — в документации API, раздел «Площадка MAX».

Если не удаётся подключиться

Если клиент не может подключиться к MCP-серверу, он обычно показывает HTTP-код ошибки.

Если сервер подключился, но не отдаёт данные

В этом случае ошибка приходит уже от API Telemetr. ИИ-ассистент обычно передаст её обычным текстом.