NAV
code
  • SMSAPI MCP Server (Model Context Protocol)
  • 1. Architektura rozwiązania
  • 2. Wymagania wstępne
  • 3. Autoryzacja i uprawnienia (Scopes)
  • 4. Konfiguracja serwera
  • 5. Dostępne Endpointy i Narzędzia
  • 6. Przykładowe zastosowania (Prompty)
  • 7. Rozwiązywanie problemów (Troubleshooting)

    • SMSAPI MCP Server (Model Context Protocol)

    Połącz agentów AI i LLM bezpośrednio z komunikacją SMS, MMS i VMS

    SMSAPI MCP Server to implementacja otwartego standardu Model Context Protocol, która umożliwia modelom AI np. Claude, GPT oraz agentom autonomicznym bezpośrednie korzystanie z funkcji platformy SMSAPI. Dzięki tej integracji AI może nie tylko analizować dane, ale także samodzielnie wysyłać powiadomienia, sprawdzać statusy doręczeń i zarządzać bazą kontaktów w Twoim imieniu.

    1. Architektura rozwiązania

    Integracja opiera się na ustandaryzowanym modelu komunikacji, w którym serwer MCP działa jako warstwa translacji między intencją AI a konkretnym wywołaniem REST API.

    Schemat przepływu:

    Agent AI np. Claude <-> MCP Client <-> SMSAPI MCP Server <-> SMSAPI API

    2. Wymagania wstępne

    Zanim zaczniesz, upewnij się, że posiadasz:

    3. Autoryzacja i uprawnienia (Scopes)

    Serwer MCP obsługuje dwie metody autoryzacji:

    1. OAuth 2.0 webflow (zalecane) — klient MCP automatycznie przeprowadza autoryzację przez przeglądarkę. Użytkownik loguje się do SMSAPI i przyznaje dostęp do wybranych scope'ów. Token jest odnawiany automatycznie. Konfiguracja wymaga jedynie podania URL serwera bez nagłówka Authorization.
    2. Static OAuth2 token — ręcznie wygenerowany token w Panelu Klienta SMSAPI (Ustawienia API -> Tokeny OAuth), podany w nagłówku Authorization: Bearer.
    Funkcja Wymagane uprawnienie (Scope)
    SMS sms
    MMS mms
    VMS vms
    Kontakty contacts
    Konto / Saldo profile
    Podużytkownicy subuser
    Short URL (idz.do) short_url
    HLR hlr
    Czarna lista blacklist
    Nazwy nadawcy sms_sender
    MFA mfa
    Callbacki callbacks

    4. Konfiguracja serwera

    SMSAPI MCP Server jest udostępniany pod adresem https://mcp.smsapi.io/ i korzysta z transportu Streamable HTTP.

    Claude Desktop

    
{
  "mcpServers": {
    "smsapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.smsapi.io/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer TWÓJ_TOKEN_OAUTH2"
      }
    }
  }
}

    Otwórz plik claude_desktop_config.json i dodaj serwer w sekcji mcpServers:

    Cursor

    1. Przejdź do Settings -> MCP.
    2. Kliknij Add new global MCP server.
    3. Wklej powyższą konfigurację JSON. Cursor automatycznie wykryje dostępne narzędzia (oznaczone zielonym wskaźnikiem).

    Claude Code (CLI)

    
claude mcp add smsapi \
  --transport http \
  https://mcp.smsapi.io/ \
  --header "Authorization: Bearer TWÓJ_TOKEN_OAUTH2"

    Dodaj serwer bezpośrednio z terminala:

    5. Dostępne Endpointy i Narzędzia

    Możesz ograniczyć dostęp agenta AI do konkretnych grup narzędzi, zmieniając adres URL endpointu w konfiguracji.

    Grupa Endpoint Opis funkcji
    All / Pełny dostęp do wszystkich narzędzi.
    SMS /sms Wysyłka (pojedyncza/grupowa), planowanie, statusy, usuwanie zaplanowanych.
    MMS /mms Wysyłka MMS (SMIL), planowanie, wysyłka grupowa, statusy.
    VMS /vms Wiadomości głosowe (TTS): wysyłka, planowanie, wysyłka grupowa, statusy.
    Contacts /contacts Zarządzanie kontaktami, grupami kontaktów, wyszukiwanie grup przypisanych do kontaktu, pola własne.
    Account /account Sprawdzanie salda, zarządzanie nazwami nadawcy.
    Subusers /subusers Zarządzanie podużytkownikami: tworzenie, edycja (w tym limity punktów i aktywacja/dezaktywacja), usuwanie.
    Short URL /short-url Generowanie linków idz.do i statystyki kliknięć.
    HLR /hlr Sprawdzanie numerów (HLR lookup).
    Blacklist /blacklist Zarządzanie czarną listą: dodawanie (z opcjonalną datą wygaśnięcia), usuwanie, czyszczenie całej listy, import CSV.

    6. Przykładowe zastosowania (Prompty)

    Gdy serwer jest połączony, możesz wydawać polecenia w języku naturalnym:

    7. Rozwiązywanie problemów (Troubleshooting)

    Błąd Przyczyna Rozwiązanie
    401 Unauthorized Nieprawidłowy lub wygasły token. Wygeneruj nowy token w Panelu Klienta.
    403 Forbidden Brak odpowiednich scope'ów w tokenie. Sprawdź tabelę uprawnień w sekcji 3.
    Narzędzia niewidoczne Błąd konfiguracji klienta MCP. Sprawdź poprawność URL i nagłówka Authorization. Zrestartuj aplikację np. Claude Desktop.
    Timeout Problemy z siecią lub transportem HTTP. Upewnij się, że Twój klient obsługuje transport Streamable HTTP.

    Chcesz dowiedzieć się więcej o protokole?

    Odwiedź oficjalną stronę modelcontextprotocol.io.

    code