ChatArchitect Cloud MCP Server für WhatsApp KI-Agenten

KI-Agenten benötigen Werkzeuge, nicht nur Chat

KI-Agenten können Anfragen klassifizieren, Antworten entwerfen, Konversationen zusammenfassen und den nächsten Schritt in einem Workflow auswählen. Um diesen Schritt auszuführen, benötigen sie Zugriff auf Geschäftsanwendungen. Ein Agent, der eine Antwort entwerfen kann, benötigt außerdem ein Messaging-Tool, um diese zu übermitteln.

Für viele Unternehmen ist WhatsApp dieser Kanal. Vertriebsteams nutzen ihn zur Nachverfolgung von Leads, Supportteams zur Beantwortung von Kundenfragen und operative Teams zum Versenden von Termin-, Liefer-, Zahlungs- und Statusbenachrichtigungen. Der Nutzen von KI steigt, wenn der Agent von Vorschlägen zur kontrollierten Ausführung übergehen kann: eine SMS senden, eine Vorlage erstellen oder auflisten, Rechnungsinformationen anfordern, fehlgeschlagene Nachrichten prüfen, Daten exportieren oder Workflow-Endpunkte konfigurieren.

Der ChatArchitect Cloud MCP Server ist genau für diese Ebene konzipiert. Er bietet KI-Clients eine kontrollierte Möglichkeit, ausgewählte ChatArchitect WhatsApp API-Aktionen über das Model Context Protocol aufzurufen, ohne dass jeder Client eine benutzerdefinierte Backend-Integration entwickeln und pflegen muss.

Was ist MCP in einfachen Worten?

MCP (Model Context Protocol) ist ein Standardverfahren für KI-Anwendungen zur Anbindung an externe Tools. In einer MCP-Umgebung fungiert die KI-Anwendung als Client. Der MCP-Server stellt eine Reihe verfügbarer Aktionen, deren Eingabeschemata und Ausgabeformate bereit. Der KI-Client kann diese Aktionen ermitteln und aufrufen, sobald der Benutzer eine Aufgabe stellt, die ausgeführt werden muss.

MCP fungiert als Standardadapter zwischen einem KI-Agenten und einem Geschäftssystem. Die Sicherheit hängt von der Authentifizierung und Validierung des Servers, den Berechtigungen des Clients und der Funktionsweise der Verbindung ab. Der Agent muss die internen API-Details jedes Dienstes nicht kennen. Er sieht eine stabile Liste von Tools mit eindeutigen Namen und Parametern. Der Server übernimmt Authentifizierung, Validierung, Upstream-API-Aufrufe, Antwortnormalisierung und Fehlerbehandlung.

Diese Trennung ist wichtig. Sie ermöglicht es dem KI-Client, mit einer Geschäftsfunktion wie `send_whatsapp_text_message`, anstatt die gesamte ChatArchitect-API zu erlernen. Zudem können Unternehmen so Geheimnisse, interne Parameter und Betriebsregeln von den Argumenten des Modellierungstools fernhalten.

Was ist der ChatArchitect Cloud MCP Server?

ChatArchitect Cloud MCP Server ist eine öffentliche Remote-MCP-Fassade für die ChatArchitect WhatsApp API. Sie ist als Node.js- und TypeScript-Dienst implementiert und verwendet Express, createMcpExpressApp() aus @modelcontextprotocol/expressund NodeStreamableHTTPServerTransport aus @modelcontextprotocol/node.

Der Server stellt einen öffentlichen MCP-Transportzugangspunkt bereit: POST /mcp. KI-Clients verbinden sich mit diesem Endpunkt, authentifizieren sich mit einem Bearer-Token, ermitteln die unterstützten Tools und rufen die in ihrer Clientkonfiguration festgelegten Aktionen auf. Ein gültiges Kontotoken gewährt Zugriff auf die Tool-Oberfläche des Servers; toolspezifische Einschränkungen und Genehmigungsrichtlinien müssen im KI-Client konfiguriert werden.

Dies ist eine fokussierte v1-Oberfläche, die nicht alle Funktionen der ChatArchitect-API vollständig abbildet. Die aktuelle Implementierung hält die öffentlich zugänglichen Tools bewusst eingeschränkt. Sie stellt 10 MCP-Tools für WhatsApp-Nachrichten, Zahlungslinks, Benachrichtigungen, Vorlagen, Exporte, fehlgeschlagene Nachrichten, Webhooks und Abrechnung bereit. MCP-Prompts und -Ressourcen werden nicht bereitgestellt. Webhook-Zustellungs-Callbacks werden nicht empfangen. SSE wird für GET /mcp nicht unterstützt ; in v1 geben GET /mcp und DELETE /mcp absichtlich den Fehlercode 405 (Methode nicht erlaubt) zurück .

Der Hauptvorteil für die Kunden ist einfach: Sie können einen KI-Agenten mit WhatsApp- und ChatArchitect-Workflows verbinden, ohne ihren eigenen MCP-Server, ihre eigene OAuth-Oberfläche, ihre eigene Token-Validierung, ihre eigene Anfragekontextverarbeitung, ihren eigenen Upstream-Client, ihre eigenen Tool-Schemas und ihre eigene Antwortnormalisierung von Grund auf neu entwerfen zu müssen.

Warum Cloud-MCP für Kunden nützlich ist

ChatArchitect Cloud MCP Server bietet eine sofort einsatzbereite Integrationsschicht. Kunden verbinden ihr KI-Tool mit einem Cloud-Endpunkt, autorisieren den Zugriff und können sofort mit einem stabilen Satz von WhatsApp- und ChatArchitect-Aktionen starten. Updates, interne Upstream-Mappings, Anforderungsvalidierung und der MCP-Transport werden zentral verwaltet.

Ein Team kann mit einer Support-Antwort oder internen Benachrichtigung beginnen und anschließend Workflows mit CRM, Helpdesk, n8n, der OpenAI Responses API, ChatGPT, KI-IDE-Tools und benutzerdefinierten Backends erweitern. Vor der Implementierung sollten Transport-, Authentifizierungs- und Genehmigungsprozesse jedes Clients validiert werden.

Was Kunden damit machen können

Für Vertriebsteams kann ChatArchitect MCP einen KI-Agenten dabei unterstützen, auf WhatsApp-Anfragen zu antworten, Angebote zu erstellen oder einen Manager zu benachrichtigen, wenn ein Lead dringlich wird. Ein Website-Formular allein öffnet nicht das Kundenservice-Fenster von WhatsApp: Für die Kontaktaufnahme durch Unternehmen außerhalb des 24-Stunden-Fensters ist eine genehmigte Nachrichtenvorlage erforderlich.

Im Rahmen des Kundensupports kann die Verbindung bestätigen, dass eine Anfrage eingegangen ist, eine Statusaktualisierung innerhalb eines geöffneten Kundendienstfensters senden oder den Kontext an einen anderen Workflow übergeben.

Für den operativen Bereich können die Tools Rechnungsprüfungen, Exporte, interne Benachrichtigungen und WhatsApp-Antworten mit CRM-Workflows verknüpfen. Das aktuelle WhatsApp-Sendetool unterstützt nur Textnachrichten. Das Erstellen oder Auflisten von Vorlagen bietet kein Tool zum Versenden von Vorlagennachrichten; verwenden Sie hierfür einen separat unterstützten ChatArchitect-Workflow.

Für Entwickler und Automatisierungsteams liegt der Vorteil in einer stabilen Protokollgrenze. Anstatt jedem KI-Workflow direkten Zugriff auf die rohen API-Zugangsdaten und ChatArchitect-Endpunkte zu gewähren, können Entwickler die KI-Schicht mit einem konfigurierten MCP-Server verbinden. Dieser Server validiert Eingaben anhand von Zod-Schemas, fügt interne Upstream-Parameter ein, ordnet ChatArchitect-Antworten stabilen, strukturierten Inhaltenund gibt vorhersehbare Fehler zurück.

So funktioniert es

KI-Agent / ChatGPT / OpenAI Responses API / n8n / VSCode / Benutzerdefiniertes Backend | v ChatArchitect Cloud MCP Server | v ChatArchitect WhatsApp API und Geschäftslogik | v Kunde auf WhatsApp

Der Ablauf ist unkompliziert:

Ein KI-Agent erhält eine Aufgabe, zum Beispiel das Versenden einer Folge-E-Mail an einen neuen Lead.
Der KI-Client erkennt die vom ChatArchitect MCP-Server bereitgestellten Tools.
Der Client ruft ein Tool über POST /mcp mit Authorization: Bearer <token>.
Der MCP-Server validiert das Token und extrahiert die ChatArchitect-Kontodaten aus dem verschlüsselten Token-Text.
Der Server validiert die Tool-Argumente und ruft den erforderlichen ChatArchitect-Upstream-Endpunkt auf.
Die Antwort wird in einen stabilen MCP- strukturierten Inhalt.
Das Ergebnis wird an den KI-Client oder den Automatisierungsworkflow zurückgegeben.

Der KI-Client empfängt weder app_id noch secret als Tool-Parameter. Diese Anmeldeinformationen werden auf der Autorisierungsebene verarbeitet, nicht in Eingabeaufforderungen oder modellseitigen Schemas.

Autorisierungs- und Sicherheitsmodell

Der öffentliche MCP-Endpunkt akzeptiert auf MCP-Anfrageebene ausschließlich Bearer-Authentifizierung. Der Token-Vertrag ist verschachtelt: Ein äußeres kompaktes JWE enthält ein inneres signiertes JWT. Das Zugriffstoken ist mit dir und A256GCM verschlüsselt, während das innere JWT mit HS256 signiert ist .

Das Token muss die vom Server benötigten Ansprüche enthalten: sub=chatarchitect-session, app_id, secret, exp, issund aud. Der Aussteller muss mit PUBLIC_BASE_URL, und die Zielgruppe muss ${PUBLIC_BASE_URL}/mcp. Der optionale feste Gültigkeitsbereich ist mcp.

Dieses Design verhindert, dass ChatArchitect-Zugangsdaten in Eingabefeldern von Modellierungstools oder in normalen Tool-Antworten verwendet werden. Die Autorisierungsschicht stellt sie dem Server bereit, der beim Aufruf der ChatArchitect-API eine interne Basisauthentifizierung nutzt. Die Zugangsdaten bleiben vertraulich: Geben Sie sie nur auf der vertrauenswürdigen Autorisierungsseite ein und halten Sie Tokens von Eingabeaufforderungen, gemeinsam genutzten Konfigurationsdateien und Screenshots fern.

Die Implementierung umfasst außerdem Anfrage-Timeouts, Upstream-Timeouts, Beschränkungen der Body-Größe, Schutz des Host-Headers durch createMcpExpressApp() und optional ALLOWED_HOSTS, maskierte App-IDs in Child-Loggern sowie Hilfsfunktionen zur Schwärzung sensibler Werte.

Zur clientseitigen Steuerung können Schreibfunktionen in der KI-Anwendung hinter einer Genehmigungspflicht platziert werden. Schreibfunktionen, wie z. B. die Rechnungsabfrage oder die Vorlagenauflistung, können in der Regel ohne Genehmigung verwendet werden, während Schreibfunktionen, wie z. B. das Senden einer WhatsApp-Nachricht oder das Konfigurieren von Webhooks, eine menschliche Bestätigung erfordern können.

Unterstützte MCP-Tools

Der externe MCP-Vertrag bildet die Werkzeugebene. Werkzeugnamen sind festgelegt und sollten als stabile Integrationsnamen behandelt werden.

ChatArchitect MCP-Tools und Betriebsarten
Werkzeug	Typ	Beschreibung
`send_whatsapp_text_message`	Schreiben	Sendet eine WhatsApp-Nachricht über ChatArchitect. Unterstützt werden ausschließlich der `WhatsApp-` Kanal und reine Textnachrichten. Erforderliche Eingaben sind `Kanal`, `Ziel`und `Text`; `external_id` ist optional.
`get_payment_url`	Erstellung eines Zahlungslinks	Erstellt und gibt eine ChatArchitect-Zahlungs-URL für eine E-Mail-Adresse und einen ganzzahligen Betrag zurück. Der Standardwert für `payment_type` ist ` card` ; unterstützte Werte sind `card` und `wire` . Bei Konten mit Abrechnung in EUR beträgt der Mindestbetrag 30 € für beide Zahlungsmethoden. Das Erstellen des Links führt keine Zahlung aus.
`send_notification`	Schreiben	Sendet eine ChatArchitect-Benachrichtigung mit `Name`, `Quelle`und `Text`. Die normalisierte Ausgabe bestätigt den Versand der Benachrichtigung.
`Vorlage erstellen`	Schreiben	Erstellt eine ChatArchitect-Vorlage im Nur-Text-Format. Zu den Eingaben gehören ein slugsicherer `Elementname`, `ein Sprachcode`, `eine Kategorie`, `ein Inhalt`, ein optionales `Beispiel`und die erforderliche `Kategorie`. Der vorgelagerte Aufruf verwendet `templateType: "TEXT"`.
`export_chatarchitect_data`	Nur lesbar	Exportiert ChatArchitect-CSV-Daten. Unterstützte Aktionen sind `Telefonnummern`, `gesendete Anrufe`, `empfangene Anrufe`und `Konversationen`. Unterstützte Zeiträume sind `letzter Monat`, `dieser Monat`, `gestern`und `heute`. `Die Seitenzahl` muss mindestens 1 betragen.
`list_templates`	Nur lesbar	Listet ChatArchitect-Vorlagen für ein WhatsApp-Ziel auf. Eingaben sind `channel=whatsapp` und `destination`. Die Ausgabe ist ein stabiles Array mit Vorlagennamen, Statusmeldungen und optionalen Sprachcodes.
`get_last_failed_messages`	Nur lesbar	Gibt die letzten fehlgeschlagenen Nachrichten für ein WhatsApp-Ziel zurück. Eingaben sind `channel=whatsapp` und `destination`.
`set_webhooks`	Schreiben	Konfiguriert die Webhook-URLs von ChatArchitect. Zu den öffentlichen Eingaben gehören die optionalen Parameter `webhook` , `webhook_separate` , `webhook_message_event` und `webhook_user_event` . Webhook-URLs müssen `https://` verwenden .
`get_webhooks`	Nur lesbar	Liest die aktuelle ChatArchitect-Webhook-Konfiguration. Falls das Upstream-Backend `GET /webhook` nicht unterstützt und den Statuscode `404` oder `405` zurückgibt , ordnet der MCP-Server dies der Kategorie `„unsupported_by_backend“` zu .
`get_billing`	Nur lesbar	Gibt die Abrechnungsübersicht mit `clients_max`, `due_date`, `clients_active`, `balance`und `billing_status` (`aktiv` oder `abgelaufen`) zurück. Dies ist ein synthetisches Tool, das über einen internen ChatArchitect-Anfrageablauf implementiert wurde.

Die leseorientierten Tools sind export_chatarchitect_data, list_templates, get_last_failed_messages, get_webhooksund get_billing. Die Tools, die den Zustand ändern oder ein Objekt erstellen, sind send_whatsapp_text_message, send_notification, create_template, set_webhooksund get_payment_url.

Diese Bezeichnungen beschreiben die Vorgänge; es handelt sich nicht um serverseitig durchgesetzte Berechtigungen pro Tool oder MCP-Sicherheitsanmerkungen. Konfigurieren Sie die zulässigen Tools und Genehmigungen anhand des Toolnamens in Ihrem KI-Client. Ein konservativer Pilotversuch erfordert eine Bestätigung vor dem Senden einer Nachricht, dem Ändern von Webhooks, dem Erstellen einer Vorlage oder dem Generieren eines Zahlungslinks.

Beispielszenario: Beantwortung einer WhatsApp-Anfrage

Ein Kunde kontaktiert Ihr Unternehmen über WhatsApp und fragt nach einer Demo. Die eingehende Nachricht und der CRM-Kontext werden an einen KI-Workflow weitergeleitet. Innerhalb von 24 Stunden nach der letzten Nachricht des Kunden erstellt der Mitarbeiter eine Antwort, in der er die Anfrage bestätigt und einen Demotermin vorschlägt.

Der Kunde kann fragen:

Verfassen Sie eine Antwort auf diese WhatsApp-Anfrage und bieten Sie morgen einen Probeanruf an. Bitten Sie mich, den endgültigen Text vor dem Absenden zu genehmigen.

Der KI-Client erkennt, dass ChatArchitect MCP die Funktion `send_whatsapp_text_message`. Ist das Tool zugelassen und die Genehmigungsregeln erfüllt, ruft der Client den MCP-Server auf. Der Server validiert das Bearer-Token, prüft, ob die Eingabe des Tools ausschließlich unterstützte WhatsApp-Textfelder enthält, sendet die Nachricht über ChatArchitect und gibt das normalisierte Ergebnis zurück.

Halten Sie die Zustimmung des Kunden bereit und dokumentieren Sie das Ergebnis des Tools in Ihrem Workflow. Für geschäftlich initiierte Nachrichten ist die erforderliche Einwilligung (Opt-in) erforderlich. Außerhalb des 24-Stunden-Kundenservicefensters verwenden Sie bitte eine genehmigte Vorlage über einen unterstützten Vorlagenversand-Workflow anstelle dieses reinen Text-Tools. Weitere Informationen finden Sie in den WhatsApp Business Messaging-Richtlinien.

Unterstützte Verbindungsoptionen

ChatArchitect Cloud MCP kann in verschiedenen KI- und Automatisierungsumgebungen verwendet werden. Die genaue Benutzeroberfläche hängt vom jeweiligen Client ab, die wichtigste Regel ist jedoch überall dieselbe: Verwenden Sie die vollständige MCP-Endpunkt-URL, einschließlich /mcp.

https://api-mcp.chatarchitect.com/mcp

Wenn ein Client nur mit der Basisdomäne konfiguriert ist, sendet er möglicherweise MCP-Anfragen an / anstatt an /mcp, und die Tools werden nicht angezeigt.

ChatGPT Web

Sofern Ihr ChatGPT-Plan und Ihr Workspace benutzerdefinierte MCP-Integrationen zulassen, fügen Sie ChatArchitect als benutzerdefiniertes MCP-Plugin hinzu. Workspace-Administratoren müssen den Zugriff gegebenenfalls aktivieren oder genehmigen.

Beispielkonfiguration:

Öffne den Plugin-Bereich von ChatGPT.
Wählen Sie +und anschließend „Benutzerdefinierten MCP-Server hinzufügen“.
Geben Sie diese Server-URL ein und wählen Sie die OAuth-Authentifizierung:

https://api-mcp.chatarchitect.com/mcp

Erstellen Sie das Plugin, installieren Sie es und schließen Sie den Autorisierungsvorgang ab.
Geben Sie Ihre ChatArchitect- App-ID und Ihr App-Geheimnis nur auf der vertrauenswürdigen Autorisierungsseite ein.
Aktivieren Sie die für Ihr Szenario benötigten Tools und testen Sie zunächst eine leseorientierte Aktion.

Schnittstellenbezeichnungen und Verfügbarkeit können sich ändern; verwenden Sie die offiziellen ChatGPT MCP-Verbindungsanweisungen für Ihr Konto.

Beispiel einer Eingabeaufforderung nach der Verbindungsherstellung:

Verwende das ChatArchitect-Plugin, um WhatsApp-Vorlagen für dieses Ziel aufzulisten. Sende keine Nachricht, bevor ich den endgültigen Text bestätigt habe.

Konfigurieren Sie die Werkzeugberechtigungen und überprüfen Sie Schreibaktionen explizit. Eine Bestätigungsabfrage ist hilfreich, ersetzt aber nicht die Genehmigungseinstellungen des Clients.

n8n

n8n kann MCP-Tools in Automatisierungs-Workflows verwenden. Nutzen Sie den MCP-Client-Knoten, wenn Sie einen MCP-Aufruf als regulären Workflow-Schritt durchführen möchten. Verwenden Sie den MCP-Client-Tool-Knoten, wenn Ihr n8n-KI-Agent externe MCP-Tools aufrufen können soll.

Empfohlene Konfiguration für diesen Server:

Fügen Sie einen MCP-Client-Knoten oder einen MCP-Client-Tool-Knoten hinzu, falls Ihre n8n-Version Streamable HTTP für diesen Knoten unterstützt.
Legen Sie die MCP-Endpunkt-URL wie folgt fest:

https://api-mcp.chatarchitect.com/mcp

Wählen Sie zwischen Bearer- und OAuth2-Authentifizierung.
Für die Bearer-Authentifizierung wird ein kurzlebiges ChatArchitect MCP-Zugriffstoken benötigt:

Autorisierung: Bearer <chatarchitect-mcp-token>

Verwenden Sie für die OAuth2-Authentifizierung die von ChatArchitect MCP bereitgestellten Servermetadaten und Endpunkte:

Metadaten des Autorisierungsservers: https://api-mcp.chatarchitect.com/.well-known/oauth-authorization-server Metadaten der geschützten Ressource: https://api-mcp.chatarchitect.com/.well-known/oauth-protected-resource

Wählen Sie das aufzurufende Tool aus oder stellen Sie ausgewählte Tools einem KI-Agenten zur Verfügung.

Beispielhafter n8n-Workflow:

Eingehende WhatsApp-Nachricht -> 24-Stunden-Kundenservice-Fenster prüfen -> KI-Agent erstellt Antwortentwurf -> Menschliche Genehmigung -> MCP-Client-Tool: send_whatsapp_text_messageCRM -Aktualisierung

Prüfen Sie die Dokumentation des n8n MCP Client Tools und die Transportfunktionen Ihrer installierten Version.

ChatArchitect MCP v1 implementiert kein SSE für GET /mcp; GET /mcp gibt den Statuscode 405. Wenn ein n8n-Knoten oder eine ältere n8n-Installation nur einen SSE-Endpunkt akzeptiert, verwenden Sie einen Streamable-HTTP-fähigen MCP-Knoten oder schalten Sie einen kompatiblen Adapter vor den MCP-Server.

Claude Code

Claude Code unterstützt Remote-HTTP-MCP-Server. Dies macht es nützlich für technische Teams, die ChatArchitect-Workflows während der Arbeit in einem Repository überprüfen oder testen möchten.

OAuth-basierte Einrichtung:

claude mcp add --transport http chatarchitect https://api-mcp.chatarchitect.com/mcp

Führen Sie anschließend im Claude-Code Folgendes aus:

/mcp

Claude Code öffnet den OAuth-Ablauf für Remote-Server, die eine Authentifizierung erfordern. Nach Abschluss des Ablaufs stehen die ChatArchitect-Tools in der Claude Code-Sitzung zur Verfügung.

Wenn Ihr Backend einen kurzlebigen Bearer-Token erzeugt und Sie diesen direkt weitergeben möchten, verwenden Sie eine headerbasierte Konfiguration:

claude mcp add --transport http chatarchitect https://api-mcp.chatarchitect.com/mcp \ --header "Authorization: Bearer <chatarchitect-mcp-token>"

Für eine gemeinsam genutzte Projektkonfiguration kann Claude Code MCP-Server auch in einer .mcp.json- Datei des Projekts speichern. Anmeldeinformationen sollten nicht in gemeinsam genutzten Dateien gespeichert werden; Informationen zu Authentifizierung und Berechtigungen finden Sie in der Claude Code MCP-Dokumentation

{ "mcpServers": { "chatarchitect": { "type": "http", "url": "https://api-mcp.chatarchitect.com/mcp" } } }

Beispiel für eine Claude-Code-Eingabeaufforderung:

Verwenden Sie den ChatArchitect MCP-Server, um die Abrechnung zu prüfen und die letzten fehlgeschlagenen WhatsApp-Nachrichten aufzulisten. Rufen Sie keine Schreibwerkzeuge auf.

Kodex

Codex kann über die Befehlszeile oder eine IDE-Erweiterung eine Verbindung zu entfernten MCP-Servern herstellen. Dies ist nützlich, wenn Entwickler Codex die ChatArchitect MCP-Tools untersuchen, Tool-Verträge testen oder Workflows erstellen lassen möchten, die ChatArchitect-Aktionen aufrufen.

CLI-Einrichtung:

codex mcp add chatarchitect --url https://api-mcp.chatarchitect.com/mcp codex mcp login chatarchitect codex mcp list

Äquivalente direkte Konfiguration in ~/.codex/config.toml:

[mcp_servers.chatarchitect] url = "https://api-mcp.chatarchitect.com/mcp"

Führen Sie den Befehl codex mcp login chatarchitect , um OAuth zu starten, und geben Sie Ihre ChatArchitect-Anmeldeinformationen auf der Seite für vertrauenswürdige Autorisierung ein.

Für ein vom Backend generiertes Bearer-Token verwenden Sie in der Konfiguration eine Umgebungsvariable anstelle eines konkreten Tokens:

[mcp_servers.chatarchitect] url = "https://api-mcp.chatarchitect.com/mcp" bearer_token_env_var = "CHATARCHITECT_MCP_TOKEN"

Setzen Sie CHATARCHITECT_MCP_TOKEN sicher in der Umgebung, bevor Sie Codex starten. Verwenden Sie entweder OAuth oder die Bearer-Token-Konfiguration für die Verbindung. Informationen zu den Steuerelementen und Authentifizierungsoptionen finden Sie in der Codex MCP-Dokumentation

Beispiel einer Codex-Eingabeaufforderung:

Nutzen Sie den ChatArchitect MCP-Server, um die verfügbaren Tools zu prüfen. Erstellen Sie anschließend einen sicheren Testplan für get_billing, list_templates und send_whatsapp_text_message. Senden Sie keine WhatsApp-Nachricht, bevor ich den genauen Text nicht ausdrücklich genehmigt habe.

Cursor

Cursor unterstützt benutzerdefinierte MCP-Server über mcp.json. Verwenden Sie eine Projektkonfiguration, wenn die Verbindung nur für ein Repository gelten soll, oder eine globale Konfiguration, wenn der Server projektübergreifend verfügbar sein soll.

Projektdatei:

.cursor/mcp.json

Globale Datei:

~/.cursor/mcp.json

Remote-Server-Konfiguration im OAuth-Stil:

{ "mcpServers": { "chatarchitect": { "url": "https://api-mcp.chatarchitect.com/mcp" } } }

Bearer-Token-Konfiguration mithilfe einer Umgebungsvariablen:

{ "mcpServers": { "chatarchitect": { "url": "https://api-mcp.chatarchitect.com/mcp", "headers": { "Authorization": "Bearer ${env:CHATARCHITECT_MCP_TOKEN}" } } } }

Beispiel für eine Cursor-Eingabeaufforderung:

Nutzen Sie die ChatArchitect MCP-Tools, um Vorlagen für dieses WhatsApp-Ziel aufzulisten. Falls eine Nachricht gesendet werden muss, erstellen Sie zunächst einen Entwurf und warten Sie auf die Genehmigung.

Aktivieren Sie nur die für den Workflow benötigten Tools und verwenden Sie Clientgenehmigungsfunktionen für Aktionen, die den Status ändern. Informationen zur Konfiguration und zum Umgang mit Umgebungsvariablen finden Sie in der Cursor MCP-Dokumentation

Wann sollten Sie ChatArchitect MCP verwenden?

Nutzen Sie ChatArchitect MCP, wenn Sie bereits einen KI-Workflow haben oder planen, einen solchen zu erstellen, der in WhatsApp oder ChatArchitect aktiv sein und nicht nur Text generieren soll. Es eignet sich besonders, wenn ein KI-Agent WhatsApp-Nachrichten senden, mit Vorlagen arbeiten, konversationsbezogene Daten exportieren, fehlgeschlagene Nachrichten analysieren, Rechnungen prüfen oder WhatsApp-Aktionen in CRM- und Support-Workflows integrieren soll.

Es ist auch dann nützlich, wenn eine kontrollierte Integrationsgrenze gewünscht ist. Der KI-Client kann nur ausgewählte Tools aufrufen. Schreibvorgänge können eine Genehmigung erfordern. Tool-Schemas bleiben eng gefasst. Geheimnisse werden nicht in Eingabeaufforderungen oder Tool-Argumenten angezeigt. Upstream-Details verbleiben auf dem MCP-Server.

Der Cloud-Endpunkt ermöglicht Ihrem Team die Verbindung ohne den Aufbau einer eigenen MCP-Infrastruktur. Sie können sich auf den Workflow und das Kundenerlebnis konzentrieren, während ChatArchitect die Ausführungsschicht bereitstellt.

Was Sie für den Anfang benötigen

Für den Einstieg in ChatArchitect Cloud MCP benötigen Sie ein ChatArchitect-Konto, eine aktive WhatsApp Business API-Konfiguration, Zugriff auf den MCP-Endpunkt, eine Autorisierungsmethode für das MCP-Bearer-Token oder den OAuth-Flow sowie einen KI-Client oder ein Automatisierungstool, das MCP aufrufen kann. Wählen Sie für einen ersten Test ein einfaches Szenario: Lead-Follow-up, Support-Bestätigung, Zahlungserinnerung oder interne Benachrichtigung.

Definieren Sie anschließend, welche Tools der KI-Client verwenden darf. Eine konservative Konfiguration erlaubt üblicherweise Lesezugriff ohne Genehmigung und erfordert eine Genehmigung für Schreibzugriffe. Beispielsweise kann der Client Rechnungs- oder Listenvorlagen frei lesen, muss aber einen Mitarbeiter um Erlaubnis fragen, bevor er eine WhatsApp-Nachricht sendet oder Webhook-Einstellungen ändert.

Häufig gestellte Fragen

Ist das nur für Entwickler?

Nein. Entwickler können sich über die OpenAI Responses API oder ein benutzerdefiniertes Backend verbinden, aber Automatisierungsteams können auch MCP-fähige No-Code- oder Low-Code-Tools verwenden. Ziel ist es, eine standardisierte Tool-Schnittstelle bereitzustellen, die von verschiedenen KI-Clients genutzt werden kann.

Muss ich meinen eigenen MCP-Server hosten?

Nein. ChatArchitect Cloud MCP Server ist als gehosteter MCP-Endpunkt konzipiert. Clients verbinden sich mit dem Cloud-Endpunkt, anstatt einen eigenen MCP-Server bereitzustellen und zu warten.

Kann KI WhatsApp-Nachrichten automatisch versenden?

Ja, sofern der Kunde die Autorisierung, die zulässigen Tools und die Genehmigungsregeln konfiguriert hat. Bei sensiblen Arbeitsabläufen sollte für Schreibwerkzeuge vor der Ausführung eine Bestätigung erforderlich sein.

Kann ich vor dem Versand eine Genehmigung verlangen?

Ja. Konfigurieren Sie die Genehmigungsregeln im KI-Client anhand des Werkzeugnamens. Der aktuelle Server setzt diese Regeln nicht durch und veröffentlicht keine sicherheitsrelevanten Anmerkungen pro Werkzeug. Überprüfen Sie daher das Verhalten des Clients, anstatt von einer automatischen Klassifizierung auszugehen.

Kann ich den Zugriff später deaktivieren oder einschränken?

Sie können die Integration trennen oder Tools im Client deaktivieren. Dies steuert den jeweiligen Client, widerruft aber keine bereits ausgestellten Token. Der aktuelle v1-Server verfügt über keinen OAuth-Widerrufsendpunkt; ausgestellte Zugriffstoken bleiben bis zu ihrem Ablauf gültig. Stimmen Sie serverseitige Zugriffsänderungen mit ChatArchitect ab, wenn der Zugriff beendet werden muss.

Ist es für die Produktion geeignet?

Der Server umfasst Bearer-Authentifizierung, verschlüsselte Zugriffstoken, Schema-Validierung, Timeout-Regeln, Antwortnormalisierung und Hilfsfunktionen zur Datenredaktion. Diese Funktionen gewährleisten jedoch nicht die Einsatzbereitschaft für jede Anwendung. Vor der Produktivsetzung sollten Sie repräsentative Workflows in einem Testkonto validieren, die Zustimmung des Kunden einholen, Fehler überwachen und die WhatsApp Business-Regeln beachten.

Starten Sie Ihren MCP-Workflow

Möchten Sie Ihren KI-Agenten mit WhatsApp verbinden? Kontaktieren Sie ChatArchitect, und wir helfen Ihnen bei der Einrichtung von Cloud MCP für Ihren Anwendungsfall.

Sie haben bereits einen KI-Workflow? Senden Sie uns Ihr Szenario und wir zeigen Ihnen, wie Sie ihn über MCP verbinden können.

Besprechen Sie Ihren MCP-Workflow

ChatArchitectCloud MCP Server für WhatsApp KI-Agenten