Znalost, nebo akce? Vezměte si obojí
Skills a MCP server řeší dvě různé věci. Skills agenta naučí, jak naše API funguje – výsledkem je správný kód. MCP server mu dá přístup k vašemu účtu – výsledkem je odeslaná zpráva. Doplňují se a nejlépe fungují společně.
Skills = znalost
Agent dostane přesnou dokumentaci k JSON API v2 i REST API v1 – včetně detailů, které jazykové modely jinak pletou: omnichannel flow, Unicode versus GSM, plánování, tagy nebo formát telefonních čísel.
Sám nic neodesílá. Píše kód, který odesílá.
MCP server = akce
Agent se připojí k vašemu účtu přes OAuth a dostane patnáct nástrojů: odeslání zprávy, stav doručení, přehled zpráv, kredit, fakturační údaje, API klíče i objednávky služeb.
Nepíše kód. Prostě to udělá.
| Hledisko | Skills | MCP server |
|---|---|---|
| Co to je | Balíček dokumentace pro agenta | Server, ke kterému se agent připojí |
| Co z toho máte | Správně napsaný kód a integraci | Provedenou akci ve vašem účtu |
| Co potřebujete | Nic – instalace je bez přihlášení | Účet SmsManager a přihlášení přes OAuth |
| Kde to běží | Lokálně ve vašem agentovi | Na našem serveru, pod vaším účtem |
| Komu se hodí | Vývojářům, kteří staví integraci | Komukoli, kdo chce zprávy řešit z chatu |
Vývojář obvykle ocení obojí: Skills při psaní integrace, MCP server při jejím testování a při každodenním provozu účtu.
Připojení MCP serveru
MCP server běží na transportu Streamable HTTP a autorizuje se přes OAuth 2.1. Do klienta stačí vložit adresu, přihlásit se a vybrat workspace – žádný API klíč nikam nekopírujete.
https://app-api.smsmanager.com/functions/v1/mcp
- Claude (desktop a web)
- Claude Code (CLI)
- Cursor
- Codex CLI
- ChatGPT
- V nastavení Claude přidejte vlastní konektor (custom connector).
- Jako adresu vložte endpoint našeho MCP serveru:https://app-api.smsmanager.com/functions/v1/mcp
- U přihlášení zvolte „Sign in now“ – server vyžaduje přihlášení.
- U OAuth klienta nechte „Register automatically“ (Dynamic Client Registration).
- Spusťte v terminálu:claude mcp add --transport http smsmanager https://app-api.smsmanager.com/functions/v1/mcp
- Pak v Claude Code zadejte /mcp a zvolte přihlášení.
- Přidejte server do souboru ~/.cursor/mcp.json (platí všude) nebo do .cursor/mcp.json v projektu:{"mcpServers": {"smsmanager": {"url": "https://app-api.smsmanager.com/functions/v1/mcp"}}}
- V Cursoru otevřete v postranním panelu Customize a server zapněte.
- Přihlášení proběhne přes OAuth. Klienta si Cursor zaregistruje sám (Dynamic Client Registration), takže do konfigurace nic dalšího nepatří.
- V terminálu přidejte server a přihlaste se:codex mcp add smsmanager --url https://app-api.smsmanager.com/functions/v1/mcpcodex mcp login smsmanager
- Totéž jde zapsat ručně do ~/.codex/config.toml:[mcp_servers.smsmanager]url = "https://app-api.smsmanager.com/functions/v1/mcp"
- V ChatGPT na webu zapněte v Settings → Apps → Advanced Settings režim pro vývojáře (developer mode).
- Pak v Settings → Apps zvolte Create a jako endpoint vložte adresu našeho MCP serveru:https://app-api.smsmanager.com/functions/v1/mcp
- Vyberte způsob ověření, klikněte na Scan Tools a dokončete přihlášení přes OAuth. ChatGPT pak načte seznam nástrojů.
Vlastní konektory zatím fungují jen na webu ChatGPT a na plánech Business a Enterprise/Edu.
Co se stane při připojení
Tři kroky, mezi kterými nemusíte nic vyplňovat ani nikam vkládat.
Přihlásíte se
Vyberete workspace
Nástroje jsou dostupné
Co MCP server umí
Patnáct nástrojů v pěti skupinách. Agent si sám vybere ten správný podle toho, co po něm chcete.
Identita a stav účtu
Kdo jste a jaký workspace spojení používá, stav aktivace účtu a konkrétní další krok k jejímu dokončení.
whoami, get_account_status
Odesílání a doručení
Odeslání SMS až deseti příjemcům, stav konkrétní zprávy, přehled odeslaných zpráv za den i přijaté zprávy.
send_message, get_message_status, list_messages, list_inbox
API klíče
Seznam podřízených klíčů („aplikací“) i vytvoření nového klíče pro konkrétní integraci, včetně rozsahu oprávnění.
list_apikeys, create_child_apikey
Kredit a fakturace
Zůstatek kreditu, fakturační údaje a pokyny k dobití převodem – číslo účtu, IBAN i variabilní symbol.
get_credit, get_billing_details, set_billing_details, get_topup_details
Placené služby
Katalog placených služeb s cenami za zřízení i provoz, objednávka odesílatele nebo virtuálního čísla a zrušení služby ke konci zaplaceného období.
list_services, order_service, cancel_service
Co po agentovi můžete chtít
Typické scénáře, které agent s připojeným MCP serverem zvládne od začátku do konce.
Odešli a zkontroluj doručení
Dobij kredit převodem
Objednej textového odesílatele
Doveď účet k aktivaci
Připrav klíč pro novou integraci
Co má agent pod kontrolou a co ne
- API klíč workspace se k modelu nikdy nedostane. Nástroje ho používají na naší straně – agent ho nevidí a nemůže ho nikam zkopírovat.
- Členství ve workspace se ověřuje při každém požadavku. Jakmile o přístup přijdete, spojení okamžitě přestane fungovat.
- Objednávka placené služby je ve výchozím stavu nezávazná kalkulace. Kredit se strhne až po výslovném potvrzení.
- Aktivaci účtu z chatu dokončit nelze. Ověření telefonního čísla vyžaduje prohlížeč, nástroje k němu jen připraví podklady.
- Jedno spojení = jeden workspace. Agent nikdy nevidí do workspace, který jste mu při připojení nevybrali.
Instalace Skills
Skills jsou balíčky znalostí, které si agent načte teprve ve chvíli, kdy je potřebuje. Vyberte si cestu podle toho, jakého agenta používáte.
- Claude Code (plugin)
- Skills CLI
- Ručně
/plugin marketplace add smsmngr/smsmanager-skills
/plugin install smsmanager-skills@smsmanager
Skills CLI funguje v Claude Code, Cursoru, Codexu i v desítkách dalších agentů:
npx skills add smsmngr/smsmanager-skills
Konkrétního agenta vyberete přepínačem --agent (zkráceně -a):
npx skills add smsmngr/smsmanager-skills -a cursor -a codex
- Stáhněte si repozitář:git clone https://github.com/smsmngr/smsmanager-skills.git
- Zkopírujte složky ze složky skills/ do adresáře se skills vašeho agenta, například ~/.claude/skills/.
Instalace nevyžaduje žádné přihlašovací údaje. Agent tím získá znalost našeho API – vlastní API klíč budete potřebovat, až budete chtít odeslat skutečnou zprávu.
Sedm skills v katalogu
Katalog ve verzi 0.3.0, licence Apache-2.0. Každý skill je krátký vstupní soubor, který si podrobnosti donačítá až podle potřeby.
| Skill | Oblast | Co umí |
|---|---|---|
smsmanager-authentication | Základ | Práce s API klíčem, základní adresy (JSON API v2 a REST API v1), hlavička x-api-key versus parametr apikey, řešení chyb 401 a 403. |
smsmanager-messaging-api | Zprávy | Odesílání SMS, Viber, WhatsApp a RCS – omnichannel flow, odesílatelé a aliasy, Unicode, plánování, dávky, tagy a vlastní metadata. |
smsmanager-delivery-reports | Zprávy | Webhooky pro doručenky, příchozí zprávy a odpovědi – callback URL, stavové i zamítací kódy, obousměrná komunikace. |
smsmanager-message-status | Zprávy | Zjišťování stavu zpráv, výpis odeslaných zpráv, statistiky za požadavek i za den a čtení doručené pošty přes REST API v1. |
smsmanager-optout-blacklist | Zprávy | Správa opt-out listu a blacklistu – přidávání a odebírání čísel, stažení seznamů v CSV. |
smsmanager-services | Účet | Objednávky placených služeb – textoví odesílatelé, virtuální čísla, SIM hosting – s nezávaznou kalkulací ceny, kontrola kreditu a rušení služeb. |
smsmanager-bulk-messaging | Zprávy | Hromadné odesílání ze souboru JSONL, validace zpráv bez odeslání a rušení naplánovaných zpráv i hromadných nahrání. |
Nejčastější dotazy
Jaký je vlastně rozdíl mezi Skills a MCP serverem?
Skills jsou znalost: naučí agenta, jak naše API funguje, aby uměl napsat správný kód. Sám o sobě neodešle nic.
MCP server je akce: agent se přes něj přihlásí k vašemu účtu a může v něm pracovat – odeslat zprávu, ověřit doručení, objednat odesílatele. Obojí jde používat najednou a vzájemně si nepřekáží.
Musím agentovi předat svůj API klíč?
Ne. Instalace Skills žádné přihlašovací údaje nepotřebuje – klíč budete potřebovat, až budete chtít odeslat skutečnou zprávu z vlastního kódu.
U MCP serveru se přihlašujete přes OAuth. Klíč workspace používáme na naší straně a modelu ho nikdy neukážeme.
Může agent utratit kredit bez mého vědomí?
Odeslané zprávy se z kreditu strhávají stejně jako při odesílání přes API nebo v aplikaci – proto agentovi zadávejte, co má odeslat, stejně pečlivě jako komukoli jinému.
U objednávek placených služeb je to přísnější: první volání je vždy nezávazná kalkulace a skutečná objednávka proběhne až po výslovném potvrzení.
Funguje MCP server i v jiných klientech než v Claude?
Ano. Server používá standardní transport Streamable HTTP a autorizaci OAuth 2.1, takže ho zvládne každý klient, který protokol MCP podporuje. Návody výše popisují Claude, Claude Code, Cursor, Codex CLI i vlastní konektor v ChatGPT – v ostatních klientech postupujete stejně, jen vložíte adresu jinam.
Jak přepnu spojení na jiný workspace?
Workspace se vybírá jednou, na obrazovce souhlasu, a spojení na něm zůstává. Pokud chcete jiný, odpojte nebo odvolejte aplikaci ve svém MCP klientovi, připojte se znovu a zvolte jiný workspace.
Kolik to stojí?
Za MCP server ani za Skills neplatíte nic navíc. Platíte jen odeslané zprávy a objednané placené služby – z kreditu workspace, stejně jako při odesílání přes API nebo v aplikaci.
Jsou Skills open source?
Ano, celý katalog je veřejný na GitHubu pod licencí Apache-2.0. Můžete si ho prohlédnout, forknout, nebo podle něj napsat vlastní skill pro svůj tým.
Může agent dokončit aktivaci účtu?
Ne celou. Umí zjistit, v jakém stavu aktivace je a co ještě chybí, a pomůže vám sepsat popis využití i vzorovou zprávu. Ověření telefonního čísla a odeslání ke schválení ale dokončíte v prohlížeči.
Propojte svého agenta se SmsManagerem
Registrace je zdarma a kredit nikdy neexpiruje. Skills nainstalujete jedním příkazem, MCP server připojíte vložením jedné adresy – a zprávy pak řešíte přímo v chatu se svým agentem.