API и MCP

REST API

Отправка сообщений, проверка номеров, рассылки, вебхук входящих и чат-бот. Ключ создаётся в программе, вкладка «API / MCP», и показывается целиком один раз.

Базовый адрес: https://app.maxmstr.ru/api. Ключ передаётся одним из способов: поле access_token в JSON, заголовок Authorization: Bearer brk_… или x-api-key.

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

Быстрый старт

curl -sS https://app.maxmstr.ru/api/send \
  -H "Authorization: Bearer brk_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"instance_id":"ID_АККАУНТА","number":"79991234567","type":"text","message":"Привет"}'

Методы

Метод	Путь	Назначение
`POST`	`/api/send`	Сообщение: text, image, document, contact. До 50 номеров
`POST`	`/api/contacts/check_number`	Проверка номера или пачки `numbers`
`GET` `POST`	`/api/instance/status`	Программа на связи и список аккаунтов
`POST`	`/api/webhook/set`	Включить или выключить вебхук входящих
`GET` `POST`	`/api/webhook/get`	Текущие настройки вебхука
`POST`	`/api/contacts/contact_upload`	Группа получателей для API-кампании
`POST`	`/api/bulk/create`	Создать API-кампанию
`POST`	`/api/bulk/update`	Статус: 0 пауза, 1 запуск, 2 завершить
`POST`	`/api/bulk/stop`	Остановить кампанию
`GET`	`/api/bulk/get_status`	Прогресс кампании
`GET`	`/api/bulk/get_all`	Список кампаний
`POST`	`/api/bulk/delete`	Удалить кампанию
`POST`	`/api/chatbot/turn_on_off`	Чат-бот: `status` 1 или 0
`GET`	`/api/chatbot/get`	Настройки чат-бота

Поля

instance_id — аккаунт из таблицы на вкладке API. number или numbers — получатели. type: text, image, document, contact. Для файла — media (ссылка или base64) и filename. Для контакта — contact_name и contact_phone.

Кампания через API — это не список из окна «Кампании» в программе. Сначала contact_upload с name и массивом contacts, затем bulk/create: group — имя этой группы, accounts — id через запятую, caption — текст, можно {name}.

Вебхук: enabled, публичный url, accounts (не больше 30), scope all или dialogs. Пока программа закрыта, события не копятся. Ответ в тот же диалог — обычный /api/send, в number можно передать chat_id из вебхука.

Успех: {"status":"success","message":"…","data":{…}}. Ошибка приходит с "status":"error". Частые причины: нет ключа, программа не запущена на том ПК, аккаунт не подключён, instance_id не найден.

MCP

Тот же ключ, что у REST API. Адрес: https://app.maxmstr.ru/mcp. Это JSON-RPC, только POST. Заголовок Authorization: Bearer brk_….

Cursor

Settings → MCP → New MCP Server, либо файл .cursor/mcp.json в проекте.

{
  "mcpServers": {
    "maxmaster": {
      "url": "https://app.maxmstr.ru/mcp",
      "headers": { "Authorization": "Bearer brk_ВАШ_КЛЮЧ" }
    }
  }
}

Claude

Claude Desktop: Settings → Developer → Edit Config. На macOS файл ~/Library/Application Support/Claude/claude_desktop_config.json. В Claude.ai тот же блок добавляется своим коннектором.

Инструменты

Инструмент	Что делает
`max_send`	Отправить сообщение
`max_check_number`	Проверить номер
`max_instance_status`	Статус программы и аккаунтов
`max_webhook_set`	Вебхук входящих
`max_webhook_get`	Настройки вебхука
`max_contacts_upload`	Получатели для API-кампании
`max_bulk_create`	Создать кампанию
`max_bulk_update`	Пауза, запуск или завершение
`max_bulk_stop`	Остановить
`max_bulk_status`	Прогресс
`max_bulk_list`	Список кампаний
`max_bulk_delete`	Удалить кампанию
`max_chatbot_toggle`	Включить или выключить чат-бота
`max_chatbot_get`	Настройки чат-бота

Аргументы совпадают с полями REST, кроме ключа: его MCP берёт из заголовка. В программе в строке ключа кнопка «Промпт для ИИ» копирует адрес, ключ и этот JSON.