MCP-сервер

MCP (Model Context Protocol) — открытый протокол, который позволяет ИИ-ассистентам (например, Claude) подключаться к внешним сервисам как к инструментам. Вместо того чтобы писать код под REST API, вы подключаете MAIA как «коннектор», и ассистент сам вызывает нужные действия: смотрит проекты, читает звонки, запускает обзвон.

MCP-сервер MAIA использует те же данные и те же права, что и REST API, и авторизуется тем же API-ключом.

Параметры подключения

Параметр	Значение
URL	`https://mcp.maia-ai.com/mcp`
Транспорт	Streamable HTTP
Авторизация	заголовок `X-API-Key: maia_ВАШ_КЛЮЧ`

API-ключ создаётся в кабинете dashboard.maia-ai.com → раздел «API и MCP» → вкладка «API» → «Создать ключ». Ключ показывается один раз. Для запуска звонков нужен ключ со scope write.

Подключение к Claude Desktop

Кнопка «Add custom connector» в интерфейсе Claude не подходит — она работает по OAuth. Для MAIA подключение настраивается через config-файл и мост mcp-remote.

⚠️

Нужен установленный Node.js — мост mcp-remote запускается через npx.

Шаг 1. Установите Node.js (если ещё не установлен) — он включает npx.

Шаг 2. Откройте файл конфигурации Claude Desktop claude_desktop_config.json. В Claude Desktop его можно открыть через Settings → Developer → Edit Config.

Шаг 3. Добавьте сервер MAIA, подставив свой ключ:

{
  "mcpServers": {
    "maia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.maia-ai.com/mcp",
        "--header",
        "X-API-Key:maia_ВАШ_КЛЮЧ"
      ]
    }
  }
}

Шаг 4. Полностью перезапустите Claude Desktop. После перезапуска инструменты MAIA станут доступны ассистенту.

Инструменты

Сервер отдаёт 30 инструментов. Мутации требуют ключа со scope write. Ассистент вызывает их сам — вам достаточно попросить его на естественном языке.

Проекты и агенты

Инструмент	Что делает	Scope
`list_projects`	список ваших проектов	read
`create_project`	создать нового агента (тариф Бизнес/Про)	write
`get_agent_config`	текущая конфигурация агента	read
`list_agent_actions`	доступные действия настройки (реестр «Маэстро»)	read
`configure_agent`	изменить настройки агента пакетом действий	write

Попроси Claude: «Создай агента для записи в барбершоп и покажи его настройки».

Звонки

Инструмент	Что делает	Scope
`list_calls`	история звонков	read
`get_call`	детали звонка: статус, длительность, транскрипт	read
`place_call`	запустить исходящий звонок (тратит баланс)	write

Попроси Claude: «Позвони +79991234567 от проекта “Отдел продаж” и подтверди запись».

Контакты и баланс

Инструмент	Что делает	Scope
`get_balance`	текущий баланс	read
`list_contacts`	список контактов	read
`update_contact`	правка имени/заметок/тегов/статуса лида	write

Попроси Claude: «Найди контакт Иванова и пометь его статусом “горячий”».

База знаний

Инструмент	Что делает	Scope
`list_knowledge`	источники базы знаний и статус индексации	read
`add_knowledge`	добавить источник: текст или URL	write
`delete_knowledge`	удалить источник	write

Попроси Claude: «Добавь в базу знаний проекта страницу example.com/faq и обойди весь сайт». Файлы (PDF/DOCX) через MCP не передать — грузите их через REST POST /v1/public/projects/{id}/knowledge/file.

Кампании обзвона

Инструмент	Что делает	Scope
`create_campaign`	создать кампанию (draft)	write
`add_campaign_contacts`	загрузить контакты (JSON, до запуска)	write
`start_campaign`	запустить (требует явного `consent=true`)	write
`campaign_status`	статус, счётчики, расход (поллинг)	read
`pause_campaign` / `resume_campaign` / `stop_campaign`	пауза / возобновление / остановка	write
`requeue_campaign`	перезвонить недозвонам	write

Попроси Claude: «Создай кампанию по этому списку и запусти обзвон» — перед стартом Claude обязательно спросит подтверждение согласия абонентов (152-ФЗ/38-ФЗ).

Поиск клиентов (лидоген)

Инструмент	Что делает	Scope
`parse_lead_brief`	бесплатный разбор брифа + смета	write
`search_leads`	запустить платный поиск	write
`get_lead_search`	статус и прогресс джобы (поллинг)	read
`list_leads`	найденные лиды	read
`leads_to_campaign`	собрать кампанию обзвона из лидов	write

Попроси Claude: «Найди 50 салонов красоты в Казани» — Claude покажет смету и попросит согласие на платный поиск, затем соберёт из результатов кампанию.

Номера (телефония)

Инструмент	Что делает	Scope
`list_numbers`	номера транков и их привязки к проектам	read
`assign_number`	привязать номер к проекту	write
`unassign_number`	отвязать номер	write

Попроси Claude: «Привяжи +74951234567 к проекту “Отдел продаж” для исходящих».

Чем отличается от REST

MCP и REST работают с одними и теми же данными и правами (scopes read/write), но решают разные задачи:

REST API — для интеграции в ваш код и сервисы: вы сами шлёте HTTP-запросы и обрабатываете ответы. См. REST API.
MCP — для работы из ИИ-ассистента: ассистент сам выбирает и вызывает инструменты в ответ на ваши запросы на естественном языке, без написания кода.

Если вам нужна автоматизация внутри приложения — используйте REST. Если нужно «поговорить» с MAIA через Claude — используйте MCP.

Доступно вне MCP

MCP уже покрывает почти весь публичный API: проекты и настройку агента, звонки, контакты, базу знаний, кампании, поиск клиентов и номера. Несколько возможностей используются иначе:

Загрузка файлов в базу знаний — PDF/DOCX/txt через MCP не передать; используйте REST-роут POST /v1/public/projects/{id}/knowledge/file (multipart). Текст и URL добавляются прямо из MCP (add_knowledge).
Real-time голосовой API — живая голосовая сессия с агентом: доступна через REST (POST /v1/public/realtime/session), см. Real-time голос. Через MCP пока не выдаётся.
Кастомные инструменты агента — вызов ваших внешних вебхуков как тулз: настраивается в кабинете (редактор проекта, Бизнес/Про), см. Кастомные инструменты.

Real-time голос Вебхуки