Zum Inhalt springen
OmniChannels.ai

KI-Assistenten und Agenten

Claude Code + OmniChannels.ai: Messaging im Terminal entwickeln und testen

Verbindung über MCPVerbindung über API & WebhooksAktualisiert

Kurze Antwort

Claude Code verbindet sich mit einem einzigen Befehl mit OmniChannels.ai: claude mcp add --transport http mit Ziel https://mcp.broadnet.me/mcp und einem Authorization: Bearer-Header. Danach kann es Testnachrichten senden, WhatsApp-Vorlagen auflisten und Zustellberichte lesen, während es Ihren Integrationscode auf Basis unserer OpenAPI-3.1-Spezifikation schreibt. Teams teilen den Server über .mcp.json, und Berechtigungsregeln legen fest, welche Tools ohne Rückfrage laufen.

Was Sie damit tun können

  • Code auf Basis der echten Vorlagen

    Claude Code liest Ihre freigegebenen WhatsApp-Vorlagen über MCP und schreibt eine Funktion mit genau den Variablen, die jede Vorlage braucht.

    Beispielanfrage

    “Nutze die omnichannels-Tools, um meine freigegebenen WhatsApp-Vorlagen aufzulisten, und schreib dann eine TypeScript-Funktion, die order_update mit den nötigen Feldern sendet.”

  • Einen Webhook-Handler bauen

    Verweisen Sie Claude Code auf den Webhook-Leitfaden, und es schreibt einen Endpunkt, der Zustellstatus und eingehende Nachrichten speichert und je nach Kanal abweichende Felder toleriert.

    Beispielanfrage

    “Schreib einen Express-Webhook-Handler, der die Status SUBMITTED, SENT, DELIVERED, READ, FAILED und REJECTED pro Nachrichten-ID speichert und unbekannte Felder protokolliert, statt abzubrechen.”

  • Typisierten Client aus der Spezifikation erzeugen

    Liegt die OpenAPI-Spezifikation in Ihrem Repository, nutzt Claude Code die exakten Pfade und Felder, statt sie zu raten.

    Beispielanfrage

    “Schreib anhand von docs/omnichannels-openapi.yaml ein Python-Modul, das per POST /sms/sendSms eine SMS sendet, und liste jedes verwendete Feld mit seinem Typ laut Spezifikation auf.”

  • Durchgängig mit Ihrer eigenen Nummer testen

    Claude Code sendet nach Ihrer Freigabe des Tool-Aufrufs eine Testnachricht und prüft dann den Zustellbericht, um zu bestätigen, dass Ihr Code-Pfad funktioniert.

    Beispielanfrage

    “Sende eine Test-SMS von OmniDemo an meine Nummer 447700900123 und prüf dann den Zustellbericht.”

  • Fehlgeschlagene Sendungen debuggen

    Mit Lese-Tools gleicht Claude Code Zustellberichte mit Ihren Logs ab und verfolgt einen Fehler bis zu der Anfrage zurück, die ihn verursacht hat.

    Beispielanfrage

    “Lies den Zustellbericht der gestrigen Kampagne, fasse die Fehlergründe zusammen und prüf unseren Retry-Code anhand des Fehler-Leitfadens.”

So funktioniert die Verbindung

Verbindung über MCPVerbindung über API & Webhooks

Claude Code fügt Remote-MCP-Server mit claude mcp add --transport http und einem Authorization-Header hinzu. Ihre Shell setzt das Token beim Ausführen des Befehls aus einer Umgebungsvariablen ein. Für Teams ermöglicht eine projektbezogene .mcp.json, dass jeder Entwickler sein eigenes Token über ${BROADNET_TOKEN} bereitstellt; Claude Code bittet jede Person, den Server vor der Nutzung freizugeben.

MCP deckt Aktionen in Ihrem Konto ab: Testnachrichten senden, Vorlagen und Zustellberichte lesen. Zum Schreiben von Integrationscode geben Sie Claude Code unsere OpenAPI-3.1-Spezifikation als verbindliche Quelle für Endpunkte und Felder sowie den Webhook-Leitfaden, da Webhook-Payloads nicht in der Spezifikation enthalten sind. Berechtigungsregeln wie mcp__omnichannels__get_* lassen Lese-Tools ohne Rückfrage laufen, während Sende-Tools weiterhin nachfragen.

  • Befehl: claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp
  • Team-Setup: .mcp.json mit Bearer ${BROADNET_TOKEN} committen, niemals einen Schlüssel
  • Berechtigungsregeln benennen Tools als mcp__omnichannels__<tool>
  • OpenAPI-3.1-Spezifikation unter /developers/openapi.json für die exakten Anfragefelder
  • Einzel-SMS nutzt JSON; Massenversand und die meisten anderen Kanäle nutzen multipart/form-data

Einrichtung

  1. 1

    API-Zugang anfordern

    Fordern Sie einen Testzugang an und erhalten Sie ein API-Token. Testnachrichten gehen nur an Ihre eigenen verifizierten Nummern.

  2. 2

    Temporären Schlüssel abrufen

    Öffnen Sie im Admin-Portal Integrations und dann MCP Integration, wählen Sie Get temporary key und exportieren Sie den Schlüssel als BROADNET_TOKEN.

    Anleitung: MCP server for AI agents
  3. 3

    Server hinzufügen

    Führen Sie claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp mit dem Authorization-Header aus oder committen Sie eine Projekt-.mcp.json für Ihr Team, und prüfen Sie die Verbindung mit /mcp.

    Anleitung: Use the MCP server with Claude Code
  4. 4

    Berechtigungsregeln festlegen

    Erlauben Sie bei Bedarf Lese-Tools wie mcp__omnichannels__get_*, lassen Sie jedes Sende-Tool auf Rückfrage und verweigern Sie Tools, die das Projekt nicht braucht.

    Anleitung: Use the MCP server with Claude Code
  5. 5

    OpenAPI-Spezifikation hinzufügen

    Laden Sie openapi.yaml in Ihr Repository und weisen Sie Claude Code an, es für Endpunktpfade, Felder und Enums zu verwenden.

    Anleitung: OpenAPI 3.1 spec
  6. 6

    Mit Ihrer eigenen Nummer testen

    Lassen Sie Claude Code eine Testnachricht an Ihre verifizierte Nummer senden und lesen Sie anschließend den Zustellbericht aus.

Dokumentation des Anbieters

Claude Code ist eine Marke ihres Inhabers. OmniChannels.ai ist weder mit Claude Code verbunden noch von Claude Code unterstützt; diese Seite beschreibt eine Verbindung über die eigenen MCP-, HTTP- oder Webhook-Funktionen von Claude Code.

Beispiel-Workflow

So läuft eine typische Anfrage von Claude Code zu Ihrem Kunden und zurück.

  1. 01

    Claude Code

    Schreibt Ihre Integration und ruft auf Anfrage Tools auf

  2. 02

    OmniChannels.ai MCP und API

    MCP-Tools für Tests; Ihr Code ruft die REST API auf

  3. 03

    Ihr Testtelefon

    Test-SMS oder -WhatsApp an Ihre verifizierte Nummer

  4. 04

    Ihr Webhook-Handler

    Empfängt Zustellstatus und eingehende Nachrichten

1. Claude Code: Schreibt Ihre Integration und ruft auf Anfrage Tools auf 2. OmniChannels.ai MCP und API: MCP-Tools für Tests; Ihr Code ruft die REST API auf 3. Ihr Testtelefon: Test-SMS oder -WhatsApp an Ihre verifizierte Nummer 4. Ihr Webhook-Handler: Empfängt Zustellstatus und eingehende Nachrichten

Fragen

Gibt es ein offizielles OmniChannels.ai-Plugin für Claude Code?

Nein. Claude Code verbindet sich über seine Standardunterstützung für Remote-MCP-Server, mit unserem öffentlichen Endpunkt und Ihrem API-Token, und liest unsere öffentliche OpenAPI-Spezifikation wie jede andere Datei in Ihrem Repository.

Wie teile ich den Server mit meinem Team, ohne einen Schlüssel zu teilen?

Committen Sie eine projektbezogene .mcp.json, deren Authorization-Header ${BROADNET_TOKEN} verwendet. Jeder Entwickler setzt diese Variable in seiner eigenen Shell, und Claude Code bittet ihn, den Projektserver vor der Nutzung freizugeben.

Kann Claude Code Nachrichten senden, ohne nachzufragen?

Standardmäßig fragt Claude Code nach, bevor es ein MCP-Tool nutzt. Behalten Sie das für Sende-Tools bei, da jeder Versand eine echte, kostenpflichtige Nachricht ist. Erlauben Sie in Ihren Berechtigungsregeln nur Lese-Tools und prüfen Sie die Tool-Namen zuerst unter /mcp, da sie von der Serverversion und Ihrem Konto abhängen.

Sollte ich in meinem Produkt MCP oder die REST API verwenden?

Nutzen Sie MCP, damit Claude Code Ihr Konto während der Entwicklung testen und prüfen kann. Der Code, den Sie ausliefern, sollte die REST API direkt mit einem Token aus Ihrem Secret Store aufrufen und die OpenAPI-Spezifikation für die exakten Felder verwenden.

API- und MCP-Zugang erhalten

Nennen Sie uns Kanäle, Länder und Anwendungsfall. Ein Engineer stellt Testzugangsdaten aus und verifiziert Ihre Testnummern.