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.
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é.
send_at)errorCodeServer 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.
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.
Pokud možnost vlastního konektoru chybí, záleží na tarifu Claude nebo na nastavení vaší organizace.
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 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.
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" }
}
}
}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
| Kredit | Kaž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á. |
|---|---|
| Souhlas | Př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íček | U 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 AI | Pro opakované automatizace bez AI je vhodnější Make nebo přímo REST API. |
10 SMS na začátek, bez závazku a bez platební karty. Podpora je k dispozici nonstop a zdarma.