Zum Hauptinhalt gehen

Verbinden Sie sich mit dem Sinch Engage MCP (AU)

Aktualisiert

Diese Anleitung behandelt, wie Sie sich mit dem Sinch Engage MCP-Server für die AU-Region verbinden: das Generieren von API-Zugangsdaten und das Hinzufügen des Servers in Claude Code über das Terminal.

Endpunkt

Diese Anleitung verwendet den Endpunkt der AU-Region:

https://au.app.api.sinch.com/mcp

Verwenden Sie den Endpunkt, der der Region entspricht, in der Ihr Engage-Konto bereitgestellt wird. Wenn sich Ihr Konto in der EU-Region befindet, folgen Sie stattdessen der EU-Anleitung. Wenn Sie sich bezüglich Ihrer Region nicht sicher sind, können Sie diese finden, indem Sie sich in Ihr Sinch Engage-Konto einloggen > zu den Einstellungen navigieren > API-Einstellungen - hier sehen Sie den Abschnitt "API & Webhook-Einstellungen", in dem Ihr regionsspezifischer Endpunkt angezeigt wird. 

API- & Webhook-Einstellungen_EN.PNG

Schritt 1: API-Zugangsdaten generieren (Basic-Authentifizierung)

Voraussetzungen

  • Sie müssen ein Konto-Administrator sein. Nutzer mit Basic- oder Advanced-Berechtigungen können keine API-Schlüssel erstellen oder verwalten.
  • Zugangsdaten können nur für ein verifiziertes Konto erstellt werden. Wenn Ihr Konto nicht verifiziert ist, fordern Sie zunächst eine Verifizierung an.

Schritte

  1. Melden Sie sich bei Ihrem Sinch Engage-Konto an 
  2. Navigieren Sie zu Einstellungen > API-Einstellungen, scrollen Sie zu Basic-Authentifizierung und klicken Sie auf Neuen Schlüssel erstellen.
  3. Geben Sie einen aussagekräftigen Namen ein und klicken Sie auf Schlüssel erstellen.
  4. Kopieren Sie im Bestätigungsfenster die Base64-codierten Zugangsdaten und klicken Sie dann auf OK. Dies ist der Wert, den Sie direkt nach Basic in die Authorization-Kopfzeile einfügen.

Die Zugangsdaten werden nur einmal angezeigt. Speichern Sie sie sofort an einem sicheren Ort. Wenn Sie sie verlieren, müssen Sie einen neuen Schlüssel erstellen.

Weitere Informationen finden Sie in der vollständigen Anleitung unter Neue API-Zugangsdaten erstellen.

Schritt 2: Claude Code installieren und starten

Claude Code ist der Assistent von Anthropic, der im Terminal Ihres Computers ausgeführt wird. Das Terminal ist eine integrierte App, mit der Sie Anweisungen in Ihren Computer eingeben können. Sie müssen diese Einrichtung nur einmal durchführen.

Voraussetzungen

  • Sie benötigen ein kostenpflichtiges Claude-Abonnement (Pro, Max, Team oder Enterprise). Das kostenlose Abonnement enthält kein Claude Code.
  • Sie benötigen eine Internetverbindung.

Schritte

  1. Öffnen Sie das Terminal.
    • Mac: Drücken Sie Cmd + Leertaste, geben Sie Terminal ein und drücken Sie die Eingabetaste.
    • Windows: Klicken Sie auf das Startmenü, geben Sie PowerShell ein und öffnen Sie es.

  2. Installieren Sie Claude Code. Kopieren Sie die für Ihren Computer passende Zeile, fügen Sie sie in das Terminal ein und drücken Sie die Eingabetaste. Die Installation dauert ein paar Minuten und erfordert keine vorherige Installation anderer Komponenten.

    • Mac:

      bash

    • curl -fsSL https://claude.ai/install.sh | bash

    • Windows (PowerShell):

      powershell

    • irm https://claude.ai/install.ps1 | iex

    • Wenn ein Befehl nicht funktioniert, rufen Sie den aktuellen Installationsbefehl von der offiziellen Einrichtungsseite (siehe Link oben) ab, da sich diese ändern können.

  3. Anmelden. Geben Sie das untenstehende Wort ein und drücken Sie die Eingabetaste:

    • bash

  4. claude

    • Beim ersten Mal öffnet sich ein Browserfenster, in dem Sie aufgefordert werden, sich in Ihrem Claude-Konto anzumelden. Melden Sie sich an und kehren Sie dann zum Terminal zurück.

  5. Kehren Sie zum einfachen Terminal zurück.

    • Sobald Sie angemeldet sind, geben Sie /exit ein und drücken Sie die Eingabetaste, um Claude Code zu verlassen und zur normalen Terminal-Eingabeaufforderung zurückzukehren. Sie sind nun bereit, in Schritt 3 eine Verbindung zum Engage-Server herzustellen.

      • Tipp: Wenn Sie jemals claude: command not found sehen, schließen Sie das Terminalfenster, öffnen Sie ein neues und versuchen Sie es erneut.

    • Detaillierte Anweisungen für Claude Code im Terminal finden Sie hier: https://docs.claude.com/en/docs/claude-code/setup

Schritt 3: Verbinden Sie sich über Claude Code im Terminal

Verwenden Sie den Befehl claude mcp add in Ihrer Befehlszeilenschnittstelle.

Ersetzen Sie <your-credential> durch die Base64-Anmeldeinformation aus Schritt 1. Alle Flags müssen vor dem Servernamen stehen.

claude mcp add --transport http sinch-engage-au https://au.app.api.sinch.com/mcp \
  --header "Authorization: Basic <Ihre-Zugangsdaten>"

Fügen Sie --scope user hinzu, um den Server projektübergreifend verfügbar zu machen, oder --scope project, um ihn über eine eingecheckte .mcp.json mit einem Team zu teilen. Der Standardbereich (local) ist für Sie im aktuellen Projekt privat.

Die CLI schwärzt die Kopfzeile in ihrer Bestätigungsausgabe, sodass die Anmeldeinformation nicht in der Scrollback-Historie Ihrer Shell landet.

Alternative: add-json

claude mcp add-json sinch-engage-au '{"type":"http","url":"https://au.app.api.sinch.com/mcp","headers":{"Authorization":"Basic <Ihre-Zugangsdaten>"}}'

Um die Anmeldeinformation aus einer eingecheckten Datei herauszuhalten, referenzieren Sie eine Umgebungsvariable, anstatt sie hart zu codieren:

"headers": {
  "Authorization": "Basic ${SINCH_ENGAGE_CREDENTIAL}"
}

Überprüfen Sie dies mit claude mcp list im Terminal oder /mcp innerhalb einer Claude-Code-Sitzung.

Weitere Informationen zum Verbinden von MCP mit Claude Code finden Sie in diesem Artikel hier: https://code.claude.com/docs/en/mcp 

Fehlerbehebung

  • Verbindung schlägt in Claude Code sofort fehl: Wenn Sie eine statische Authorization-Kopfzeile konfiguriert haben und der Server diese ablehnt, meldet Claude Code die Verbindung als fehlgeschlagen, anstatt auf OAuth zurückzugreifen. Überprüfen Sie erneut, ob die Zugangsdaten vollständig eingefügt wurden (keine führenden/nachgestellten Leerzeichen) und ob es sich um Zugangsdaten der AU-Region handelt.
  • error: missing required argument 'name': Ein Flag (z. B. --header) wurde nach dem Servernamen platziert. Alle Optionen müssen vor dem Namen stehen.
  • Falsche Region: Diese Anleitung verwendet den AU-Endpunkt. Mit EU-Zugangsdaten ist keine Authentifizierung möglich. EU-Kunden sollten die EU-Anleitung verwenden.
  • Verlorene Anmeldeinformation: Die Anmeldeinformation wird nur einmal angezeigt. Erstellen Sie einen neuen Schlüssel, wenn die Anmeldeinformation nicht gespeichert wurde.

Sicherheitshinweise

  • Behandeln Sie die Anmeldeinformation wie ein Passwort. Checken Sie sie nicht in die Versionskontrolle ein. Verwenden Sie die Erweiterung von Umgebungsvariablen in gemeinsam genutzten Konfigurationsdateien.
  • Rotieren Sie Anmeldeinformationen, falls sie offengelegt worden sein könnten (zum Beispiel in einem freigegebenen Repository oder Protokoll eingefügt).

Verknüpfung mit

Verwandte Beiträge