WhatsApp Business Tools MCP: hogyan csatlakoztassuk a WhatsApp Businesst egy AI-ügynökhöz

2026. szeptember 15-én a Meta kiadta a hivatalos WhatsApp Business Tools MCP-szervert. Ez egy AI-ügynököt — Claude Code-ot, Codexet, ChatGPT-t vagy Cursort — kapcsol össze a WhatsApp Business Platformmal. Ahelyett, hogy a Developer Console, a Business Manager és az API-dokumentáció között váltogatna, egyszerűen elmondja az ügynöknek, mire van szüksége; az hozzáad egy telefonszámot, létrehoz egy üzenetsablont, beállítja a webhookokat, és tesztüzenetet küld.

A szerver még béta állapotban van: a hozzáférést fokozatosan teszik elérhetővé, a kiadás pedig fejlesztésre és tesztelésre szolgál, nem nagy léptékű éles üzenetküldésre. Az alábbiakban négy kliens előkészítési és csatlakoztatási lépéseit ismertetjük. A parancsokat és a beállításokat a Meta hivatalos dokumentációja alapján ellenőriztük 2026. szeptember 18-án.

Az Ailoot használatáról a dokumentációban talál információt.

Mi az a WhatsApp Business Tools MCP?#

Az MCP (Model Context Protocol) nyílt szabvány külső rendszerek AI-ügynökökhöz csatlakoztatására. Bővebben a MCP-szerverek a Claude Code-hoz: 7 kész integráció című cikkben olvashat róla. Az MCP-katalógusban ellenőrzött, telepítési parancsokkal ellátott kapcsolatokat talál.

A kiadás előtt egy WhatsApp-integráció beállítása így nézett ki: megnyitni a Developer Console-t, létrehozni egy alkalmazást, összekapcsolni egy vállalkozást, hozzáadni egy telefonszámot, kóddal ellenőrizni, tokent generálni, beállítani egy webhookot, átnézni az API-dokumentációt — és csak ezután megírni az első kódsort.

A Meta így írja le a szerver mögötti elképzelést (angolból fordítva):

A Metának most két MCP-szervere van, amelyeket könnyű összekeverni. A Meta Social Technologies MCP általános fejlesztői eszköz: dokumentációkeresésre, Graph API-végpontok felderítésére és alkalmazáshibák diagnosztizálására szolgál. A WhatsApp Business Tools MCP WhatsApp-fiókok, telefonszámok, sablonok, webhookok és tesztüzenetek kezelésére való. Kiegészítik egymást, és szükség esetén mindkettőt csatlakoztathatja.

Pontosan mit tud az ügynök a csatlakoztatás után?#

A szerver eszközei a whatsapp_biz_ előtag alatt vannak csoportosítva. A hivatalos dokumentáció szerint:

• Áttekintés: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers — milyen vállalkozások, fiókok és telefonszámok érhetők el az Ön számára.
• Telefonszám beállítása: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Sablonok: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Üzenetek: whatsapp_biz_send_message — szabad szöveg az aktív, 24 órás beszélgetési időszakban, azon kívül pedig jóváhagyott sablon; az ügynök küldés előtt megerősíti Önnel a címzettet.
• Webhookok: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Fiókbeállítás: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token — hivatkozás rendszerfelhasználói token létrehozásához közvetlen Cloud API-hívásokhoz.

Amikor egy ügyfél ír először a vállalkozásnak, megnyílik az ügyfélszolgálati időszak: 24 órán át szabad szöveggel válaszolhat. Minden új ügyfélüzenet meghosszabbítja ezt az időszakot. Amikor lejár, csak jóváhagyott sablonnal léphet kapcsolatba az ügyféllel. Az ügynök ismeri ezt a szabályt, és ha a címzett már kívül esik az időszakon, a normál szöveg helyett sablon küldését javasolja.

A szerver beépített hozzáférés-vezérléssel rendelkezik. A Meta-fiókjával jelentkezik be, és kiválasztja a konkrét vállalkozásokat; a tokenek nem kerülnek be a beszélgetési előzményekbe. Minden olvasási művelet az Ön kontextusában történik, a hívásokat naplózzák, a módosításokat végrehajtó műveletekhez pedig hitelesített személy szükséges; önmagában egy szerveralkalmazás-kulcs nem elegendő.

Mit érdemes ellenőrizni a csatlakoztatás előtt?#

A szerver az Ön nevében jár el, és csak az Ön erőforrásaival dolgozik, ezért az első hívás előtt ellenőrizze a következőket:

1. Van olyan Meta-vállalkozása, amelyben Ön rendszergazda (MANAGE szerepkör).
2. Van olyan Meta-alkalmazása, amelyben engedélyezve van a WhatsApp Business Messaging forgatókönyv (régebbi alkalmazásokban a WhatsApp-termék), és kifejezetten annak az alkalmazásnak is Ön a rendszergazdája; az üzleti szintű jogosultság önmagában nem elegendő.
3. A vállalkozás elfogadta a WhatsApp Business Cloud API feltételeit — enélkül a telefonszám regisztrálása és az üzenetküldés le van tiltva.

A Meta szerint a használati feltételekkel, a fizetési módokkal és az üzleti ellenőrzéssel kapcsolatos problémák gyakran egyértelmű magyarázat nélkül merülnek fel. Az ügynök előzetesen ellenőrzi ezeket, és közvetlen hivatkozást ad a feltételek elfogadásához, a fizetési mód megadásához vagy az üzleti ellenőrzés elindításához.

Hogyan csatlakoztatható a szerver a Claude Code-hoz?#

Ha még nem telepítette a Claude Code-ot, kezdje a Claude Code telepítése a hivatalos webhelyről című útmutatóval.

1. Adja hozzá a szervert

   A terminálban futtassa:

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   A szerver távoli, ezért nem kell helyben telepítenie.

2. Jelentkezzen be a Metán keresztül

   Egy Claude Code-munkamenetben írja be a /mcp parancsot, majd válassza ki a whatsapp_business_tools elemet. Megnyílik egy böngészőablak, ahol bejelentkezhet a Meta-fiókjába. Ha a böngésző nem nyílik meg, másolja ki a hivatkozást a kliensből, és nyissa meg kézzel.

3. Adjon jogosultságot

   A hozzájárulási képernyőn válassza ki azokat a vállalkozásokat és WhatsAppot használó alkalmazásokat, amelyekhez hozzáférést engedélyez. A szerver három jogosultságot kér: business_management (azoknak a vállalkozásoknak a megkeresése, amelyekben Ön rendszergazda), whatsapp_business_management (fiókok, telefonszámok, sablonok, webhookok) és whatsapp_business_messaging (üzenetek küldése az Ön számairól).

4. Ellenőrizze a kapcsolatot

   Indítsa újra a Claude Code-ot, jelentkezzen be ismét a /mcp paranccsal, és kérdezze meg az ügynöktől, mely eszközöket látja a whatsapp_business_tools szerveren. Ezután végezzen biztonságos olvasási műveletet: „Sorolja fel a vállalkozásokat, amelyeket kezelhetek” — az ügynök meghívja a whatsapp_biz_businesses eszközt. Ha nem jelennek meg eszközök, vagy bejelentkezési hiba történik, ellenőrizze a szerver címét, és jelentkezzen be újra.

Az OAuth-bejelentkezés a kliens indításához kötődik: a Claude Code újraindítása után ismét be kell jelentkeznie. A hozzáférést bármikor visszavonhatja a facebook.com beállításaiban, a „Business Integrations” résznél.

Hogyan csatlakoztatható a Codex, a ChatGPT és a Claude Desktop?#

Codex App. Nyissa meg a beállításokat (a fogaskerék a bal alsó sarokban), lépjen az MCP Servers részhez, majd válassza az Add servers lehetőséget. Válassza a Streamable HTTP-t, és adja meg a következőket:

• Név: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Hitelesítés: OAuth

Kattintson az Authenticate gombra, majd jelentkezzen be a böngészőben.

ChatGPT. Settings, Plugins, Browse plugins, a „+” ikon a jobb felső sarokban. Adjon meg egy nevet, ugyanazt az URL-t, és válassza az OAuthot hitelesítési típusként.

Claude Desktop. Settings, Connectors, Add custom connector. Név: WhatsApp Business Tools; URL: ugyanaz a szervercím.

Bármelyik kliensben történő hozzáadás után kövesse ugyanazt az ellenőrzési sorrendet: újraindítás, újbóli bejelentkezés, az eszközlista megtekintése, majd a vállalkozások listájának biztonságos lekérdezése.

Mi történik az első munkamenetben: a vállalkozások listájától a tesztüzenetig?#

Egy tipikus első munkamenet a csatlakoztatott szerverrel:

1. „Sorolja fel a vállalkozásokat, amelyeket kezelek” — az ügynök meghívja a whatsapp_biz_businesses eszközt, Ön pedig kiválasztja a szükségeset.
2. „Mutassa meg ennek a vállalkozásnak a WhatsApp-fiókjait és telefonszámait” — whatsapp_biz_accounts és whatsapp_biz_phone_numbers, az állapotukkal együtt.
3. „Adja hozzá a teszt-telefonszámomat a fiókhoz” — whatsapp_biz_add_phone_number.
4. „Küldjön ellenőrző kódot SMS-ben” — whatsapp_biz_send_verification_code. A kód megérkezik a telefonjára.
5. „Ellenőrizze a számot az 123456 kóddal” — whatsapp_biz_verify_phone_number, majd regisztrálja a whatsapp_biz_register_phone_number eszközzel.
6. „Hozzon létre egy order_update sablont a címzettek által előnyben részesített nyelven, rendelési értesítésekhez” — whatsapp_biz_create_template; az ügynök hivatkozást ad a jóváhagyási állapotához.
7. „Küldjön tesztüzenetet a számomra” — whatsapp_biz_send_message; az ügynök küldés előtt megerősíti a címzettet.
8. „Állítson be webhookot itt: https://example.com/webhook” — whatsapp_biz_configure_webhooks, majd iratkozzon fel a whatsapp_biz_subscribe_webhook segítségével.

Ezután a bejövő ügyfélüzenetek a megadott címre érkeznek — általában egy CRM, ügyfélszolgálati szolgáltatás vagy bot veszi át őket. A feldolgozást külön kell kiépítenie ezen a címen; a szerver csak a konfigurációt kezeli.

Milyen korlátai vannak a bétának?#

A szervernek négy korlátját érdemes szem előtt tartani.

Bétaállapot. A Meta szerint a felület és az eszközök köre változhat, a hozzáférést pedig fokozatosan teszik elérhetővé. Ha még nem tud csatlakozni a szerverhez, előfordulhat, hogy azt még nem tették elérhetővé az Ön számára.

Rendeltetés. A kiadás fejlesztésre és tesztelésre való; nem tömeges éles üzenetküldésre. Éles üzenetküldéshez teljes Cloud API-integrációra lesz szüksége — például rendszerfelhasználói token használatával, amelyhez a whatsapp_biz_system_user_token eszköz ad hivatkozást.

Korlátok. Minden eszközre felhasználónkénti kéréskorlát vonatkozik. A korlát túllépésekor az eszköz korláthibát ad vissza — várjon, majd próbálja újra.

A 24 órás időszak szabálya. Az ügyféllel folytatott beszélgetési időszakon kívül csak jóváhagyott sablonokat küldhet.

Miért fontos ez egy vállalkozás számára?#

Egy kisvállalkozás tipikus helyzete: az ügyfelek WhatsAppon írnak, Ön pedig gyorsan szeretne válaszolni, és értesítést küldeni a rendelés állapotáról. Korábban az első beállítást több Meta-irányítópulton kellett önállóan elvégezni, vagy fejlesztőt kellett felvenni. Most ezt a részt egy ügynökkel folytatott beszélgetésben is elvégezheti. A bejövő üzenetek kezelését továbbra is külön kell kiépítenie a saját címén — ez a webhook beállítása utáni következő feladat.

A szerver akkor is hasznos, ha az integráció már működik. Az üzenetsablonokat rendszeresen frissíteni kell: új promóció, új értesítési szöveg. A szerveren keresztül az ügynök létrehoz vagy szerkeszt egy sablont, és megmutatja a jóváhagyási állapotát anélkül, hogy az irányítópultra kellene lépnie.

Hasonló megközelítést — amikor az ügynök egy külső rendszerhez csatlakozik, majd az Ön leírása alapján dolgozik vele — mutat be dokumentációval együtt a NotebookLM csatlakoztatása a Claude Code-hoz MCP-n keresztül című útmutató.

Mi a következő lépés?#

A szerver bejelentése három napja történt. Egyetlen paranccsal kezdheti, majd bejelentkezhet a Metán keresztül, és megkérheti az ügynököt, hogy listázza a vállalkozásait. Ezután az igényeitől függően jöhetnek a telefonszámok, a sablonok, a webhookok és a tesztüzenetek.

Az ügynök külső rendszerekhez csatlakoztatásának további módjait a MCP-szerverek a Claude Code-hoz gyűjteményben találja — további hét működő integráció érhető el különféle feladatokhoz.

Ismerje meg az Ailootot.