MCP-сервер Telegram для AI-агентов
Metricgram превращает Telegram Bot API в облачный MCP-сервер, чтобы ваш AI-агент мог читать, публиковать, модерировать и администрировать ваши Telegram-группы с ключами ограниченного доступа и без собственного кода бота.
- Более 70 методов Telegram Bot API в виде MCP-инструментов
- Работает с Claude, ChatGPT, Cursor и Codex
- Каждый вызов ограничен вашими группами
- Аналитика, участники и подписчики на том же сервере
Кредитная карта не требуется
Настройка за 2 минуты
Как это работает
1
Добавьте бота и подключите группы
Добавьте бота Metricgram (или своего собственного бота) администратором в свои Telegram-группы. Никаких серверов, вебхуков и polling.
2
Создайте API-ключ с нужными правами
Сгенерируйте API-ключ тарифа Elite и точно укажите, что разрешено агенту, от доступа к Telegram только на чтение до публикаций, модерации и настроек чата.
3
Подключите его к своему AI-клиенту
Вставьте один блок конфигурации в Claude, Cursor, Codex или любой MCP-клиент. Теперь агент видит каждое разрешённое действие в Telegram как инструмент.
Один запрос, реальные действия в Telegram
Агент выбирает нужные вызовы Bot API, Metricgram выполняет их в правильной группе и возвращает структурированный результат.
metricgram · mcp
Вы просите
Опубликуй в Crypto Talk анонс AMA на этой неделе, тихо закрепи его, создай тему «Вопросы к AMA» и дай мне ссылку-приглашение, которая истечёт в пятницу.
Агент вызывает
- send_telegram_message(group_id: 42, text: "…", buttons: [{ url: "…" }])
- pin_telegram_message(group_id: 42, action: "pin", disable_notification: true)
- manage_forum_topic(group_id: 42, action: "create", name: "…")
- create_telegram_invite_link(group_id: 42, expire_date: "2026-10-23T23:59:00Z")
Подключите любой MCP-клиент
Используйте облачный эндпоинт со своим API-ключом. В Claude Desktop его можно подключить через mcp-remote.
{
"mcpServers": {
"metricgram": {
"url": "https://metricgram.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Инструменты вашего агента
Сообщения и медиа
send_telegram_message
send_telegram_media
send_telegram_poll
edit_telegram_message
delete_telegram_messages
forward_telegram_message
react_to_telegram_message
Закрепы и темы форума
pin_telegram_message
manage_forum_topic
createForumTopic
closeGeneralForumTopic
unpinAllForumTopicMessages
Модерация и заявки на вступление
ban_member
restrict_member
promote_member
handle_telegram_join_request
banChatSenderChat
setChatAdministratorCustomTitle
Настройки чата и ссылки-приглашения
update_telegram_chat_settings
create_telegram_invite_link
revokeChatInviteLink
setChatPermissions
setChatStickerSet
Аналитика и данные сообщества
analytics_overview
active_users
list_members
list_messages
gamification_rankings
get_subscriber_health
Любой поддерживаемый метод Bot API
telegram_api_methods
telegram_bot_api
get_telegram_chat
get_telegram_chat_member
Telegram Bot API, адаптированный для AI-агентов
Интеграция Telegram с агентом обычно означает хостинг бота, обработку вебхуков, хранение токенов и отдельный инструмент для каждого эндпоинта. Metricgram уже запускает бота в ваших группах, поэтому агент получает Bot API в виде готовых MCP-инструментов через один облачный эндпоинт.
Типизированные инструменты и полный шлюз Bot API
Для частых задач, таких как отправка сообщений, медиа, опросов, закрепы, темы и ссылки-приглашения, есть отдельные инструменты с понятными описаниями. Всё остальное проходит через telegram_bot_api, который принимает официальные названия методов и параметры Bot API, так что весь поддерживаемый каталог остаётся доступным.
Только ваши группы
Агент никогда не выбирает chat_id сам. Metricgram определяет его по группе, которой вы владеете, проверяет пересланные и цитируемые сообщения на принадлежность вашим группам и отклоняет всё, что может попасть в чужой чат.
Права доступа для любого уровня доверия
Выдавайте telegram:read агентам для исследований, telegram:write для публикаций и тем, telegram:moderate для банов и заявок на вступление, а telegram:admin для титулов, разрешений и ссылок-приглашений. Ключи можно отозвать в любой момент.
Безопасные повторы и понятные ошибки
Инструменты записи принимают ключ идемпотентности, поэтому повторный вызов никогда не опубликует сообщение дважды. Ошибки Telegram и лимиты запросов возвращаются как структурированные результаты с retry_after, которые агент может обработать сам.
Контекст, которого нет у обычных ботов
Тот же сервер предоставляет аналитику Metricgram, историю участников, сохранённые сообщения, геймификацию, AI-сводки и состояние подписчиков Stripe, чтобы агент мог решить, что делать, ещё до того, как начнёт действовать.
Metricgram vs. Ручное управление
| Metricgram | Вручную | |
|---|---|---|
| Облачный MCP-эндпоинт без собственного сервера бота | ||
| Более 70 методов Telegram Bot API как инструменты | ||
| chat_id привязан только к вашим группам | ||
| API-ключи с отдельными правами и возможностью отзыва | ||
| Идемпотентные повторы для инструментов записи | ||
| Аналитика и история участников как контекст | ||
| Актуальные данные чата, админы и разрешения | ||
| Работает с вашим собственным ботом |
Часто задаваемые вопросы
Что такое MCP-сервер Telegram?
Это сервер Model Context Protocol, который предоставляет действия в Telegram в виде инструментов, доступных AI-агенту. Metricgram размещает его за вас и использует бота, который уже управляет вашими группами.
С какими AI-клиентами он работает?
С любым клиентом, поддерживающим MCP по HTTP, включая Claude Code, Claude Desktop (через mcp-remote), Cursor, Codex и собственные агенты на SDK от OpenAI или Anthropic.
Покрывает ли он весь Telegram Bot API?
Он охватывает более 70 методов для работы с группами, включая сообщения, медиа, опросы, редактирование, реакции, закрепы, темы форума, модерацию, заявки на вступление, настройки чата и ссылки-приглашения. Методы, которые могут затронуть другие чаты или самого бота, например вебхуки, платежи или выход из группы, намеренно исключены.
Может ли агент публиковать в группах, которые мне не принадлежат?
Нет. Каждый вызов привязан к одной из ваших подключённых групп. chat_id задаёт Metricgram, а пересылки и ответы могут ссылаться только на ваши группы.
Это пользовательский API Telegram (MTProto)?
Нет. Используется официальный Bot API через бота вашей группы, поэтому агент действует от имени бота и никогда от имени вашего личного аккаунта Telegram.
В какой тариф входит MCP-сервер?
Доступ к MCP и API входит в тариф Elite. Бесплатный 14-дневный пробный период даёт доступ уровня Elite, поэтому вы можете подключить агента до оплаты.
Можно ли ограничить, что разрешено агенту?
Да. У каждого API-ключа свои права, и вы можете создать отдельные ключи для аналитики только на чтение, публикаций, модерации и администрирования.
Продолжайте изучать
Найдите практическое руководство, посмотрите активные сообщества или откройте новые способы использовать Metricgram.
Гайды
Блог
Читайте практические материалы о росте, монетизации, модерации и управлении Telegram-сообществами.
ИзучитьКаталог сообществ
Каталог сообществ Telegram
Изучайте активные Telegram-сообщества по категориям, языкам и позиционированию.
ИзучитьХаб раздела
Решения
Все страницы этого раздела в одном месте.
ИзучитьУзнайте больше
Инструмент для управления группами Telegram
Аналитика и метрики для групп Telegram
Бот Telegram для управления группами
Автоматизируйте свою группу Telegram
Telegram-бот для членства в платных сообществах
Telegram-бот для платежей в группах и каналах
Telegram-бот для подписок и регулярного дохода
Монетизация Telegram-канала — просто и эффективно
Создание и управление VIP-группой в Telegram
Превратите поддержку в Telegram в аналитику по клиентским аккаунтам
MCP
API
AI чат-боты Ассистенты