MCP-конектор для ШІ-асистентів

MCP (Model Context Protocol) — спосіб дати ШІ-асистенту доступ до зовнішнього сервісу. Підключивши конектор AlphaSMS, ви надсилаєте повідомлення й перевіряєте доставку прямо з діалогу з асистентом: «надішли клієнту код підтвердження», «перевір, чи дійшло вчорашнє повідомлення», «скільки лишилося на рахунку».

URI: https://mcp.alphasms.ua/mcp

Транспорт — Streamable HTTP: кожен виклик це JSON-RPC-запит методом POST. Окремий сервер піднімати не потрібно, конектор уже працює.

Авторизація

Ключ передається в заголовку Authorization як Bearer <ключ>. Він іде напряму в API платформи: конектор не зберігає ні ключів, ні ваших повідомлень.

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

urlрядокобов'язковий Адреса конектора: https://mcp.alphasms.ua/mcp

typeрядокобов'язковий Транспорт. Завжди http — Streamable HTTP

Authorizationзаголовокобов'язковий Bearer і ваш ключ API з особистого кабінету: Налаштування → API → Додати. Ключ показується один раз, скопіюйте одразу

Конфігурація клієнта

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

Працює з будь-яким клієнтом, що підтримує MCP: Claude Desktop і Claude Code, ChatGPT, Cursor, VS Code, n8n та іншими.

Перевірка зв'язку

curl -s https://mcp.alphasms.ua/health
# {"ok":true,"domain":"alphasms.ua","send_enabled":true}

send_enabled показує, чи ввімкнене надсилання для вашого домену. Якщо вимкнене, інструменти надсилання не пропонуються взагалі.

Що вміє конектор

Одинадцять інструментів. Читання виконується одразу, надсилання завжди питає підтвердження.

Читання

• balance — залишок на рахунку та валюта
• senders_list — імена відправника та їхній статус
• message_status — статус повідомлення з розшифруванням
• hlr_lookup — перевірка номера через HLR

Надсилання

• send_sms — одне SMS
• send_viber — Viber з картинкою, посиланням і кнопкою
• send_viber_with_sms_fallback — Viber з досиланням SMS
• send_rcs — RCS
• send_voice — голосовий виклик із зачитуванням тексту
• send_whatsapp — WhatsApp
• send_verification_code — одноразовий код

Перший виклик

Запитайте баланс — це безкоштовно й одразу показує, що ключ робочий.

JSON-RPC

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "balance",
        "arguments": {}
    }
}

cURL

curl -X POST 'https://mcp.alphasms.ua/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ВАШ_API_КЛЮЧ' \
  --data-raw '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "balance",
    "arguments": {}
  }
}'

Python

import requests

response = requests.post(
    "https://mcp.alphasms.ua/mcp",
    headers={"Authorization": "Bearer ВАШ_API_КЛЮЧ"},
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "balance",
            "arguments": {}
        }
    },
    timeout=30,
)

print(response.json())

Node.js

const response = await fetch("https://mcp.alphasms.ua/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer ВАШ_API_КЛЮЧ",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "balance",
      "arguments": {}
    }
  }),
});

console.log(await response.json());

Відповідь

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
      "content": [
          {
              "type": "text",
              "text": "{\"amount\": 152.4, \"currency\": \"UAH\"}"
          }
      ]
  }
}

Чому надсилання вимагає підтвердження

Надсилання списує гроші з рахунку, тому в нього два замки.

Два замки

Явне підтвердженняна кожен виклик Кожен інструмент надсилання вимагає confirm: true. Асистент не може проставити його на власний розсуд — в описі інструмента прямо сказано, що це робиться лише після згоди людини

Немає масових розсилокза задумом Один виклик — одне повідомлення на один номер. Інструмент, яким можна розіслати по всій базі, надто небезпечний у руках моделі, яка прочитала чужий текст і взяла його за вказівку. Для розсилок є кабінет

Відповідь при відмові

Інструмент надсилання, викликаний без підтвердження, відповідає відмовою і до API не звертається.

{
  "refused": true,
  "reason": "Отправка тратит деньги клиента и требует явного подтверждения",
  "how_to": "Спросите человека и передайте confirm: true только после его согласия"
}

Чим це відрізняється від звичайного API

По суті нічим: конектор ходить у той самий https://api.alphasms.ua, що й будь-яка ваша інтеграція. Різниця в тому, хто формує запит — ваш код чи асистент, якому ви пояснили завдання словами. Надсилання йде через асинхронний прийом: повідомлення стає в чергу, і у відповідь приходить ідентифікатор, а не статус доставки.

Обмеження

Чого конектор не робить

Один виклик — одне повідомлення Масові розсилки не підтримуються

Ім'я відправника заздалегідь Реєстрація триває 7–14 робочих днів

У відповіді немає факту доставки Приходить ідентифікатор. Звіт оператора може йти до кількох годин — статус питайте через message_status

Лише через кабінет Тарифи, адресні книги та реєстрація імен через конектор недоступні

Повний опис параметрів — на сторінці Інструменти конектора.