MCP-Server
SMS aus KI-Assistenten
Das Model Context Protocol (MCP) ist der Standard, über den KI-Assistenten Werkzeuge aufrufen. Mit dem offiziellen TopSMS-MCP-Server sagen Sie Claude, Cursor oder einem anderen Assistenten „Schick dem Kunden eine SMS, dass die Bestellung unterwegs ist“, und er erledigt das über Ihr TopSMS-Kundenkonto, inklusive Prüfung von Zustellung und Guthaben.
Was er kann
- send_sms: sendet eine SMS an eine Rufnummer, optional mit Ihrem freigegebenen Absendernamen, sofort oder zeitgesteuert (
send_at) - send_bulk_sms: derselbe Text an bis zu 500 Rufnummern, große Stapel werden in die Warteschlange eingereiht
- get_message_status und get_bulk_job: Zustellstatus einer Nachricht (einschließlich Grund der Nichtzustellung
errorCode) und Fortschritt eines Stapels - cancel_scheduled: storniert einen geplanten Versand und erstattet das Guthaben
- verify_send und verify_check: sendet einen Bestätigungscode (OTP) und prüft ihn, siehe Verify API
- get_credit: Guthabenstand und Preis pro SMS
- get_pricing: öffentliche Preisliste (ohne Anmeldung)
Der Server ruft dieselbe REST-API auf wie Ihre Anwendung, es gelten also dieselben Preise, Limits und Abrechnungsregeln. Die Versandwerkzeuge akzeptieren einen optionalen idempotencyKey: Wiederholt der Assistent einen Aufruf, wird die SMS nicht doppelt gesendet. Paket: npmjs.com/package/topsms-mcp.
Installation in Claude Desktop, Cursor und anderen
Erstellen Sie im Dashboard im Bereich API-Schlüssel einen API-Schlüssel mit den Scopes send und read und tragen Sie ihn in die Konfiguration Ihres MCP-Clients ein:
{
"mcpServers": {
"topsms": {
"command": "npx",
"args": ["-y", "topsms-mcp"],
"env": {
"TOPSMS_CLIENT_ID": "ihre-client-id",
"TOPSMS_SECRET": "ihr-secret"
}
}
}
}Claude Code mit einem einzigen Befehl:
claude mcp add topsms -e TOPSMS_CLIENT_ID=... -e TOPSMS_SECRET=... -- npx -y topsms-mcp
Sie benötigen Node.js 18 oder neuer. Cursor, Windsurf und VS Code verwenden dasselbe Konfigurationsformat.
Sicherheit und Kosten
- Jeder Versand verbraucht echtes Guthaben. Lassen Sie im Client die Bestätigung von Werkzeugaufrufen aktiviert, dann fragt der Assistent vor dem Senden nach.
- Erstellen Sie für den KI-Assistenten einen eigenen API-Schlüssel. Im Dashboard sehen Sie seinen Verbrauch getrennt und können ihn jederzeit widerrufen.
- Der Schlüssel bleibt auf Ihrem Rechner in der Client-Konfiguration; der Server sendet ihn nur an www.topsms.cz.
- Für wiederkehrende Automatisierungen ohne KI sind Make oder direkt die REST-API die bessere Wahl.