Перейти до основного вмісту

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 робочих днів.
  • Відповідь на надсилання містить ідентифікатор, а не підтвердження доставки. Звіт від оператора може йти до кількох годин.
  • Зміна тарифів, робота з адресними книгами та реєстрація імен через конектор недоступні — це робиться в кабінеті.