ClickSend MCP Server

Dies ist der offizielle ClickSend MCP Server vom ClickSend-Team. Verwenden Sie aus Sicherheitsgründen keine inoffiziellen Versionen von ClickSend MCP.

Zweck

ClickSend MCP ist dazu gedacht, die Messaging-Fähigkeiten von ClickSend auf moderne KI-Ökosysteme und Plattformen auszuweiten – so können Entwickler ganz einfach SMS über ClickSend senden, ohne benutzerdefinierten Code schreiben zu müssen.

Das beschleunigt die Einführung, ermöglicht neue KI-gesteuerte Anwendungsfälle und positioniert ClickSend im Zeitalter intelligenter Automatisierung als zukunftsfähige Messaging-Plattform.

Related MCP server: Twilio MCP Server

Anforderungen

• Node.js >= 18

  • Sie können nvm (Node Version Manager) verwenden, um die richtige Version zum Ausführen dieser Anwendung einzustellen.

Installation

Laden Sie einen KI-Desktop-Client herunter. Ein Beispiel wäre Claude for Desktop, das Sie hier herunterladen können.

Konfiguration

Der Server benötigt zwei Umgebungsvariablen:

• CLICKSEND_USERNAME: Ihr ClickSend-Benutzername

• CLICKSEND_API_KEY: Ihr ClickSend-API-Schlüssel

Benutzername und Schlüssel finden Sie unter https://dashboard.clicksend.com/account/subaccounts, sobald Sie sich bei ClickSend angemeldet haben.

Claude-Desktop-Konfiguration

• Öffnen Sie Claude for Desktop.

• Gehen Sie in der Menüleiste des Systems zu Einstellungen.

• Navigieren Sie im Einstellungsfenster zum Reiter Entwickler und klicken Sie auf Config bearbeiten. Dadurch wird die Konfigurationsdatei an folgendem Speicherort geöffnet:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

• Mit dem NPM-Paket

{
  "mcpServers": {
    "clicksend": {
      "command": "npx",
      "args": [
        "-y",
        "@clicksend/clicksend-mcp-server@latest"
      ],
      "env": { 
        "CLICKSEND_USERNAME": "<username>",
         "CLICKSEND_API_KEY": "<api-key>"
      }
    }
  }
}

• Mit einem lokalen Build

{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "/path/to/repository/build/clicksend-mcp.js"
      ],
      "env": {
        "CLICKSEND_USERNAME": "your clicksend username",
        "CLICKSEND_API_KEY": "your API Key"
      }
    }
  }
}

Starten Sie danach Claude Desktop neu, um die Konfiguration neu zu laden. Wenn die Verbindung erfolgreich hergestellt wurde, sollte clicksend-send-sms sichtbar sein, sobald Sie auf das Hammer-Symbol klicken.

Beispiele für Interaktionen mit Claude

Hier sind einige natürliche Möglichkeiten, mit dem Server über Claude zu interagieren:

Einfache SMS:

Send a text message to the number 61411111111 saying "I'm using ClickSend MCP server to sent SMS!"

Funktionen

• Senden Sie eine SMS nach der anderen, indem Sie den ClickSend-Benutzernamen und den API-Schlüssel konfigurieren.

• Preis für eine Nachricht an eine Kontaktliste abrufen.

• Kontakte oder Kontaktlisten durchsuchen und Nachrichten an diese senden.

• SMS-Vorlagen abrufen und damit Nachrichten senden.

• SMS-Verlauf anzeigen/abrufen.

• SMS-Statistiken der letzten 30 Tage abrufen.

Unterstütze APIs

1. POST /v3/sms/send

• Geänderungs-ID: send-sms

• Zusammenfassung: SMS senden

• Beschreibung: Nachricht an den Empfänger, entweder als Telefonnummern oder als Kontakte aus einer Kontaktliste.

2. POST /v3/sms/price

• Operation-ID: calculate-sms-price

• Zusammenfassung: SMS-Preis berechnen

• Beschreibung: Berechnet den Preis für das Senden von Nachrichten basierend auf Nachrichtentyp und -länge.

3. GET /v3/sms/templates

• Operation-ID: view-sms-templates

• Zusammenfassung: SMS-Vorlagen anzeigen

• Beschreibung: SMS-Vorlagen mit Filtermöglichkeiten abrufen.

4. GET /v3/sms/history

• Operation-ID: view-sms-history

• Zusammenfassung: SMS-Verlauf anzeigen

• Beschreibung: Zeigt zuvor gesendete SMS mit Filter- und Paginierungsoptionen an.

5. GET /v3/statistics/sms

• Operation-ID: view-sms-statistics

• Zusammenfassung: SMS-Statistiken anzeigen

• Beschreibung: SMS-Statistiken für die letzten 30 Jahre abrufen.

6. GET /v3/search/contacts-lists

• Operation-ID: view-contact-lists

• Zusammenfassung: Kontaktlisten anzeigen

• Beschreibung: Eine Liste durchsuchter Kontaktlisten abrufen.

Wichtige Hinweise

1. Telefonnummernformat: Alle Telefonnummern müssen im E.164-Format angegeben sein (z. B. +61411111111).

2. Rate-Limits: Beachten Sie die Rate-Limits und Preise Ihres ClickSend-Kontos.

3. Sicherheit: Bewahren Sie Ihre ClickSend-Zugangsdaten sicher auf und geben Sie sie niemals in die Versionskontrolle.

Fehlerbehebung

Häufige Fehlermeldungen und Lösungen:

1. „Telefonnummer muss im E.164-Format angegeben werden."

   • Stellen Sie sicher, dass die Telefonnummer mit „+" und der Ländervorwahl beginnt.

2. „Ungültige Zugangsdaten"

   • Überprüfen Sie Ihre CLICKSEND_USERNAME- und CLICKSEND_API_KEY-Werte. Sie können sie aus dem ClickSend-Dashboard kopieren.

Beiträge

Beiträge sind willkommen! Bitte lesen Sie unsere Richtlinien für Beiträge, bevor Sie Pull Requests einreichen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der LICENSE-Datei.

Sicherheit

Bitte keine sensiblen Informationen (z. B. Telefonnummern oder ClickSend-Anmeldedaten) in GitHub Issues oder Pull Requests einfügen.