MCP

engagelab-sms-mcp ist ein MCP-Server (Model Context Protocol), der es KI-Assistenten ermöglicht, SMS über die EngageLab-Plattform zu senden. Durch das Hinzufügen dieses Servers zu MCP-fähigen Clients (wie Cursor, Claude Desktop usw.) kann die KI in Ihrem Auftrag vorlagenbasierte SMS-Sendevorgänge ausführen.

Voraussetzungen

Node.js 18+
Ein EngageLab-Konto und SMS-API-Anmeldedaten (dev_key und dev_secret) erworben
Mindestens eine genehmigte SMS-Vorlage

Tipp: API-Anmeldedaten können auf der Seite API Key in der EngageLab-Konsole erstellt und verwaltet werden.

Konfigurationsmethode

Cursor

Gehen Sie zu Settings > MCP, klicken Sie auf Add new MCP server und fügen Sie die 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 Anmeldedaten, die Sie aus Ihrer EngageLab-Konsole erhalten haben.

Claude Desktop

Öffnen Sie Settings > Developer > Edit Config und fügen Sie zu mcpServers hinzu:

{ "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, der den stdio-Transport unterstützt, kann diesen Server verwenden. Setzen Sie den Startbefehl auf npx -y engagelab-sms-mcp und übergeben Sie die erforderlichen Umgebungsvariablen.

Verfügbare Tools

send_sms

Senden Sie eine SMS über EngageLab mit einer vorab genehmigten Vorlage.

Anfrageparameter:

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

Anfragebeispiel:

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

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

Diesen Codeblock im schwebenden Fenster anzeigen

Antwortparameter:

Feld	Typ	Beschreibung
success	boolean	Ob die Anfrage akzeptiert wurde
plan_id	string	EngageLab-Plan-ID, zur Nachverfolgung verwendet
total_count	number	Gesamtzahl der eingereichten Empfänger
accepted_count	number	Anzahl der zur Zustellung akzeptierten Empfänger
message_id	string	Nachrichtenkennung (falls verfügbar)
message	string	Status- oder Fehlerbeschreibung
code	number	EngageLab-Antwortcode (0 bedeutet Erfolg)

Umgebungsvariablen

Variable	Erforderlich	Standard	Beschreibung
ENGAGELAB_DEV_KEY	Ja	—	EngageLab dev key
ENGAGELAB_DEV_SECRET	Ja	—	EngageLab dev secret
ENGAGELAB_BASE_URL	Nein	`https://smsapi.engagelab.com`	Basis-API-URL
ENGAGELAB_REQUEST_TIMEOUT_MS	Nein	`10000`	Anfrage-Timeout (ms)
ENGAGELAB_MAX_RETRIES	Nein	`1`	Max. Wiederholungen bei Fehlern

Häufig gestellte Fragen

Der Server startet nicht und zeigt „Missing required environment variable“ an

Stellen Sie sicher, dass Sie ENGAGELAB_DEV_KEY und ENGAGELAB_DEV_SECRET in der env-Konfiguration Ihres MCP-Clients korrekt ausgefüllt haben.

send_sms gibt den Fehlercode 3002 zurück („invalid template id format“)

Überprüfen Sie, ob die Vorlagen-ID perfekt mit einer genehmigten Vorlagen-ID in Ihrer EngageLab-Konsole übereinstimmt.

send_sms gibt Fehler im Zusammenhang mit Vorlagenparametern zurück

Stellen Sie sicher, dass die Schlüsselnamen innerhalb von template.params exakt mit den in Ihrer EngageLab-Vorlage definierten Variablennamen übereinstimmen.

SMS nicht erhalten

Stellen Sie sicher, dass Sie internationale Telefonnummernformate verwenden (z. B. +6581234567).
Vergewissern Sie sich, dass Ihre Vorlage genehmigt und nicht deaktiviert wurde.