Доступ к API и MCP

Доступ к API и MCP

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

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

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

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

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

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

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

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

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

Рекомендации

• Создавайте отдельные токены для разных внешних инструментов.
• Используйте понятные названия, чтобы знать, где используется каждый токен.
• Отзывайте токены, которые больше не нужны.
• Не публикуйте токены в чатах, скриншотах, тикетах или публичных репозиториях.