Einem LangChain-Agent eine WhatsApp-Nummer geben

Wie lädt ein LangChain-Agent die WhatsApp-Tools?

Über MCPAdapter, den MCP-Client von LangChain, der die Tools eines MCP-Servers als gewöhnliche LangChain-Tools an create_agent übergibt. Dafür ist langchain[mcp] ab Version 1.4.0 nötig, und das Feature ist als Beta gekennzeichnet.

Die Authentifizierung übernimmt FastMCP. Mit auth="oauth" am Client läuft der vollständige OAuth-2.1-Ablauf: Discovery, dynamische Client-Registrierung, die Browser-Weiterleitung und der Token-Austausch. Genau das erwartet der MCP-Server von EasyCoexistence, deshalb müssen Sie keinen Schlüssel erzeugen oder einfügen. Standardmäßig liegen die Tokens im Arbeitsspeicher, und jeder Lauf wiederholt den Browser-Schritt. Ein FastMCP-OAuth-Provider mit Token-Speicher bewahrt sie zwischen den Läufen auf.

Sobald die Tools geladen sind, sieht der Agent sie mit ihren Beschreibungen: zuerst list_numbers, weil jedes andere Tool eine connection_id daraus erwartet, dann send_message, send_template, list_templates, get_number_health und die übrigen.

from fastmcp.client import Client
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

URL = "https://easycoexistence.com/api/mcp"

async def build_agent(model: str):
    async with MCPAdapter(Client(URL, auth="oauth")) as adapter:
        tools = await adapter.list_tools()
        return create_agent(model, tools)

Wie gelangt eine eingehende WhatsApp-Nachricht zum Agent?

Über den Webhook, denn MCP kann das nicht leisten. Das Protokoll arbeitet mit Anfrage und Antwort, daher kann ein Server darin keinen Client wecken, wenn ein Kunde schreibt.

Setzen Sie das Webhook-Ziel der Nummer auf eine Route in Ihrer eigenen Anwendung, mit einem langen, zufälligen Secret im URL-Pfad. Die Route beantwortet den Verifizierungs-GET von Meta mit der unveränderten Challenge, nimmt jeden POST an, gibt sofort 200 zurück und stellt die Arbeit in eine Warteschlange. Ein Worker entnimmt der Payload den Absender und den Text und ruft damit den Agent auf, mit der Nummer des Absenders als Thread-ID, damit das Gedächtnis pro Kunde getrennt bleibt.

Prüfen Sie das Secret in der URL statt des Headers X-Hub-Signature-256. Meta signiert mit dem App-Secret des Tech Providers, das nie weitergegeben wird, deshalb kann der Kunde diesen Header nicht validieren.

Sollte der Agent über MCP oder über die Cloud API senden?

Beides funktioniert, der Unterschied liegt darin, wer die Regeln kennt. Die MCP-Tools tragen die WhatsApp-Regeln in ihren Beschreibungen, etwa dass send_message nur innerhalb des 24-Stunden-Fensters funktioniert und send_template der Weg ist, jemanden zu erreichen, der nicht geschrieben hat. Ein Modell, das diese Beschreibungen liest, wählt meistens das richtige Tool, und bei einem frei entscheidenden Agent hilft genau das.

Ein eigenes einfaches Tool, das mit dem Token der Nummer an den Messages-Endpoint der Cloud API sendet, ist einfacher, wenn die Aufgabe des Agents eng umrissen ist, etwa immer der Person zu antworten, die gerade geschrieben hat. Dann liegt die Prüfung des Fensters in Ihrem Code, und dort gehört eine Regel hin, die nie gebrochen werden darf. Freitext außerhalb des Fensters kommt mit dem Fehler 131047 zurück, und der Kunde bekommt nichts zu sehen.

Häufige Fehler

• Zu erwarten, dass MCP eingehende Nachrichten liefert. Ohne Webhook-Route hört der Agent nie von einem Kunden.
• OAuth-Tokens auf einem Server im Arbeitsspeicher zu belassen. Jeder Neustart verlangt eine Anmeldung im Browser; speichern Sie sie dauerhaft in einem Token-Speicher.
• Einen einzigen Thread für alle Kunden zu verwenden. Ordnen Sie das Gedächtnis des Agents der Nummer des Absenders zu.

Häufig gestellte Fragen

Weiterlesen