Доступ к API и MCP

В Metricgram есть публичный API и MCP-сервер, чтобы подключать собственные инструменты, дашборды, автоматизации или AI-клиенты к данным и операциям, доступным в вашем аккаунте.

MCP-сервер доступен на всех платных тарифах и в течение 14-дневного пробного периода. AI-клиенты могут подключаться через OAuth (достаточно вставить URL сервера и подтвердить доступ) или с API-ключом. REST API требует доступа уровня Elite. Если доступ не включен в ваш аккаунт, раздел API может быть заблокирован или показывать сообщение об обновлении тарифа.

Где это находится

Откройте Интеграции > MCP или Интеграции > API в панели управления. Аккаунты с доступом могут создавать API-токены, просматривать активные токены, отзывать их и видеть техническую справку, доступную для своего тарифа.

Как работают токены

Токены относятся к вашему пользовательскому аккаунту Metricgram, а не к одной конкретной группе.
Токен может обращаться к группам и ресурсам, которыми может управлять ваш аккаунт.
Токены включают разрешения для групп, участников, сообщений, автоматизаций, подписчиков, аналитики, тикетов поддержки, рефералов и MCP.
Некоторые конечные точки API позволяют только читать данные; другие могут создавать, обновлять, модерировать или запускать действия в зависимости от разрешений токена.
Значение токена показывается только один раз при создании. Сохраните его в безопасном месте.

Выбор разрешений

Для нового токена по умолчанию включены только разрешения на чтение (:read). Добавляйте разрешения :write, только если интеграции нужно создавать или изменять данные; модерация участников требует отдельного разрешения members:moderate. Оставьте токену только те разрешения, которые нужны конкретному инструменту.

Telegram Bot API через MCP

MCP-сервер также предоставляет Telegram Bot API, ограниченный вашими группами, чтобы AI-агенты могли действовать в ваших группах через бота Metricgram или вашего собственного бота.

Используйте telegram_api_methods, чтобы получить список методов, доступных вашему токену, и telegram_bot_api, чтобы вызвать любой из них с официальными параметрами Bot API.
Типизированные инструменты покрывают повседневные задачи: send_telegram_message, send_telegram_media, send_telegram_poll, pin_telegram_message, manage_forum_topic, create_telegram_invite_link и другие.
Чат всегда относится к одной из ваших групп. Вы никогда не передаёте chat_id: Metricgram определяет его по group_id.
Для действий в Telegram есть отдельные разрешения: telegram:read, telegram:write, telegram:moderate и telegram:admin. Токены, созданные до появления этих разрешений, нужно создать заново, чтобы их использовать.
Медиа должно быть публичной HTTPS-ссылкой или file_id из Telegram, а inline-кнопки могут только открывать ссылки или копировать текст.
Инструменты записи принимают необязательный idempotency_key, поэтому повторный вызов не выполнит действие дважды.

Аутентификация и лимиты

API-запросы используют заголовок Authorization: Bearer mg_.... Лимит по умолчанию — 600 запросов в минуту на токен, а форма позволяет выбрать значение в пределах минимума и максимума, разрешенных приложением.

Если токен отозван, аккаунт потерял доступ к API или тариф больше не включает API & MCP, запросы с этим токеном будут отклонены.

Доступ к API и MCP

В этой статье