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 станут доступны ассистенту.

Инструменты

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

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

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

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

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

Чего пока нельзя

Через MCP (как и через REST) пока недоступны:

real-time голосовой API — живая голосовая сессия проекта по API-ключу;
кастомные инструменты — вызов ваших внешних вебхуков как тулз агента.

Обе возможности находятся в разработке — см. Роадмап.

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