Подключение AI-агента через MCP и OAuth

Подключение AI-агента через MCP и OAuth

MCP-сервер Metricgram позволяет AI-клиентам, таким как Claude, ChatGPT, Cursor или Claude Code, работать с вашими группами в Telegram: читать аналитику и данные участников, публиковать сообщения, модерировать и управлять темами. С OAuth не нужно копировать никаких ключей. Вы вставляете один URL, входите в Metricgram и подтверждаете доступ.

MCP-сервер входит во все платные тарифы и доступен в 14-дневном пробном периоде.

1. Скопируйте URL сервера

Откройте Интеграции > MCP в панели управления и скопируйте URL из блока Подключение через OAuth:

https://metricgram.com/api/v1/mcp

2. Добавьте его в свой AI-клиент

• Claude: откройте Settings > Connectors > Add custom connector (Настройки > Коннекторы > Добавить свой коннектор), вставьте URL и сохраните.
• Claude Code: выполните claude mcp add --transport http metricgram https://metricgram.com/api/v1/mcp, затем введите /mcp, чтобы войти.
• ChatGPT, Cursor и другие клиенты: добавьте новый MCP-сервер (в некоторых клиентах он называется коннектором) с тем же URL и выберите OAuth, если клиент спросит способ аутентификации.

3. Войдите и подтвердите доступ

Клиент откроет страницу Metricgram в браузере. При необходимости войдите в аккаунт, проверьте название приложения и его разрешения и нажмите Разрешить. Вас вернёт в клиент, и подключение будет готово.

На странице показаны:

• Приложение, которое запрашивает доступ, и адрес, на который вас вернут.
• Что сможет делать приложение: Чтение ваших групп, участников, сообщений, аналитики и настроек и Запись, то есть действия в ваших группах: публикация, модерация и изменение настроек.
• Предупреждение, если Metricgram не проверил приложение. Продолжайте, только если вы сами начали подключение.

4. Попробуйте

Попросите агента, например: «Подведи итоги активности в моей группе за эту неделю» или «Какие участники ничего не писали последние 30 дней?».

Управление подключёнными приложениями

Каждое одобренное приложение появляется в разделе Подключённые приложения на странице MCP вместе с его разрешениями и датой подключения. Нажмите Отключить, чтобы сразу отозвать доступ.

OAuth или API-ключ?

Используйте OAuth везде, где клиент его поддерживает: не нужно хранить секрет, а приложение можно отключить в любой момент. Для клиентов без поддержки OAuth создайте API-ключ в разделе Интеграции > API и воспользуйтесь примерами конфигурации на странице MCP. Как работают ключи и их разрешения, описано в статье Доступ к API и MCP.

Решение проблем

• «Чтобы подключать AI-агентов через MCP, вашему аккаунту нужен активный тариф Metricgram.»: для MCP нужен активный тариф или пробный период.
• «Этот запрос на подключение недействителен»: срок действия запроса истёк или он был изменён. Начните подключение заново из своего AI-клиента.
• Агент не видит группу: доступ ограничен группами Telegram, которыми вы управляете в Metricgram. Убедитесь, что группа подключена и бот по-прежнему является администратором.
• Агент не может публиковать сообщения или модерировать: у подключения есть только доступ на чтение. Отключите его и подключитесь заново из клиента, который запрашивает доступ на запись.