Руководство / Практика голосового ИИ
Как управлять MAIA через MCP
Подключение MCP, ключ с ограниченными правами, безопасная первая проверка и отличие чтения данных от запуска звонка.
MCP позволяет совместимому ИИ-клиенту вызывать инструменты MAIA. Начните с ключа на чтение и получения списка проектов. Подключение не означает разрешение автоматически звонить клиентам или менять настройки.
Что понадобится
- Совместимый клиент с поддержкой удалённого MCP и нужного способа авторизации.
- API-ключ MAIA с минимальными правами.
- Адрес транспорта: https://mcp.maia-ai.com/mcp.
- Понимание того, какие данные и действия доступны владельцу ключа.
Первая безопасная проверка
Подключите сервер по инструкции своего клиента и запросите список проектов. Проверьте, что видите нужный аккаунт, а не тестовое пространство. Не помещайте ключ в публичные примеры или снимки экрана.
Затем попробуйте прочитать результат уже существующего тестового разговора. Это проверяет доступ и формат данных без создания нового звонка.
Действия требуют отдельного намерения
Создание проекта, изменение сценария и запуск обзвона — разные операции. Перед платным действием должны быть понятны получатели, объём и условия запуска.
Созданная кампания остаётся черновиком до отдельного старта. Транспорт MCP не отменяет проверки тарифа, баланса, владения проектом и согласия, которые выполняет платформа.
Когда удобнее REST
Если процесс запускает ваше приложение по фиксированному событию, REST API может быть проще и предсказуемее. MCP удобен для управления из диалога, а REST — для заранее заданной интеграции. Они могут использовать одну бизнес-логику.
Источники и проверка
Используйте актуальные документы поставщика и настройки своего проекта. Поддержка режима, условия тарифа и параметры могут измениться.
API и MCP MAIA
Проверьте подходящий сценарий и возможности своего проекта.
Подробнее