Přeskočit na obsah

MCP server pro SMS

  • 9 nástrojůpro SMS: odeslání i plánované, hromadné, stav, zrušení, ověřovací kódy, kredit, ceník
  • OAuthpřipojení přihlášením z Claude nebo ChatGPT, bez kopírování klíče
  • MITopen source licence

Model Context Protocol (MCP) je standard, přes který AI asistenti volají nástroje. S oficiálním MCP serverem TopSMS řeknete Claudovi, ChatGPT, Cursoru nebo jinému asistentovi „pošli zákazníkovi SMS, že objednávka je na cestě“ a on to udělá přes váš účet TopSMS, včetně kontroly doručení a kreditu.

10 testovacích SMS, bez platební karty a bez paušálu.

Jedna věta, jedno volání nástroje

Napište, co byste řekli svému asistentovi. Pod tím uvidíte, který nástroj na vašem účtu TopSMS zavolá a co se mu vrátí.

Asistent zavolá nástroj

get_credit

Argumenty

{}

Odpověď serveru

{
  "ok": true,
  "credit": 1240.5,
  "currency": "CZK",
  "smsPrice": 0.99
}

Asistent odpoví

Máte 1240,50 Kč kreditu, jedna SMS stojí 0,99 Kč.

Ukázková data. Názvy nástrojů, argumentů a polí odpovědi jsou skutečné.

Co umí

  • send_smsodešle SMS na jedno číslo, volitelně s vaším schváleným odesílatelem, hned nebo naplánovaně (send_at)
  • send_bulk_smsstejný text až na 500 čísel, velké dávky jdou do fronty
  • get_message_statusstav doručení zprávy včetně důvodu nedoručení errorCode
  • get_bulk_jobprůběh dávky
  • cancel_scheduledzruší naplánované odeslání a vrátí kredit
  • verify_sendpošle ověřovací kód (OTP), viz Verify API
  • verify_checkzkontroluje ověřovací kód
  • get_creditzůstatek kreditu a cena za SMS
  • get_pricingveřejný ceník (bez přihlášení)

Server volá stejné REST API jako vaše aplikace, takže platí stejné ceny, limity a pravidla účtování. Odesílací nástroje přijímají volitelný idempotencyKey: když asistent volání zopakuje, SMS neodejde dvakrát. Balíček: npmjs.com/package/topsms-mcp.

Pro programovací agenty jsou k dispozici také open-source TopSMS Skills: naučí agenta API (odesílání, webhooky, OTP, délka SMS) a odesílání obstará tento server. Přehled a instalace do Claude Code jedním příkazem: SMS pro AI agenty.

Připojení v Claude a ChatGPT bez API klíče

Server běží na adrese https://www.topsms.cz/api/mcp a podporuje přihlášení přes OAuth. Vložíte adresu, přihlásíte se ke svému účtu TopSMS a na stránce souhlasu kliknete na Povolit. Žádný klíč nekopírujete. Účty z topsms.eu použijí https://topsms.eu/api/mcp.

Claude (claude.ai nebo aplikace Claude), krok za krokem

  1. OtevřítOtevřete Nastavení → Konektory (Settings → Connectors) a klikněte na Add custom connector.
  2. PřidatNázev: TopSMS, URL: https://www.topsms.cz/api/mcp. Pole OAuth Client ID a Secret nechte prázdná a klikněte na Add.
  3. PřipojitKlikněte na Connect. Otevře se přihlášení do TopSMS, přihlaste se svým účtem.
  4. PovolitNa stránce souhlasu zkontrolujte název aplikace a klikněte na Povolit. Vrátíte se zpět do Claude.
  5. Zeptat seU konektoru uvidíte nástroje TopSMS. V chatu zapněte TopSMS v nabídce nástrojů a zeptejte se třeba: Kolik mám kreditu?

Pokud možnost vlastního konektoru chybí, záleží na tarifu Claude nebo na nastavení vaší organizace.

ChatGPT

Settings → Apps & Connectors, v rozšířeném nastavení zapněte Developer mode, vytvořte konektor se stejnou URL a ověřením OAuth, přihlaste se a povolte. Vývojářský režim je jen v některých tarifech ChatGPT.

Claude Code

claude mcp add --transport http topsms https://www.topsms.cz/api/mcp, potom /mcp a přihlášení v prohlížeči. Nebo nainstalujte plugin TopSMS, který přidá tento server i Skills najednou.

Každé připojení se v dashboardu v sekci API přístup objeví jako klíč OAuth: název aplikace se štítkem OAUTH. Jeho zrušením asistenta odpojíte. Kredit, pravidla pro odesílatele i limit požadavků jsou stejné jako u API klíče. Podrobný postup s příklady: Jak poslat SMS z Claude nebo ChatGPT.

Ukázková data
Ukázková data

Vzdálený MCP s API klíčem

Klienti bez přihlašování, například Cursor, použijí stejnou adresu s API klíčem v hlavičce Authorization: Bearer CLIENT_ID:SECRET. Node.js není potřeba. Testovací klíč nic neodesílá ani neúčtuje, takže si nástroje můžete nejdřív vyzkoušet.

# Claude Code
claude mcp add --transport http topsms https://www.topsms.cz/api/mcp \
  --header "Authorization: Bearer CLIENT_ID:SECRET"

# Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "topsms": {
      "url": "https://www.topsms.cz/api/mcp",
      "headers": { "Authorization": "Bearer CLIENT_ID:SECRET" }
    }
  }
}

Instalace npm balíčku

Pro Claude Desktop, Cursor a další: v dashboardu v sekci API klíče vytvořte klíč se scopes send a read a do konfigurace MCP klienta přidejte:

Potřebujete Node.js 18 nebo novější. Cursor, Windsurf i VS Code používají stejný formát konfigurace.

{
  "mcpServers": {
    "topsms": {
      "command": "npx",
      "args": ["-y", "topsms-mcp"],
      "env": {
        "TOPSMS_CLIENT_ID": "vas-client-id",
        "TOPSMS_SECRET": "vas-secret"
      }
    }
  }
}

Claude Code jedním příkazem:

claude mcp add topsms -e TOPSMS_CLIENT_ID=... -e TOPSMS_SECRET=... -- npx -y topsms-mcp

Bezpečnost a náklady

KreditKaždé odeslání čerpá skutečný kredit. Nechte v klientovi zapnuté potvrzování volání nástrojů, asistent se pak před odesláním zeptá.
SouhlasPři přihlášení uvidíte stránku souhlasu s názvem aplikace a tím, co bude moci (odesílat SMS a čerpat kredit, číst kredit a stav zpráv). Heslo zadáváte jen na stránkách TopSMS.
Vlastní klíčKaždý asistent má vlastní klíč, z přihlášení nebo vytvořený vámi. V dashboardu uvidíte jeho spotřebu zvlášť a kdykoli ho zrušíte.
npm balíčekU npm balíčku zůstává klíč na vašem počítači v konfiguraci klienta, balíček ho posílá jen na www.topsms.cz.
Bez AIPro opakované automatizace bez AI je vhodnější Make nebo přímo REST API.
Ukázková data

Vyzkoušejte TopSMS zdarma

10 SMS na začátek, bez závazku a bez platební karty. Podpora je k dispozici nonstop a zdarma.