Spis treści

SMSAPI MCP Server – połącz agentów AI z komunikacją SMS.

1. Wprowadzenie – AI jako nowy interfejs do usług SMS

Agenci AI coraz częściej stają się nowym sposobem korzystania z narzędzi i usług cyfrowych. Zamiast ręcznie wykonywać zadania w różnych systemach użytkownicy mogą zlecić je agentowi AI, który sam uruchamia odpowiednie narzędzia i integracje.

Sprawdź dokumentację SMSAPI

Kliknij przycisk poniżej, aby przejść do pełnej Dokumentacji SMSAPI MCP.

Dokumentacja SMSAPI MCP

Dotyczy to również komunikacji z klientami. AI może analizować zdarzenia w systemie, reagować na nie i automatycznie wysyłać powiadomienia. Aby było to możliwe, modele AI potrzebują standardowego sposobu komunikacji z zewnętrznymi usługami – takimi jak platformy wysyłki wiadomości SMS.

Właśnie do tego powstał Model Context Protocol (MCP). Dzięki MCP narzędzia AI mogą korzystać z funkcji platform takich jak SMSAPI w sposób uporządkowany i bezpieczny.

2. Co to jest MCP (Model Context Protocol)?

Model Context Protocol (MCP) to otwarty standard umożliwiający modelom AI i agentom AI korzystanie z zewnętrznych usług poprzez wspólny interfejs. W praktyce MCP działa jak warstwa pośrednia między agentem AI a systemem zewnętrznym – na przykład platformą do wysyłki SMS. Zamiast budować osobną integrację dla każdego narzędzia AI, usługa może udostępnić MCP server, który prezentuje jej funkcje jako zestaw narzędzi. Dzięki temu integracja z usługą staje się prostsza i bardziej uniwersalna.

Co potrafi agent AI?

• odkrywanie dostępnych funkcji,
• wybieranie właściwych narzędzi,
• uruchamianie narzędzi i funkcji w odpowiednim momencie.

3. Dlaczego komunikacja SMS dobrze pasuje do agentów AI

SMS jest jednym z najbardziej bezpośrednich i skutecznych kanałów komunikacji z użytkownikami.

Jakie są biznesowe zastosowania SMS?

• wysyłka kodów weryfikacyjnych (OTP i 2FA SMS),
• powiadomienia SMS o statusie zamówienia, dostawy, zwrotów, reklamacji,
• przypomnienia o wizytach,
• alerty systemowe,
• marketing SMS.

W wielu procesach biznesowych moment wysyłki SMS zależy od konkretnego zdarzenia – na przykład zmiany statusu zamówienia lub wykrycia problemu w systemie. Agenci AI doskonale nadają się do obsługi takich scenariuszy.

Jakie są przewagi agenta AI?

• jednoczesna analiza danych z wielu systemów,
• podejmowanie decyzji w czasie rzeczywistym,
• automatyczne uruchamianie odpowiednich działań.

W takim modelu SMS staje się naturalnym elementem automatycznych workflow.

4. SMSAPI MCP Server – co to jest?

SMSAPI MCP Server udostępnia funkcje platformy SMS API poprzez protokół MCP, dzięki czemu mogą z nich korzystać agenci AI oraz narzędzia developerskie obsługujące MCP. W praktyce oznacza to, że agent AI może bezpośrednio wykonywać operacje związane z wysyłką wiadomości SMS, korzystając z zestawu narzędzi udostępnionych przez serwer MCP.

Zamiast tworzyć osobne integracje dla każdego środowiska AI, funkcje SMSAPI są dostępne w ustandaryzowany sposób. Dzięki temu SMS może stać się elementem inteligentnych automatyzacji tworzonych z pomocą AI.

5. Funkcje SMSAPI MCP Server

Serwer MCP dla SMSAPI udostępnia zestaw funkcji związanych z komunikacją SMS.

Wysyłka wiadomości SMS

Agenci AI mogą wysyłać wiadomości SMS w odpowiedzi na określone zdarzenia lub działania użytkownika.

Jakie wiadomości SMS może wysłać agent AI?

• powiadomienia transakcyjne,
• alerty systemowe,
• wiadomości informacyjne,
• komunikację z klientem.

Przykład: wysyłka SMS z Claude

Sprawdzanie statusu doręczenia

Agent AI może sprawdzić, czy wiadomość została dostarczona do odbiorcy. Pozwala to na tworzenie bardziej zaawansowanych scenariuszy.

Przykładowe zastosowania sprawdzania statusu doręczenia:

• ponowna próba wysyłki SMS,
• wysłanie powiadomienia alternatywnym kanałem,
• zapisanie statusu w systemie CRM.

Zarządzanie nadawcą wiadomości

System może konfigurować identyfikator nadawcy (nadpis SMS) używany w wysyłanych wiadomościach. Dzięki temu komunikacja SMS może być spójna z identyfikacją marki.

Przeczytaj więcej o brandingu SMS

Branding SMS – jak ustawić nazwę nadawcy w miejsce numeru telefonu?

Czytaj artykuł

Dostęp do informacji o koncie

Agent AI może pobierać informacje o stanie konta lub wykorzystaniu wiadomości, co umożliwia monitorowanie kosztów i wykorzystania usługi.

6. Przykładowe zastosowania SMS w automatyzacjach AI

Integracja SMSAPI z agentami AI otwiera wiele nowych możliwości automatyzacji komunikacji.

Powiadomienia o statusie zamówienia

Agent AI może monitorować zmiany statusu zamówienia w systemie e-commerce i automatycznie wysyłać SMS do klienta, gdy zamówienie zostanie wysłane lub dostarczone.

Alerty operacyjne dla zespołów

W przypadku wykrycia problemu w systemie infrastruktury agent AI może natychmiast wysłać SMS do administratorów lub zespołu technicznego.

Przypomnienia o wizytach

System AI obsługujący rezerwacje może wysyłać przypomnienia SMS przed wizytą lub spotkaniem.

Kody weryfikacyjne i bezpieczeństwo

Agent AI może uruchamiać wysyłkę kodów jednorazowych (OTP) w procesach logowania lub potwierdzania operacji.

Automatyczna komunikacja z klientami

Agent AI obsługujący wsparcie klienta może wysyłać SMS z informacją o zmianie statusu zgłoszenia lub prośbą o dodatkowe informacje.

Przetestuj SMSAPI!

Załóż darmowe konto SMSAPI i przetestuj możliwości profesjonalnej bramki SMS i RCS dla firm.

Załóż konto

7. Jak działa integracja AI z SMS API?

Integracja opiera się na prostym modelu komunikacji. Agent AI wysyła zapytanie do klienta MCP, który komunikuje się z serwerem MCP SMS API. Serwer MCP przekształca to zapytanie w odpowiednie wywołanie API SMSAPI. Dzięki temu agent AI może korzystać z funkcji wysyłki SMS bez bezpośredniej integracji z API.

Jaki jest schemat działania integracji AI z SMSAPI?

Agent AI ↔️ MCP client ↔️ SMSAPI MCP Server ↔️ SMSAPI API

8. Konfiguracja i autoryzacja połączenia AI z API SMS

Wymagania wstępne

Przed rozpoczęciem konfiguracji upewnij się, że posiadasz:

• aktywne konto SMSAPI – jeśli nie masz konta, załóż konto dla firm,
• OAuth 2.0 webflow (zalecane) – klient MCP automatycznie przeprowadza autoryzację przez przeglądarkę. Zaloguj się do SMSAPI i przyznaj dostęp do wybranych scope’ów. Token jest odnawiany automatycznie. Konfiguracja wymaga jedynie podania URL serwera bez nagłówka Authorization.
• token OAuth2 – wygenerowany w panelu klienta SMSAPI (sekcja Ustawienia API -> Tokeny OAuth),
• klient MCP – zainstalowana aplikacja obsługująca MCP np. Claude Desktop lub Cursor.

Autoryzacja i uprawnienia (scopes)

Serwer MCP korzysta z autoryzacji opartej o token OAuth2 SMSAPI. Podczas generowania tokena należy zaznaczyć odpowiednie uprawnienia (scopes) w zależności od tego, z których narzędzi serwera ma korzystać agent AI:

Zalecamy stosowanie zasady najmniejszych uprawnień – jeśli agent ma jedynie wysyłać powiadomienia, wystarczy przyznać mu dostęp do sms.

Transport

SMSAPI MCP Server jest udostępniany jako usługa pod adresem mcp.smsapi.io. Serwer korzysta z transportu Streamable HTTP – najnowszego standardu komunikacji MCP. Klienty MCP obsługujące ten transport łączą się bezpośrednio z serwerem po HTTP, bez konieczności używania dodatkowych bridge’ów czy proxy.

Kompatybilni klienci MCP

SMSAPI MCP Server działa z każdym klientem obsługującym transport Streamable HTTP m.in.

• aplikacje desktopowe: Claude Desktop, Cursor, VS Code (GitHub Copilot)
• narzędzia CLI: Claude Code, OpenAI Codex CLI
• frameworki agentowe: LangChain, OpenAI Agents SDK, Semantic Kernel, Spring AI

Bezpieczeństwo tokena – zasady

• Nigdy nie umieszczaj tokena OAuth2 bezpośrednio w kodzie źródłowym ani w repozytoriach.
• Korzystaj ze zmiennych środowiskowych do przechowywania tokena.
• Stosuj zasadę najmniejszych uprawnień – przyznawaj tokenowi tylko te scopy, które są niezbędne.

Claude Desktop konfiguracja MCP

1. Otwórz Claude Desktop i przejdź do Settings (ikona zębatki).

2. Wybierz zakładkę Developer, a następnie kliknij Edit Config, aby otworzyć plik claude_desktop_config.json.

3. Dodaj konfigurację serwera SMSAPI MCP:

{
  "mcpServers": {
    "smsapi": {
      "type": "http",
      "url": "https://mcp.smsapi.io/",
      "headers": {
        "Authorization": "Bearer TWÓJ_TOKEN_OAUTH2"
      }
    }
  }
}

4. Zapisz plik i uruchom ponownie Claude Desktop.

5. Po restarcie kliknij ikonę plus w lewym dolnym rogu, następnie Connectors → Manage connectors – powinna pojawić się lista narzędzi SMSAPI.

Konfiguracja Cursor

1. Otwórz Cursor i przejdź do Cursor Settings (Ctrl+Shift+J lub menu).

2. Wybierz MCP z menu bocznego.

3. Kliknij Add new global MCP server.

4. W pliku mcp.json dodaj konfigurację:

{
  "mcpServers": {
    "smsapi": {
      "type": "http",
      "url": "https://mcp.smsapi.io/",
      "headers": {
        "Authorization": "Bearer TWÓJ_TOKEN_OAUTH2"
      }
    }
  }
}

5. Zapisz plik – Cursor automatycznie wykryje nowy serwer.

6. Sprawdź, czy obok nazwy serwera pojawił się zielony wskaźnik i lista dostępnych narzędzi.

Konfiguracja Claude Code (CLI)

Dodaj serwer jednym poleceniem w terminalu:

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

Po dodaniu serwer będzie automatycznie dostępny w kolejnych sesjach Claude Code.

Klienci bez obsługi remote MCP (STDIO bridge)

Jeśli Twój klient MCP nie obsługuje bezpośredniego połączenia HTTP, możesz użyć bridge’a mcp-remote (wymaga Node.js 18+):

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

Ograniczenie do wybranej grupy narzędzi

Aby agent AI miał dostęp wyłącznie do wybranej grupy funkcji np. tylko SMS, użyj endpointu grupowego:

{
  "mcpServers": {
    "smsapi-sms": {
      "type": "http",
      "url": "https://mcp.smsapi.io/sms/",
      "headers": {
        "Authorization": "Bearer TWÓJ_TOKEN_OAUTH2"
      }
    }
  }
}

Dzięki temu agent otrzyma mniejszy zestaw narzędzi, co zmniejsza zużycie tokenów i poprawia trafność doboru narzędzi przez model AI.

Uwaga!

Zastąp TWÓJ_TOKEN_OAUTH2 swoim tokenem wygenerowanym w Panelu Klienta. Po każdej zmianie konfiguracji uruchom ponownie klienta MCP.

9. Endpointy i funkcje (features)

Serwer SMSAPI MCP jest podzielony na grupy funkcjonalne, z których każda jest dostępna pod osobnym endpointem. Pozwala to na precyzyjne zarządzanie uprawnieniami agentów AI (zasada najmniejszych uprawnień).

10. Przykładowe prompty

Po połączeniu z serwerem MCP wystarczy opisać agentowi AI co chcesz zrobić w języku naturalnym. Oto kilka przykładów promptów.

Wysyłka SMS

Wyślij SMS do numeru 48123456789 z treścią "Twoje zamówienie #12345 zostało wysłane. Przewidywana dostawa: jutro do 18:00."

Sprawdzenie salda

Sprawdź ile mam punktów na koncie SMSAPI.

Wysyłka do grupy kontaktów

Wyślij wiadomość SMS do wszystkich kontaktów z grupy "Klienci VIP" z treścią "Zapraszamy na ekskluzywną wyprzedaż -30% tylko dziś!"

Zarządzanie kontaktami

Dodaj nowy kontakt: Jan Kowalski, numer 48111222333, email jan@example.com. Następnie przypisz go do grupy "Newsletter".

Sprawdzenie statusu wiadomości

Sprawdź status doręczenia SMS o ID abc123.

Zaplanowanie wysyłki

Zaplanuj wysyłkę SMS do 48123456789 z treścią "Przypomnienie: jutro o 10:00 masz wizytę w gabinecie." Wyślij dzisiaj o 18:00.

Walidacja numeru

Sprawdź czy numer 48123456789 jest aktywny (HLR lookup).

Zarządzanie czarną listą

Dodaj numer 48999888777 do czarnej listy, żeby nie otrzymywał więcej wiadomości.

11. Jak zacząć korzystać z MCP w SMSAPI?

Najszybszym sposobem na rozpoczęcie pracy jest skorzystanie z publicznej instancji serwera:

1. Wygeneruj token OAuth2 w panelu klienta SMSAPI z odpowiednimi uprawnieniami (scopes).
2. Skonfiguruj połączenie z serwerem w swoim kliencie MCP np. Claude Desktop – patrz sekcja 8. Konfiguracja i autoryzacja połączenia AI z API SMS.
3. Po połączeniu agent AI automatycznie uzyska dostęp do wybranych narzędzi.

Sprawdź dokumentację SMSAPI

Kliknij przycisk poniżej, aby przejść do pełnej Dokumentacji SMSAPI MCP.

Dokumentacja SMSAPI MCP

12. Rozwiązywanie problemów (troubleshooting)

13. Co dalej – AI i przyszłość biznesowej komunikacji SMS

Rozwój agentów AI sprawia, że coraz więcej procesów biznesowych może być automatyzowanych i zarządzanych przez inteligentne systemy. Komunikacja z klientami jest jednym z kluczowych elementów tych procesów.

Dzięki SMSAPI MCP Server wysyłka wiadomości SMS może stać się naturalną częścią automatycznych workflow tworzonych z pomocą AI. To dopiero początek możliwości integracji komunikacji SMS z nowym ekosystemem narzędzi opartych o sztuczną inteligencję.

Przetestuj SMSAPI!

Załóż darmowe konto SMSAPI i przetestuj możliwości profesjonalnej bramki SMS i RCS dla firm.

Załóż konto