WhatsApp-MCP-Server: WhatsApp-Nachrichten mit einem KI-Agenten senden und lesen
Ein WhatsApp-MCP-Server macht aus der Cloud API Tools, die ein Agent aufrufen kann: eine Konversation öffnen, eine Nachricht senden, die Inbox lesen, ein genehmigtes Template senden. Posten kann er nicht, weil WhatsApp keine Posts hat. Das Schwierige ist nicht die Technik, es ist das 24-Stunden-Fenster. Alles unten wurde am 21. Oktober 2026 geprüft.
Was ein WhatsApp-MCP-Server kann und was nicht
WhatsApp ist ein Konversationskanal, keine Publishing-Oberfläche. Die Tool-Liste, die ein Agent bekommt, ist deshalb kurz und scharf: Konversationen auflisten, eine Konversation per Telefonnummer im internationalen Format öffnen, Text senden, ein genehmigtes Template senden, eingehende Nachrichten lesen. Es gibt keine Posts, keine Kommentare und damit keine Analytics. Jeder WhatsApp-MCP-Server, der dir Reach und Impressions versprich, beschreibt etwas, das es in der API nicht gibt.
Darunter braucht es ein WhatsApp Business Account. Bei PlugKit läuft diese Verbindung über Metas Embedded Signup: rufe GET /v1/connect/whatsapp?profileId=... auf, öffne die authUrl, die zurückkommt, und die Person meldet sich mit Facebook an, wählt oder erstellt ein WABA und verifiziert die Nummer. Angefragt werden die Berechtigungen whatsapp_business_messaging und whatsapp_business_management.
Eine Falle aus den PlugKit-Docs, die Leute einen Tag kostet: verbinde eine echte Nummer. Eine Meta-Testnummer trägt einen 24-Stunden-Token und funktioniert am nächsten Morgen nicht mehr, was genau wie eine kaputte Integration aussieht.
Das 24-Stunden-Fenster, aus Sicht eines Agenten
Das ist die Regel, die entscheidet, ob die Nachricht deines Agenten überhaupt rausgeht. Freier Text wird nur innerhalb von 24 Stunden nach der letzten Nachricht des Kontakts an dich akzeptiert. Außerhalb dieses Fensters wird freier Text abgelehnt, und nur ein genehmigtes Template geht durch.
Für einen Agenten hat das eine praktische Folge, die die meisten Tutorials überspringen. Der Agent kann aus dem Text einer Anfrage nicht wissen, ob das Fenster offen ist; er muss zuerst die Konversation lesen. Die nützliche Schleife ist also: Konversation auflisten, den Zeitstempel der letzten eingehenden Nachricht ansehen, dann zwischen freiem Text und Template wählen. Ein Agent, der das Lesen überspringt, produziert selbstbewusste Fehlschläge, und jemandem zu sagen, die Nachricht sei raus, obwohl sie abgelehnt wurde, ist schlimmer als ein Fehler.
Kampagnen folgen demselben Fenster. Es gibt keine Einstellung, die es öffnet.
Templates: der einzige Weg aus dem Fenster
Ein Template ist vorab genehmigter Text mit numerierten Platzhaltern. Liste die auf einem Account genehmigten mit GET /v1/accounts/{ACCOUNT_ID}/message-templates, dann sende es, indem du template mit name, language und variables übergibst, die {{1}}, {{2}} der Reihe nach füllen. Name und Sprache müssen exakt passen, und components nimmt rohe Meta-Komponenten, wenn du einen Header oder Buttons brauchst.
Zwei Dinge musst du deinem Agenten ausdrücklich sagen. Er kann kein Template erfinden, weil die Genehmigung außerhalb deines Codes passiert. Und er sollte kein Template wählen, dessen Kategorie nicht zur Absicht passt: Metas Preise pro Nachricht rechnen nach Kategorie ab, ein Marketing-Template für eine Utility-Aufgabe zu senden ist also ein selbst verursachter Kostenpunkt.
Was die Nachrichten kosten
Meta ist am 1. Juli 2025 auf Abrechnung pro Nachricht umgestiegen und hat damit das alte Modell pro Konversation ersetzt. Du zahlst bei Zustellung, nach Nachrichtenkategorie und Ländervorwahl des Empfängers. Nachrichten von Nutzern an dich sind kostenlos.
| Kategorie | Braucht ein genehmigtes Template | Außerhalb des 24-Stunden-Fensters sendbar | Abgerechnet |
|---|---|---|---|
| Marketing | ja | ja | ja |
| Utility | ja | ja | ja, und seit dem 1. Oktober 2026 auch innerhalb eines offenen Service-Fensters |
| Authentication | ja | ja | ja |
| Service | nein | nein | die ersten 1 000 pro Business-Nummer und Monat werden seit dem 1. Oktober 2026 nicht abgerechnet, danach ja |
| Meta Business Agent | nein | nein | ja, pro Token statt pro Nachricht |
Drei Daten im Kopf behalten: Abrechnung pro Nachricht seit 1. Juli 2025; die Kategorie Meta Business Agent seit 1. Juli 2026; und der 1. Oktober 2026, der die 1 000 nicht abgerechneten Service-Nachrichten pro Nummer und Monat brachte, ohne Übertrag, plus die Abrechnung von Utility-Nachrichten innerhalb eines offenen Service-Fensters. Meta ändert Preise nur am ersten Tag eines Quartals, was dies zu einer der leichter planbaren Rechnungen macht.
Ein Lichtblick, auf den sich bauen lässt: wenn dir jemand aus einer Click-to-WhatsApp-Werbung auf Android oder iOS schreibt und du innerhalb des Service-Fensters antwortest, öffnet sich ein Free-Entry-Point-Fenster von bis zu 7 Tagen, in dem Marketing-, Utility-, Authentication- und Service-Nachrichten nicht abgerechnet werden. Meta-Business-Agent-Nachrichten weiterhin schon. Die vollständige Übersicht steht in WhatsApp Business API Preise.
Warum WhatsApp-Web-Automatisierung die falsche Abkürzung ist
Suche nach einem WhatsApp-MCP-Server, und das meiste, was du findest, steuert WhatsApp Web oder eine reverse-engineerte Client-Bibliothek, meist indem eine private Nummer per QR-Code gekoppelt wird. Die Demo sieht großartig aus. Es heißt aber auch, dass ein unoffizieller Client Traffic im Namen deiner Nummer sendet, was der direkte Weg ist, sie zu verlieren, und wenn sie weg ist, verlierst du die Nummer, die deine Kunden schon haben. Dafür gibt es keine Beschwerdestelle.
Die offizielle Cloud API kostet Geld pro Nachricht und verlangt genehmigte Templates. Genau diese zwei Reibungen kaufst du ein: die Nummer bleibt deine. Dieselbe Logik gilt plattformübergreifend, und die breite Version steht in WhatsApp-Automatisierung.
Verbinde ihn mit Claude, ChatGPT oder Cursor
Der gehostete MCP-Server von PlugKit deckt WhatsApp neben den Publishing-Plattformen ab, ein Endpoint gibt einem Agenten also beides. Er liegt unter https://api.plugkit.co/mcp über Streamable HTTP, mit 103 Tools und drei vorgefertigten Workflows, Stand 21. Oktober 2026. In Claude Code:
claude mcp add -t http plugkit https://api.plugkit.co/mcp
In den Claude-Apps: Customize, dann Connectors, dann Add, dann ein eigener Connector, und füge dieselbe URL ein. ChatGPT nimmt sie im Entwicklermodus. Cursor und VS Code nehmen einen Ein-Klick-Link oder ein paar Zeilen JSON. Die Authentifizierung ist OAuth 2.1 mit PKCE und ohne Client Secret, mit mcp:read zum Lesen von Konversationen und mcp:write zum Senden. Fang eine Woche mit mcp:read an: eine Inbox zu lesen ist umkehrbar, einem Kunden eine WhatsApp-Nachricht zu senden nicht.
Wenn keine eingehenden Nachrichten mehr ankommen, ist die Lösung POST /v1/connect/whatsapp/{ACCOUNT_ID}/subscribe-webhooks, das ohne Neuverbindung erneut abonniert. Wenn Sendungen fehlschlagen, lies GET /v1/accounts/{ACCOUNT_ID} für isActive, needsReconnection und disconnectedReason; Meta kann sich weigern, eine Nummer zu bedienen, obwohl der Token völlig gültig ist, und das kommt als Meta-Fehler zurück, nicht als Auth-Fehler.
PlugKit kostet $49 pro Monat für 5 verbundene Accounts, jederzeit kündbar, mit 7 Tagen gratis ohne Karte und einem verbundenen Account während der Testphase. Die WhatsApp-Nachrichtengebühren sind die von Meta und werden von Meta abgerechnet, nicht über PlugKit weitergegeben. Für dasselbe Muster auf Plattformen, die tatsächlich Posts haben, siehe der Instagram-MCP-Server und der LinkedIn-MCP-Server.
FAQ
Kann Claude WhatsApp-Nachrichten senden?
Ja, über einen MCP-Server, der mit der WhatsApp Cloud API verbunden ist. Claude hat keinen eigenen WhatsApp-Zugang. Sobald der Server hinzugefügt ist, ist eine Nachricht zu senden ein Tool-Aufruf, mit denselben Regeln zum 24-Stunden-Fenster und zu Templates wie bei jedem anderen Cloud-API-Client.
Gibt es einen offiziellen WhatsApp-MCP-Server von Meta?
Nein. Meta veröffentlicht die Cloud API; die MCP-Schicht bauen Dritte darauf. Deshalb lohnt es sich zu prüfen, ob ein Server die Cloud API nutzt oder WhatsApp Web steuert, denn nur Ersteres ist zulässig.
Warum wurde die WhatsApp-Nachricht meines Agenten abgelehnt?
Fast immer das 24-Stunden-Fenster. Wenn der Kontakt dir in den letzten 24 Stunden nicht geschrieben hat, wird freier Text abgelehnt und du brauchst ein genehmigtes Template. Die zweithäufigste Ursache ist ein Template-Name oder eine Sprache, die nicht exakt passt.
Kann ein WhatsApp-MCP-Server meinen Nachrichtenverlauf lesen?
Er kann die Konversationen lesen, die über die verbundene Business-Nummer angekommen sind, per Webhook geliefert. Er kann den Verlauf eines privaten WhatsApp-Accounts nicht importieren, und alles, was das behauptet, steuert einen unoffiziellen Client.
Gibt WhatsApp einem Agenten irgendwelche Analytics?
Nein. Es gibt auf WhatsApp keine Posts, also keine Post-Metriken. Zustell- und Lesestatus gibt es auf Nachrichtenebene, aber Reach, Impressions und Engagement gelten für diesen Kanal nicht.
Ein Plug für jede Plattform, die dein Agent anfasst
49 $ im Monat für 5 verbundene Accounts, jederzeit kündbar. Jede Funktion in jedem Tarif.
Hol dir deinen API-Key →