MCP

engagelab-sms-mcp ist ein MCP-Server (Model Context Protocol), mit dem KI-Assistenten SMS über die EngageLab-Plattform versenden können. Nach dem Hinzufügen zu einem MCP-kompatiblen Client (z. B. Cursor, Claude Desktop usw.) kann die KI in Ihrem Namen vorlagenbasierte SMS senden.

Voraussetzungen

Node.js 18+
Ein EngageLab-Konto mit SMS-API-Zugangsdaten (dev_key und dev_secret)
Mindestens eine freigegebene SMS-Vorlage

Hinweis: API-Zugangsdaten können auf der Seite API-Schlüssel in der EngageLab-Konsole erstellt und verwaltet werden.

Konfiguration

Cursor

Öffnen Sie Einstellungen > MCP, klicken Sie auf Neuen MCP-Server hinzufügen und fügen Sie folgende Konfiguration ein:

{ "mcpServers": { "engagelab-sms": { "command": "npx", "args": ["-y", "engagelab-sms-mcp"], "env": { "ENGAGELAB_DEV_KEY": "<your_dev_key>", "ENGAGELAB_DEV_SECRET": "<your_dev_secret>" } } } }

              
              {
  "mcpServers": {
    "engagelab-sms": {
      "command": "npx",
      "args": ["-y", "engagelab-sms-mcp"],
      "env": {
        "ENGAGELAB_DEV_KEY": "<your_dev_key>",
        "ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
      }
    }
  }
}

Diesen Codeblock im schwebenden Fenster anzeigen

Ersetzen Sie <your_dev_key> und <your_dev_secret> durch die tatsächlichen Zugangsdaten aus der EngageLab-Konsole.

Claude Desktop

Öffnen Sie Einstellungen > Entwickler > Konfiguration bearbeiten und ergänzen Sie mcpServers um Folgendes:

{ "mcpServers": { "engagelab-sms": { "command": "npx", "args": ["-y", "engagelab-sms-mcp"], "env": { "ENGAGELAB_DEV_KEY": "<your_dev_key>", "ENGAGELAB_DEV_SECRET": "<your_dev_secret>" } } } }

              
              {
  "mcpServers": {
    "engagelab-sms": {
      "command": "npx",
      "args": ["-y", "engagelab-sms-mcp"],
      "env": {
        "ENGAGELAB_DEV_KEY": "<your_dev_key>",
        "ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
      }
    }
  }
}

Diesen Codeblock im schwebenden Fenster anzeigen

Andere MCP-Clients

Jeder MCP-Client mit Unterstützung für stdio-Transport kann diesen Server nutzen. Legen Sie den Befehl auf npx -y engagelab-sms-mcp fest und übergeben Sie die erforderlichen Umgebungsvariablen.

Verfügbare Tools

send_sms

Sendet SMS über EngageLab mithilfe einer freigegebenen Vorlage.

Anfrageparameter:

Feld	Typ	Erforderlich	Beschreibung
to	string[]	Ja	Liste der Zielrufnummern (internationales Format empfohlen, z. B. `+8618700001111`)
template.id	string	Ja	Freigegebene EngageLab-SMS-Vorlagen-ID
template.params	object	Ja	Werte für Vorlagenvariablen, z. B. `{"code": "123456"}`

Beispielanfrage:

{ "to": ["+8618700001111"], "template": { "id": "your-template-id", "params": { "code": "123456" } } }

              
              {
  "to": ["+8618700001111"],
  "template": {
    "id": "your-template-id",
    "params": {
      "code": "123456"
    }
  }
}

Diesen Codeblock im schwebenden Fenster anzeigen

Antwortparameter:

Feld	Typ	Beschreibung
success	boolean	Ob die Anfrage angenommen wurde
plan_id	string	EngageLab-Plan-ID zur Nachverfolgung
total_count	number	Gesamtzahl der übermittelten Empfänger
accepted_count	number	Anzahl der für den Versand akzeptierten Empfänger
message_id	string	Nachrichtenkennung (falls verfügbar)
message	string	Status- oder Fehlerbeschreibung
code	number	EngageLab-Antwortcode (0 = Erfolg)

Umgebungsvariablen

Variable	Erforderlich	Standard	Beschreibung
ENGAGELAB_DEV_KEY	Ja	—	EngageLab-Entwicklerschlüssel
ENGAGELAB_DEV_SECRET	Ja	—	EngageLab-Entwicklergeheimnis
ENGAGELAB_BASE_URL	Nein	`https://smsapi.engagelab.com`	API-Basis-URL
ENGAGELAB_REQUEST_TIMEOUT_MS	Nein	`10000`	Anfrage-Timeout in Millisekunden
ENGAGELAB_MAX_RETRIES	Nein	`1`	Maximale Wiederholungsversuche bei Fehlern

Fehlerbehebung

Server startet nicht mit „Missing required environment variable“

Stellen Sie sicher, dass ENGAGELAB_DEV_KEY und ENGAGELAB_DEV_SECRET im env-Block Ihrer MCP-Client-Konfiguration korrekt gesetzt sind.

send_sms liefert Fehlercode 3002 („invalid template id format“)

Prüfen Sie, ob die Vorlagen-ID mit einer freigegebenen Vorlage in der EngageLab-Konsole übereinstimmt.

send_sms liefert Fehler zu Vorlagenparametern

Vergewissern Sie sich, dass die Schlüssel in template.params exakt den in Ihrer EngageLab-Vorlage definierten Variablennamen entsprechen.

SMS wird nicht empfangen

Verwenden Sie internationales Rufnummernformat (z. B. +8618700001111).
Prüfen Sie, ob die Vorlage freigegeben und nicht gesperrt ist.