Telerivet MCP

npx add-mcp 'https://api.telerivet.com/mcp'

Telerivet предоставляет сервер Model Context Protocol (MCP), который позволяет ИИ-агентам и инструментам на основе LLM, таким как Claude и ChatGPT, взаимодействовать с REST API Telerivet через стандартный интерфейс MCP.

Сервер MCP Telerivet позволяет ИИ-агентам выполнять широкий спектр действий в Telerivet, включая отправку сообщений и планирование их отправки, получение данных и статистики использования, импорт контактов, а также настройку проектов, маршрутов и автоматизированных сервисов.

Конечная точка MCP доступна по адресу:

https://api.telerivet.com/mcp

Клиенты MCP подключаются через транспорт Streamable HTTP, используя сообщения JSON-RPC 2.0 в HTTP-запросах POST.

Настройка клиента

Для доступа к конечной точке MCP требуется аутентификация через OAuth 2.0.

Клиенты MCP с поддержкой OAuth Client ID Metadata Documents (CIMD) могут подключаться без ручной настройки: Telerivet автоматически регистрирует клиент при первой авторизации пользователя. Telerivet не поддерживает Dynamic Client Registration.

Инструкции по настройке доступны для следующих клиентов MCP:

• Claude (claude.ai и Claude Desktop)
• Claude Code
• ChatGPT
• Codex
• Antigravity CLI
• Hermes Agent

Для клиентов MCP, не поддерживающих Client ID Metadata Documents, необходимо вручную настроить OAuth Client. Чтобы использовать другой клиент MCP без поддержки CIMD, можно добавить новый OAuth Client в организацию Telerivet и настроить URL обратного вызова OAuth, необходимые клиенту MCP. (Сервис, предоставляющий клиент MCP, может указывать URL обратного вызова OAuth в своей документации.) OAuth Client, настроенный вручную таким образом, будет доступен только пользователям вашей организации Telerivet.

Авторизация клиента MCP

При подключении клиента MCP он перенаправляет вас в Telerivet для авторизации доступа. На этой странице можно выбрать:

• Разрешения — типы данных и действий, к которым приложение может получить доступ (например, Просмотр сообщений, Отправка сообщений или Редактирование автоматизированных сервисов). Снимите отметку с любого разрешения, которое не хотите предоставлять приложению. Приложение не сможет выполнять действия, недоступные вашей учетной записи пользователя, а методы API, требующие разрешения, которое вы не предоставили, будут скрыты от клиента MCP.
• Организация — организации, к которым приложение может получить доступ. Каждая авторизация распространяется на одну организацию; чтобы использовать приложение с другой организацией, подключите его повторно.

Одобрение приложений для организации. Каждый клиент MCP (например, Claude или ChatGPT) должен быть одобрен администратором организации, прежде чем его можно будет использовать в организации. Если вы администратор организации, на странице авторизации можно одобрить приложение для организации и выбрать параметр Кто может использовать это приложение?: все пользователи организации, только администраторы организации или только администраторы организации и проектов. Другие пользователи увидят сообщение с просьбой обратиться к администратору организации для одобрения приложения.

Отзыв доступа. Вы можете в любое время отозвать доступ приложения к своей учетной записи в разделе Authorized Applications настроек Account Security. Администраторы организации могут просматривать и отзывать токены доступа всех пользователей на странице OAuth Access Tokens или полностью отозвать доступ приложения на странице Connected Applications.

Управление организацией

Администраторы организации могут управлять разрешенными действиями каждого одобренного клиента MCP в организации на странице Connected Applications (ссылка на нее также есть на странице Developer API организации). Нажмите на приложение, чтобы просмотреть или изменить его настройки. Эти настройки применяются ко всем пользователям, обращающимся к приложению в организации, независимо от разрешений, предоставленных пользователями при подключении.

Обязательное разрешение — какие пользователи организации могут авторизовать приложение (все пользователи, только администраторы организации или только администраторы организации и проектов).

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

Действие	Описание	Варианты	По умолчанию
Чтение данных	Поиск контактов, сообщений, статистики и других данных проекта.	Разрешено, Запрещено	Разрешено
Создание и обновление данных	Создание и редактирование контактов, групп, сервисов, черновиков кампаний, маршрутов и других данных проекта.	Разрешено, Требуется подтверждение, Запрещено	Разрешено
Отправка сообщений и запуск сервисов	Отправка сообщений и звонков контактам или планирование их отправки, запуск автоматизированных сервисов и выполнение скриптов.	Разрешено, Требуется подтверждение, Запрещено	Требуется подтверждение
Удаление данных	Удаление контактов, сообщений, сервисов и других данных проекта.	Разрешено, Требуется подтверждение, Запрещено	Требуется подтверждение
Выполнение внешних веб-запросов	Отправка запросов на внешние веб-сайты и к сторонним API из скриптов, запускаемых этим приложением.	Разрешено, Запрещено	Разрешено

Если категория помечена как Запрещено, соответствующий инструмент MCP (например, send_api или delete_api) скрывается от клиента MCP, а любые запросы API в этой категории отклоняются. Для инструмента run_script применяется самое строгое ограничение из настроек отправки, создания и обновления, а также удаления данных.

Некоторые приложения задают собственные значения по умолчанию — например, автономный агент, которому нужно отправлять сообщения без участия пользователя. Если значение по умолчанию для приложения отличается от стандартного, на странице Connected Applications рядом с настройкой указывается значение приложения. Настройки вашей организации всегда имеют приоритет.

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

Отозвать доступ — удаляет приложение из списка одобренных приложений организации и отзывает все его действующие токены доступа в организации.

Приложения, принадлежащие вашей организации (добавленные через Add OAuth Client), не требуют одобрения; разрешенные действия настраиваются на странице настроек самого приложения.

Подтверждение с участием человека

Если на странице Connected Applications для категории действий выбрано значение Требуется подтверждение, клиент MCP не сможет выполнять эти действия, пока пользователь явно не подтвердит каждое из них. По умолчанию это относится к отправке сообщений и запуску сервисов, а также к удалению данных.

К категории отправки относятся отправка сообщений и звонков или планирование их отправки, повторная отправка сообщений, запуск автоматизированных сервисов, создание пакетных задач, имитация входящих сообщений, редактирование запланированных сообщений или кампаний, активация автоматизированного сервиса или изменение конфигурации активного сервиса, создание вебхуков или изменение URL вебхуков, изменение номера телефона или настроек провайдера маршрута, изменение маршрута по умолчанию для проекта, а также запуск скриптов с помощью инструмента run_script. Категория удаления включает все методы удаления, а также сокращение срока хранения сообщений в проекте.

В зависимости от клиента MCP подтвердить действие можно одним из следующих способов:

Запрос на подтверждение в клиенте MCP

Если клиент MCP поддерживает MCP elicitation (используя версию протокола MCP 2026-07-28 или более позднюю), он предложит подтвердить действие непосредственно в клиенте и покажет понятное описание того, что будет сделано и какого проекта это коснется. Если вы подтвердите действие, оно будет выполнено немедленно. Если вы отклоните его, действие не будет выполнено, а ИИ-модели будет указано не повторять запрос.

Черновики сообщений

Если клиент MCP поддерживает расширение MCP Apps, ИИ-модель может использовать инструмент draft_message, чтобы показать вам редактируемый черновик текстового сообщения, включая список получателей. Нажатие Отправить подтверждает отправку именно этого сообщения указанным получателям.

Ссылка для подтверждения

Если клиент MCP не поддерживает ни один из описанных выше способов или действие нельзя подтвердить таким образом, ИИ-модель получит ссылку на страницу Approve Action в веб-приложении Telerivet и должна предложить вам открыть ее. На этой странице отображаются приложение, проект, описание действия и полные сведения о запросе. Нажмите Approve, затем вернитесь в клиент MCP и попросите его повторить попытку.

Чтобы подтвердить действие, у вас должно быть разрешение, необходимое для самого действия (например, разрешение на отправку сообщений в проекте). Подтверждение действия не предоставляет приложению дополнительных разрешений.

Как работают подтверждения

• Каждое подтверждение распространяется на один точный запрос — тот же метод API с теми же параметрами — и может быть использовано только один раз. Если ИИ-модель изменит что-либо в запросе, его потребуется подтвердить повторно.
• Срок действия подтверждений истекает через 1 час.
• Запросы API, выполняемые скриптом, который вы подтвердили через run_script, не требуют отдельного подтверждения.
• Если приложение обращается напрямую к REST API с помощью своего токена доступа (а не через MCP), запросы, требующие подтверждения, завершаются ошибкой с кодом confirmation_required, а сообщение об ошибке содержит ссылку для подтверждения. Чтобы приложения могли выполнять такие действия без участия пользователя (например, серверные интеграции или автономные агенты), администратор организации должен установить для этой категории значение Разрешено.

Проверка сообщений. Независимо от описанных выше настроек, если в проекте включена функция Message Review в настройках обмена сообщениями, сообщения, отправленные через API (в том числе через MCP) и превышающие заданные ограничения, будут помещены в очередь на проверку до одобрения проверяющим — так же, как сообщения, отправленные из веб-приложения.

Инструменты

В настоящее время сервер MCP предоставляет следующие инструменты:

• list_api_methods – Перечисляет доступные методы API с указанием имени, описания и сводки параметров. Поддерживает фильтрацию по категории.
• get_method_schema – Возвращает полную схему параметров и описания полей ответа для конкретного метода API.
• read_api – Выполняет метод API только для чтения, чтобы получить данные.
• modify_api – Выполняет метод API, который создает или обновляет данные.
• delete_api – Выполняет метод API, который удаляет данные.
• send_api – Выполняет метод API, который отправляет, планирует или получает сообщения, вызывает автоматизированные службы или выполняет пакетные задачи.
• run_analysis_script – Запускает JavaScript только для чтения в изолированной среде Cloud Script API Telerivet для анализа данных проекта — это полезно для агрегирования данных, объединения сущностей разных типов или сканирования множества записей без постраничной передачи всех данных модели. Доступ к API предоставляется только для чтения, исходящие HTTP-запросы отключены.
• run_script – Запускает JavaScript с доступом к Cloud Script API (чтение, запись, отправка, HTTP-запросы) для массовых операций, которые иначе потребовали бы множества отдельных вызовов API. Запросы API, выполняемые скриптами, проверяются на соответствие областям действия OAuth-токена, поэтому скрипты не могут выполнять действия, недоступные токену, с помощью которого они запущены.
• get_web_app_urls – Возвращает сведения о функциях веб-приложения и шаблонах URL. Позволяет ИИ-агентам создавать ссылки на функции, недоступные напрямую через API. Без запроса возвращает краткий перечень всех страниц; поиск по ключевым словам или пути URL возвращает подробные сведения о соответствующих страницах.
• draft_message – Создает черновик простого текстового сообщения для одного или нескольких номеров телефонов (или группы контактов) и запрашивает подтверждение пользователя перед отправкой (см. Черновики сообщений). Доступно только в том случае, если клиент MCP поддерживает расширение MCP Apps.
• get_route_options – Возвращает сведения о доступных вариантах маршрутов/каналов обмена сообщениями. Фильтрация по стране, типу канала или сценарию использования (либо поиск конкретного типа маршрута) возвращает подробные сведения, включая географическую доступность, требования соответствия нормативным требованиям, процесс регистрации, режимы оплаты (внутреннее управление/Telerivet или внешнее/BYOC), сроки настройки и цены.
• skillbook_search / skillbook_get – Возвращает сведения о распространенных шаблонах решений, службах, типах кампаний, функциях платформы и шаблонах сообщений, соответствующих намерению или сценарию использования.
• search_documentation / get_documentation – Выполняет поиск и извлекает записи из корпуса документации Telerivet, включая справочные статьи руководства пользователя, юридические страницы и страницы с политиками, документацию API для разработчиков, а также маркетинговые материалы и сведения о компании на www.telerivet.com.

Набор инструментов и методов API, предоставляемых MCP-сервером, может со временем меняться.

По ссылкам ниже можно посмотреть JSON, возвращаемый MCP-сервером. Он поможет разобраться в доступных инструментах и методах API:

• Определения инструментов
• Результат работы инструмента list_api_methods
• Результат работы инструмента get_method_schema для метода Project_queryContacts (замените последний компонент URL, чтобы просмотреть схему других методов API)
• Результат работы инструмента get_documentation для справочника Cloud Script API (замените последний компонент URL, чтобы просмотреть другие записи документации)

Области действия, предоставленные вашему OAuth-токену, и ограничения вашей организации для приложения определяют, какие инструменты и методы API доступны. Методы, для которых требуется область действия, отсутствующая у вашего токена, или которые ваша организация не разрешает использовать в приложении, не будут включены в список.