Перейти к основному содержимому

MCP-коннектор для ИИ-ассистентов

MCP (Model Context Protocol) — это способ дать ИИ-ассистенту доступ к внешнему сервису. Подключив коннектор SMS-Docs, вы сможете отправлять сообщения и проверять их доставку прямо из диалога с ассистентом: «отправь клиенту код подтверждения», «проверь, дошло ли вчерашнее сообщение», «сколько осталось на счету».

Работает с любым клиентом, который поддерживает MCP: Claude Desktop и Claude Code, ChatGPT, Cursor, VS Code, n8n и другие.

Адрес коннектора

https://mcp.alphasms.net/mcp

Транспорт — Streamable HTTP. Отдельный сервер поднимать не нужно, коннектор уже работает.

Подключение

Ключ API берётся в личном кабинете: Настройки → API → Добавить. Ключ показывается один раз — скопируйте сразу.

Добавьте коннектор в конфигурацию вашего ассистента:

{
"mcpServers": {
"sms": {
"type": "http",
"url": "https://mcp.alphasms.net/mcp",
"headers": {
"Authorization": "Bearer ВАШ_API_КЛЮЧ"
}
}
}
}

Ключ передаётся заголовком и никуда не сохраняется: коннектор передаёт его напрямую в API платформы и не хранит у себя ни ключей, ни ваших сообщений.

Что умеет

Читать — доступно сразу:

  • остаток на счету;
  • список зарегистрированных имён отправителя и их статус;
  • статус отправленного сообщения с расшифровкой человеческим языком;
  • проверку номера в сети оператора через HLR.

Отправлять — с обязательным подтверждением:

  • SMS;
  • Viber, в том числе с картинкой, ссылкой и кнопкой;
  • каскад Viber с досылкой SMS, если Viber не доставлен;
  • RCS;
  • голосовой вызов с зачитыванием текста;
  • WhatsApp;
  • одноразовые коды подтверждения.

Полный список параметров — на странице Инструменты коннектора.

Почему отправка требует подтверждения

Отправка списывает деньги с вашего счёта, поэтому у неё две защиты.

Во-первых, каждый инструмент отправки требует явного параметра подтверждения. Ассистент не может выставить его «по своему усмотрению» — в описании инструмента прямо сказано, что это делается только после согласия человека.

Во-вторых, коннектор не умеет массовых рассылок и не будет уметь. Один вызов — одно сообщение на один номер. Инструмент, которым можно разослать по всей базе, слишком опасен в руках модели, которая прочитала чужой текст и приняла его за указание. Для рассылок есть личный кабинет.

Чем это отличается от обычного API

Ничем по сути: коннектор ходит в тот же https://alphasms.net, что и любая ваша интеграция. Разница в том, кто формирует запрос. Обычное API вызывает ваш код, а коннектор — ассистент, которому вы объяснили задачу словами.

Отправка идёт через асинхронный приём: сообщение ставится в очередь, и в ответ приходит идентификатор, а не статус доставки. Статус запрашивается отдельно, когда оператор его вернёт.

Ограничения

  • Один вызов — одно сообщение. Массовые рассылки не поддерживаются.
  • Имя отправителя должно быть зарегистрировано заранее: регистрация занимает 7–14 рабочих дней.
  • Ответ на отправку содержит идентификатор, а не подтверждение доставки. Отчёт от оператора может идти до нескольких часов.
  • Изменение тарифов, работа с адресными книгами и регистрация имён через коннектор недоступны — это делается в кабинете.