Sinch MCP-Server — Developer Preview

Dieses Repository enthält den Quellcode für den Sinch MCP-Server, der eine Reihe von Tools zur Interaktion mit den Sinch-APIs bereitstellt. Diese README konzentriert sich auf die Verwendung des MCP-Servers mit dem Claude Desktop-Client, er kann jedoch auch mit jedem anderen MCP-Client verwendet werden.

Tool-Übersicht

Hier ist die Liste der im MCP-Server verfügbaren Tools (alle Telefonnummern müssen im E.164-Format angegeben werden, z. B. +33612345678 für Frankreich).

Konversations-Tools

E-Mail-Tools (Mailgun)

Verifizierungs-Tools

Sprach-Tools

Nummern-Tools

Konfigurations-Tools

Related MCP server: SendGrid MCP Server

Erste Schritte

Voraussetzungen

• Node.js 20.x oder 22.x (LTS)

• Ein bereitgestelltes Sinch Build-Konto

• Claude Desktop (oder ein anderer MCP-Client). Diese README konzentriert sich auf Claude Desktop, aber der MCP-Server kann mit jedem MCP-Client verwendet werden.

API-Anmeldedaten

Um die von den MCP-Tools verwendeten APIs zu nutzen, benötigen Sie die folgenden Anmeldedaten:

• Konversations- / Nummern-API-Anmeldedaten:

  • (Erforderlich) PROJECT_ID: Wählen Sie das Projekt aus, das Sie verwenden möchten, aus Ihrem Sinch Build-Dashboard (befindet sich links in der oberen Symbolleiste)

  • (Erforderlich) KEY_ID: Wählen Sie einen neuen Zugriffsschlüssel im Abschnitt Zugriffsschlüssel des Sinch Build-Dashboards aus oder erstellen Sie einen neuen.

  • (Erforderlich) KEY_SECRET: Dies ist das Geheimnis, das mit dem Access Key verknüpft ist, den Sie im vorherigen Schritt ausgewählt oder erstellt haben. Seien Sie vorsichtig, das Access Key Secret wird nur einmal angezeigt, wenn Sie den Access Key erstellen. Wenn Sie es verlieren, müssen Sie einen neuen Access Key erstellen.

  • CONVERSATION_APP_ID: Dies ist die ID der Konversations-App, die Sie verwenden möchten. Sie finden sie im Abschnitt Konversations-API / Apps des Sinch Build-Dashboards. Wenn Sie sie nicht festlegen, müssen Sie sie im Prompt angeben.

  • CONVERSATION_REGION: Dies ist die Region, in der sich Ihre Konversations-App und Ihre Vorlagen befinden. Sie kann us, eu oder br sein. Wenn Sie sie nicht festlegen, ist der Standardwert us.

  • Bei Verwendung des SMS-Kanals können Sie auch die Umgebungsvariable DEFAULT_SMS_ORIGINATOR auf die Telefonnummer setzen, die als Absender für SMS-Nachrichten verwendet wird. Abhängig von Ihrem Land kann diese Einstellung erforderlich sein.

  • Sie können auch die Umgebungsvariable GEOCODING_API_KEY auf Ihren Google Geocoding API-Schlüssel setzen, wenn Sie die Standortfunktion nutzen möchten. Dies ist erforderlich, um eine Adresse in ein Breiten-/Längengrad-Paar umzuwandeln.

• Verifizierungs-API-Anmeldedaten: Navigieren Sie zum Abschnitt Verifizierung / Apps des Sinch Build-Dashboards und erstellen Sie eine neue App oder wählen Sie eine bestehende aus. Sie benötigen die folgenden Anmeldedaten:

  • (Erforderlich) APPLICATION_KEY

  • (Erforderlich) APPLICATION_SECRET

• Sprach-API-Anmeldedaten: Navigieren Sie zum Abschnitt Sprache / Apps des Sinch Build-Dashboards und erstellen Sie eine neue App oder wählen Sie eine bestehende aus. Sie benötigen die folgenden Anmeldedaten:

  • (Erforderlich) APPLICATION_KEY

  • (Erforderlich) APPLICATION_SECRET

  • Sie können auch die Umgebungsvariable CALLING_LINE_IDENTIFICATION auf die Telefonnummer setzen, die dem Benutzer angezeigt wird, wenn er einen Anruf erhält.

• Mailgun-API-Anmeldedaten: Navigieren Sie zum Abschnitt Mailgun / Domains des Mailgun-Dashboards und erstellen Sie eine neue Domain oder wählen Sie eine bestehende aus. Sie benötigen die folgenden Anmeldedaten:

  • (Erforderlich) MAILGUN_API_KEY

  • MAILGUN_DOMAIN

  • MAILGUN_SENDER_ADDRESS

MCP-Server-Konfiguration

Der Sinch MCP-Server ist als NPM-Paket zur Ausführung verfügbar. Hier erfahren Sie, wie Sie ihn in der Konfigurationsdatei (claude_desktop_config.json) von Claude Desktop einrichten. Denken Sie daran, die Umgebungsvariablen mit Ihren eigenen Anmeldedaten auszufüllen:

{
  "mcpServers": {
    "sinch": {
      "command": "npx",
      "args": [
        "-y",
        "@sinch/mcp"
      ],
      "env": {
        "PROJECT_ID": "",
        "KEY_ID": "",
        "KEY_SECRET": "",
        "CONVERSATION_APP_ID": "",
        "CONVERSATION_REGION": "",
        "DEFAULT_SMS_ORIGINATOR": "",
        "GEOCODING_API_KEY": "",
        "APPLICATION_KEY": "",
        "APPLICATION_SECRET": "",
        "CALLING_LINE_IDENTIFICATION": "",
        "MAILGUN_API_KEY": "",
        "MAILGUN_DOMAIN": "",
        "MAILGUN_SENDER_ADDRESS": ""
      }
    }
  }
}

Lokales Ausführen des MCP-Servers

Option 1: Starten des MCP-Servers mit stdio unter Verwendung von Claude Desktop

Um den MCP-Server lokal mit Claude Desktop auszuführen, müssen Sie das Repository klonen und den MCP-Server erstellen. Diese Option ist nützlich für die lokale Entwicklung und das Testen.

Schritt 1: Klonen des Repositorys

git clone https://github.com/sinch/sinch-mcp-server.git

Schritt 2: Erstellen des MCP-Servers

cd sinch-mcp-server
npm install
npm run build

Schritt 3: Einrichten der Claude Desktop-Konfiguration

Hier ist ein Beispiel, wie Sie den MCP-Server in der Konfigurationsdatei (claude_desktop_config.json) von Claude Desktop konfigurieren:

{
  "mcpServers": {
    "sinch": {
      "command": "node",
      "args": [
        "/your/path/to/sinch-mcp-server/dist/index.js"
      ],
      "env": {
        "PROJECT_ID": "",
        "KEY_ID": "",
        "KEY_SECRET": "",
        "CONVERSATION_APP_ID": "",
        "CONVERSATION_REGION": "",
        "DEFAULT_SMS_ORIGINATOR": "",
        "GEOCODING_API_KEY": "",
        "APPLICATION_KEY": "",
        "APPLICATION_SECRET": "",
        "CALLING_LINE_IDENTIFICATION": "",
        "MAILGUN_API_KEY": "",
        "MAILGUN_DOMAIN": "",
        "MAILGUN_SENDER_ADDRESS": ""
      }
    }
  }
}

Schritt 4: (Optional) Filtern der im MCP-Server verfügbaren Tools

Zu viele Tools bedeuten einen größeren Kontext, eine höhere Token-Nutzung und mehr Verwirrung für das LLM bei der Auswahl des richtigen Tools. Sie können die im MCP-Server verfügbaren Tools mithilfe der tags-Optionen filtern. Wenn Sie beispielsweise nur die Konversations-Tools verwenden möchten, können Sie dem args-Array die folgenden Optionen hinzufügen:

      "args": [
        "/your/path/to/sinch-mcp-server/dist/index.js",
        "--tags", 
        "conversation"
      ],

Sie können mehrere Tags kombinieren, indem Sie sie durch Kommas trennen. Wenn Sie beispielsweise sowohl Konversations- als auch Verifizierungs-Tools verwenden möchten, können Sie den folgenden Befehl verwenden:

      "args": [
        "/your/path/to/sinch-mcp-server/dist/index.js",
        "--tags", 
        "conversation,verification"
      ],

Wenn Sie alle Tools verwenden möchten, können Sie die Option --tags weglassen oder das Tag all verwenden:

      "args": [
        "/your/path/to/sinch-mcp-server/dist/index.js",
        "--tags", 
        "all"
      ],

Option 2: Starten des MCP-Servers aus der Ferne und Verbinden mittels SSE

Mit dieser Option können Sie den MCP-Server auf einem Remote-Rechner ausführen und sich über Server-Sent Events (SSE) mit ihm verbinden. Dies ist nützlich, wenn Sie den MCP-Server auf einem Cloud-Server oder einem dedizierten Rechner ausführen möchten. Standardmäßig verbindet sich Claude Desktop über STDIO mit dem MCP-Server; wir verwenden die supergateway-Bibliothek, um uns über SSE mit dem MCP-Server zu verbinden.

Schritt 1: Erstellen des MCP-Servers

cd sinch-mcp-server
npm install
npm run build

Schritt 2: Einrichten der MCP-Server-Konfiguration

Kopieren Sie die Datei .template.env und benennen Sie sie in .env um. Ersetzen Sie dann die Platzhalter durch Ihre eigenen Anmeldedaten und löschen Sie alle Schlüssel, die Sie nicht benötigen. Die .env-Datei sollte wie folgt aussehen ():

# Conversation / Numbers tools related environment variables
PROJECT_ID=
KEY_ID=
KEY_SECRET=
## Optional but recommended: the App ID holding your channels integration configuration. If not set it must be present in the prompt
CONVERSATION_APP_ID=
## Optional, defaults to "us". Other possible values are "eu" and "br"
CONVERSATION_REGION=
## Needed only if you want to send SMS messages: it is the number that will be used as the sender for SMS messages
DEFAULT_SMS_ORIGINATOR=
## Needed only if you want to send location messages: it converts an address to a latitude/longitude pair
GEOCODING_API_KEY=

# Verification / Voice tools related environment variables
APPLICATION_KEY=
APPLICATION_SECRET=
## Needed only if you want to make calls: it is the number that will be displayed to the user when they receive a call
CALLING_LINE_IDENTIFICATION=

# Mailgun tools related environment variables
MAILGUN_DOMAIN=
MAILGUN_API_KEY=
MAILGUN_SENDER_ADDRESS=

Schritt 3: Starten des MCP-Servers

npm run start:stdio

Standardmäßig startet dieser Befehl den MCP mit allen verfügbaren Tools