Yakha Iseva Eyimfihlo Yokusesha Imilayezo Ye-WhatsApp usebenzisa i-whatsapp-mcp

Lokho okwenziwa yi-whatsapp-mcp

whatsapp-mcp iyiseva encane evumela i-ejenti ye-AI ehambisana ne-MCP ukuthi ifunde futhi iseshe imilayezo yakho ye-WhatsApp. Isebenza ku-akhawunti yakho ye-Cloudflare futhi ixhuma ocingweni lwakho njengedivayisi exhunyiwe efana ne-WhatsApp Web.

Ngemva kokusetha kokuqala, amaklayenti afana ne-Claude Code, i-Claude Desktop, noma ezinye izinhlelo ze-MCP angaphendula imibuzo efana nale:

• Utheni uDana mayelana nezindiza?
• Thola yonke imilayezo ekhuluma ngokuqashisa kuzo zonke izingxoxo.
• Fingqa engikuphuthelwe yikho eqenjini lomndeni kuleli sonto.

Iseva yakhelwe ukufunda kuphela: ingaqoqa, iseshe, futhi ibonise imilayezo, kodwa ayikwazi ukuthumela imilayezo ye-WhatsApp.

Indlela uhlelo olusebenza ngayo

Ucingo lwakho luhlala luwumthombo wolwazi oyinhloko. Ukuthunyelwa kwe-Cloudflare kusebenza njengedivayisi exhunyiwe futhi kuxhuma ku-WhatsApp kuphela lapho kudingeka ukuvumelanisa idatha noma lapho uxhumanisa i-akhawunti.

Lapho i-ejenti icela ulwazi, iseva ithatha izibuyekezo ezilindile ku-WhatsApp uma ikhophi egciniwe indala ngemizuzu engaphezu kweyishumi. Ukuthathwa okuhleliwe kwedatha kwenzeka kanye ngosuku. Ngemva kokuqoqa imilayezo, iseva iyazinqamula futhi. Ucingo lwakho luyaqhubeka nokusebenza ngokujwayelekile futhi luyaqhubeka nokwamukela izaziso.

Imilayezo igcinwa kusizindalwazi se-SQLite ngaphakathi kwe-Cloudflare Durable Object eku-akhawuntini yakho. Iseva ayithumeli umlando wemilayezo yakho kusevisi yangaphandle yokugcina idatha.

Izidingo zangaphambili

Ngaphambi kokufaka, lungisa okulandelayo:

• I-akhawunti ye-Cloudflare ohlelweni lwe-Workers Paid.
• Node.js 20 noma entsha.
• Ucingo olunekhonte ye-WhatsApp ofuna ukuyixhumanisa.
• Iklayenti le-MCP, njenge-Claude Code noma i-Claude Desktop.

Uhlelo olukhokhelwayo lwe-Workers lubalulekile ngoba ukungenisa umlando omkhulu we-WhatsApp kungadlula umkhawulo ozenzakalelayo we-CPU. Indawo yokugcina iphakamisa lowo mkhawulo ku-wrangler.jsonc, futhi i-Cloudflare idinga uhlelo olukhokhelwayo ukuze kusetshenziswe umkhawulo ophakeme.

Faka bese uthumela

Clone indawo yokugcina, faka okuncikile kuyo, dala i-KV namespace edingekayo, gcina iphasiwedi yomnikazi, bese uthumela i-Worker:

git clone https://github.com/finereli/whatsapp-mcp
cd whatsapp-mcp
npm install

npx wrangler kv namespace create OAUTH_KV
npx wrangler secret put OWNER_PASSWORD
npm run deploy

Iphasiwedi kufanele ibe nezinhlamvu okungenani ezingu-12. Lapho ukuthunyelwa sekuqediwe, u-Wrangler uzobonisa i-URL efana ne-https://whatsapp-mcp.your-name.workers.dev. Vula leyo URL ukuze uqhubeke nokusetha.

Uma ufuna ukusebenzisa isizinda sangokwezifiso, landela ukuphawula okusezansi kwe-wrangler.jsonc.

Xhumanisa i-akhawunti yakho ye-WhatsApp

Ikhasi lokuthunyelwa linikeza izinyathelo ezisele zokusetha.

1. Khetha inketho yokuxhumanisa i-WhatsApp.
2. Vula i-WhatsApp ocingweni lwakho uye ku-Settings, Linked Devices, bese kuba ku-Link a Device.
3. Skena ikhodi ye-QR eboniswa yiseva. Uma usebenzisa lona lolo cingo futhi ungakwazi ukuskena isikrini salo, sebenzisa inketho yokuxhumanisa ngenombolo yocingo.
4. Linda ngenkathi ukuxhumana kokuqala kungenisa umlando i-WhatsApp ewenzela idivayisi entsha.

Ikhasi libonisa inqubekelaphambili yokungenisa, futhi ungalivala ngenkathi inqubo iqhubeka. Ukungenisa kokuqala kungase kungafaki yonke imilayezo yakudala ngoba i-WhatsApp iyona enqumayo ukuthi yimuphi umlando ezowunikeza idivayisi esanda kuxhunywa.

Xhuma iklayenti le-MCP

Ku-Claude Code, bhalisa iseva ethunyelwe usebenzisa i-endpoint yayo ye-/mcp:

claude mcp add --transport http whatsapp https://your-url/mcp

Bese usebenzisa i-/mcp ku-Claude Code bese ungena usebenzisa iphasiwedi yomnikazi. Amanye amaklayenti e-MCP kufanele amiswe nge-URL efanayo:

https://your-url/mcp

Uma usuqinisekisiwe, cela i-ejenti ukuthi ibhale izingxoxo, ithole imilayezo, noma iseshe umlando wakho.

Sebenzisa amathuluzi atholakalayo

Iseva ye-MCP inikeza amathuluzi agxile ekufundeni nasekulondolozeni ikhophi yemilayezo yendawo:

• list_chats ibhala izingxoxo, iqala ngezamuva kakhulu, futhi ivumela ukuhlunga ngokuzikhethela ngegama noma ngenombolo.
• get_messages ifunda imilayezo engxoxweni eyodwa futhi isekela ukupheqa emuva noma phambili ngokwedethi.
• search_messages yenza ukusesha kombhalo ogcwele kuzo zonke izingxoxo noma engxoxweni ekhethiwe.
• unnamed_chats ithola izingxoxo ezaziwa ngenombolo yocingo kuphela, ibeke phambili izingxoxo ezimatasa kakhulu futhi ibonise umyalezo wakamuva ovela komunye umuntu.
• set_contact_names igcina amagama ezinombolo zocingo ukuze nawo avele kahle ezingxoxweni zamaqembu.
• sync_now ithatha imilayezo emisha ngokushesha.
• link_status ibika ukuthi i-akhawunti ixhunyiwe yini, ukuthi yagcina nini ukuvumelaniswa, nokuthi ingakanani idatha egciniwe.
• relink isusa ukuxhumana kwamanje bese iqala kabusha inqubo yokuxhumanisa. Imilayezo egciniwe iyaqhubeka itholakala.

Amathuluzi okufunda avumelanisa ngokuzenzakalelayo kuqala lapho ikhophi egciniwe indala ngemizuzu engaphezu kweyishumi. Ngakho ungasebenzisa izicelo zolimi lwemvelo ngaphandle kokubiza i-sync_now mathupha kukho konke ukusesha.

Xazulula izingxoxo ezibonisa izinombolo zocingo kuphela

Ezinye izingxoxo zivela njengezinombolo zocingo ngoba i-WhatsApp ayinikezi wonke amadivayisi axhunyiwe igama loxhumana naye. Lokhu kuvamile ezingxoxweni zesikhathi esisodwa noma kubantu abangagciniwe koxhumana nabo be-WhatsApp.

Buza i-ejenti yakho:

Find names for my unnamed chats.

I-ejenti ingabiza i-unnamed_chats, iqhathanise izinombolo nokuhlanganiswa koxhumana nabo esinakho kakade, bese ithumela okufanayo nge-set_contact_names. Ngokwesibonelo, isixhumi se-Google Contacts noma se-Gmail singanikeza amagama ahambisanayo. Iseva ngokwayo ayingeni kusevisi yoxhumana nabo.

Amagama agciniwe ahlotshaniswa nenombolo yocingo, ngakho angasetshenziswa nasezingxoxweni zamaqembu. Ezinye izinombolo zizoqhubeka zingenagama lapho kungekho oxhumana naye ofanayo.

Qonda umlando wemidiya nemilayezo

Amafayela emidiya awalandwa. Izithombe, amanothi ezwi, namadokhumenti amelelwa amalebula afana nokuthi [image] noma [voice note 12s]. Amagama achazayo ayagcinwa uma i-WhatsApp iwahlinzeka, kodwa imilayezo yezwi ayiguqulelwa embhalweni.

Isixhumanisi sokuqala singenisa noma yimuphi umlando i-WhatsApp ekhetha ukuwuthumela. Umlando uvamise ukulethwa kanye ngesixhumanisi ngasinye. Uma ukungenisa kungaphelele, ukuxhumanisa kabusha kungacela okunye ukungenisa ngenkathi kugcinwa imilayezo esivele igciniwe. I-ingest yakhelwe ukuthi ibe yi-idempotent, ngakho ukungenisa kabusha akudali ngamabomu imigqa ephindiwe.

Xhumanisa kabusha i-akhawunti

Xhumanisa kabusha uma i-WhatsApp ibika ukuthi idivayisi isusiwe noma uma ufuna ukuqala kabusha inqubo yokumatanisa. Cela i-agent yakho ukuthi isebenzise i-relink, noma uvule i-/setup bese ukhetha u-Unlink and scan again.

Skena ikhodi entsha ye-QR uma utshelwa. Imilayezo ekhona egciniwe iyagcinwa, kanti isixhumanisi esisha singagcwalisa umlando ongekho.

Ukucushwa okuthuthukisiwe

Ukusetshenziswa okuzenzakalelayo kusebenzisa ukuqinisekiswa ngephasiwedi. Amanani amakhulu okucushwa afaka:

• OWNER_PASSWORD: iphasiwedi yomnikazi, enobude obuncane bezinhlamvu eziyi-12.
• OWNER_EMAIL: ikheli le-imeyili kuphela elivunyelwe uma kusetshenziswa imodi ye-login-service.
• OPERATOR_NAME: igama elingaphoqelekile eliboniswa ekhasini lobumfihlo.
• DEFAULT_COUNTRY_CODE: ikhodi yezwe enezinombolo kuphela esetshenziswa uma i-agent igcina inombolo engenayo ikhodi yezwe.
• LOGIN_ORIGIN: ishintshela ukusetshenziswa kumodi ye-login-service.
• ALLOWED_ORIGINS: ama-origin amukelwayo amathokheni e-login-service.
• PIN: inani elingaphoqelekile elinezinhlamvu ezingu-32 noma ngaphezulu elivumela imizila ye-debug evikelwe nge-header ye-x-pin.
• OAUTH_KV kanye ne-WA: ama-binding e-KV ne-Durable Object asetshenziswa uhlelo.

Gcina amanani aqondene nokusetshenziswa okuthile njengendawo, i-KV ID, ne-imeyili efayeleni le-wrangler.local.jsonc elingalandelwanga yi-git. Sebenzisa ukucushwa kwasendaweni ngokuthi:

npm run deploy:local

Lungisa izinkinga zokuvumelanisa

Uma ucushwa i-PIN, iseva inikeza ama-endpoint okuxilonga avikelwe. Thumela i-PIN ku-header ye-x-pin:

• /debug ibonisa isigaba seseshini, isimo sesixhumanisi, izibalo, nemicimbi yakamuva yeseshini.
• /debug/pull iqala ukuvumelanisa ngokushesha.
• /debug/chats?q=, /debug/messages?chat=, /debug/search?q=, kanye ne-/debug/types kuhlola idatha egciniwe.
• /debug/unnamed ibonisa izingxoxo ezibuyiswe yi-unnamed_chats.
• /debug/sql?q= isebenzisa umbuzo owodwa we-SELECT wokufunda kuphela ngokumelene nesitoreji.
• /debug/logout yenza okulingana nokuxhumanisa kabusha.

Ngemva kokusetshenziswa ngempumelelo, ukulandelana okuwusizo kokuqinisekisa ukuhlola ukuthi i-/debug ibika iseshini engasebenzi kanye ne-akhawunti exhunyiwe, usebenzise i-/debug/pull, bese uhlola ukufakwa kuhlu kwezingxoxo, ukubuyiswa kwemilayezo, ukusesha kombhalo ogcwele, ukuphathwa kwezingxoxo ezingenamagama, nokuqanjwa koxhumana nabo.

Thuthukisa endaweni

Ekuthuthukiseni kwasendaweni, dala ifayela le-.dev.vars eliqukethe iphasiwedi ende ngokwanele bese uqala i-Worker:

OWNER_PASSWORD=your-12-character-or-longer-password

npm run dev

Ukuthuthukisa kwasendaweni kusebenzisa i-Durable Object ehlukile enesitoreji esingenalutho. Kungahlola ukugeleza kokungena ngemvume futhi kubonise ikhodi yangempela ye-QR, kodwa ukuxhumanisa ifoni endaweni kudala enye idivayisi exhunyiwe.

Ngaphambi kokuthumela izinguquko zekhodi, sebenzisa:

npm run typecheck
npm test

I-test suite isebenzisa ikhodi yesitoreji ngokumelene ne-SQLite eyakhelwe ngaphakathi ku-Node ku-Node 22.13 noma kamuva. Ukusesha kombhalo ogcwele akumboziwe yileyo ndawo ye-SQLite, ngakho hlola ukusesha ngemva kokusetshenziswa futhi.

Ukucatshangelwa okubalulekile kwezokuphepha nenkundla

Le phrojekthi ayiyona i-integration esemthethweni ye-WhatsApp. I-WhatsApp ayinikezi i-API yokufunda imilayezo yomuntu siqu, futhi le phrojekthi isebenzisa iphrothokholi efanayo ne-WhatsApp Web ngomtapo wolwazi ovulekile i-Baileys. Lokho kusetshenziswa kungaphula imigomo ye-WhatsApp. Yisebenzise kuphela nge-akhawunti yakho, futhi khumbula ukuthi ingozi esebenzayo iphansi kudivayisi exhunyiwe efunda kuphela, kodwa ayikho ku-zero.

Ukusetshenziswa okukodwa kuhloselwe umuntu oyedwa ne-akhawunti eyodwa ye-WhatsApp. Ukusetshenziswa ngakunye kugcina umlando ophelele wemilayezo kanye nokungena bukhoma kwe-akhawunti, ngakho abasebenzisi kufanele basebenzise ukusetshenziswa okuhlukene kunokwabelana ngokukodwa.

Imilayezo ihlala ngaphakathi kwesitoreji se-SQLite se-Durable Object, kodwa noma ubani othola ukufinyelela emininingwaneni yokufakazela ubuqiniso yokusetshenziswa noma ekuqinisekisweni komnikazi angafinyelela umlando ogciniwe. Vikela iphasiwedi, i-akhawunti ye-Cloudflare, izimfihlo, kanye nanoma iyiphi i-PIN ye-debug ngokucophelela.

Isiphetho

i-whatsapp-mcp inikeza ibhuloho elisebenzayo phakathi kwephrothokholi yedivayisi exhunyiwe ye-WhatsApp namaklayenti e-MCP. Yisebenzise ku-Cloudflare, xhumanisa ifoni yakho kanye, xhuma i-agent ku-/mcp, bese usebenzisa amathuluzi afana ne-search_messages, get_messages, kanye ne-set_contact_names ukuze uhlole ingobo yakho yomlando wemilayezo. Idizayini yayo efunda kuphela, isitoreji sangasese se-Durable Object, ukuvumelanisa okuhleliwe, kanye nokugeleza okucacile kokuxhumanisa kabusha kuyenza ifanele ukusesha imilayezo yomuntu siqu ngenkathi ugcina ukusetshenziswa ngaphansi kolawulo lwakho.