No install? Use cloud.anythingmcp.com directly.
Sign in, install the WhatsApp Business Cloud API in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.
TL;DR
Collega la WhatsApp Business Cloud API di Meta a Claude con AnythingMCP. Invia testo, template, media, messaggi vocali e pulsanti interattivi da Claude Desktop, Claude Code o claude.ai in linguaggio naturale.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → WhatsApp Business, inserisci il System User access token permanente + l'ID del WhatsApp Business Account, genera una MCP API key — fatto. Niente Docker, niente
git clone, niente server locale da avviare. Salta i passi di installazione locale qui sotto e vai direttamente alla configurazione del client.
Collegare WhatsApp Business a Claude
La WhatsApp Business Cloud API è il gateway ospitato da Meta per inviare messaggi WhatsApp via API — testo, template, media, messaggi vocali, pulsanti interattivi, geolocalizzazione. Con AnythingMCP guidi tutto da Claude Desktop, Claude Code o claude.ai in italiano. Niente SDK da incollare, niente JSON-a-mano per ogni tipo di messaggio.
Cosa puoi fare
- "Invia 'Il tuo ordine è stato spedito — traccialo su https://acme.com/t/12345' al +39 348 5123 456."
- "Invia il template
conferma_ordine(it) al +39 333 123 4567, compila 'Mario' e 'ORD-9912'." - "Invia il PDF di fattura su https://acme.com/inv/9912.pdf al mio cliente con didascalia 'Fattura 9912'."
- "Lista i template approvati sul mio WABA, poi invia quello di benvenuto in italiano a questo nuovo lead."
Prerequisiti
- Un WhatsApp Business Account (WABA) con almeno un numero mittente verificato.
- Un System User access token permanente con i permessi
whatsapp_business_messaging+whatsapp_business_management(il token dev temporaneo di 24h va bene per test ma scade). - AnythingMCP in locale o su cloud.anythingmcp.com (setup di 3 minuti).
- Claude Desktop, Claude Code o un account claude.ai.
Step 1 — Ottieni le credenziali WhatsApp Business
- Apri https://developers.facebook.com/ → la tua App → WhatsApp → API Setup. Annota il WhatsApp Business Account ID (WABA ID).
- Vai su Meta Business Suite → Impostazioni Business → System Users, crea un System User, assegna il tuo WABA e Genera un nuovo token con i permessi
whatsapp_business_messaging+whatsapp_business_management. Copialo — non lo rivedi più. - Verifica che il numero mittente sia verificato in API Setup (il numero di test funziona subito; per la produzione aggiungi e verifica il tuo).
Step 2 — Installa l'adapter WhatsApp Business
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
Apri http://localhost:3000/connectors/store, clicca WhatsApp Business e compila:
| Campo | Valore |
|---|---|
WHATSAPP_ACCESS_TOKEN | il System User token permanente |
WHATSAPP_BUSINESS_ACCOUNT_ID | il tuo WABA ID (es. 123456789012345) |
Clicca Install — l'adapter è ora nel tuo catalogo con 14 tool.
Step 3 — Scopri il tuo phoneNumberId
Chiedi a Claude di chiamare whatsapp_list_phone_numbers (con il tuo WABA ID come businessAccountId). Riceverai l'id di ciascun numero mittente — fissa quel valore, ogni tool di invio lo richiede come phoneNumberId.
Step 4 — Aggiungi il connettore in Claude (zero codice, 4 click)
Percorso consigliato — funziona su claude.ai web senza toccare alcun file di configurazione.
- Apri claude.ai/customize/connectors.
- Clicca "Add custom connector".
- Compila:
- Name:
WhatsApp Business - URL:
https://cloud.anythingmcp.com/mcp - Authentication: Bearer token → incolla la tua MCP API key (da AnythingMCP → Profile → MCP API Keys → New Key)
- Name:
- Clicca Connect per autorizzare.
Fatto. Tutti i 14 tool WhatsApp compaiono nella tua chat — inizia a scrivere prompt.
Avanzato: Claude Desktop / Claude Code (JSON / CLI)
Claude Desktop — modifica ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %AppData%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"whatsapp-business": {
"url": "https://cloud.anythingmcp.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_API_KEY"
}
}
}
}
Riavvia Claude Desktop. I tool WhatsApp compaiono nel menu 🔧.
Claude Code — un comando CLI:
claude mcp add whatsapp-business \
--transport http \
--url https://cloud.anythingmcp.com/mcp \
--header "Authorization: Bearer YOUR_MCP_API_KEY"
Verifica con claude mcp list.
Tool disponibili (14 totali)
| Gruppo | Tool |
|---|---|
| Discovery | whatsapp_list_phone_numbers, whatsapp_list_message_templates, whatsapp_get_message_template |
| Testo & template | whatsapp_send_text_message, whatsapp_send_template_message |
| Media (URL o media ID) | whatsapp_send_image, whatsapp_send_audio, whatsapp_send_video, whatsapp_send_document |
| Interattivi & posizione | whatsapp_send_location, whatsapp_send_interactive_buttons |
| Ricevute & profilo | whatsapp_mark_message_as_read, whatsapp_get_business_profile, whatsapp_update_business_profile |
La finestra di 24 ore — cosa deve sapere il tuo agente
WhatsApp consente l'invio di messaggi free-form (testo, media, interattivi, posizione) solo nelle 24 ore successive all'ultimo messaggio in entrata dell'utente verso il tuo numero. Fuori da quella finestra puoi inviare solo template pre-approvati — chiama whatsapp_send_template_message con il nome del template e la lingua.
Il campo instructions dell'adapter comunica questa regola a Claude, così quando chiedi "manda un follow-up a quel cliente" giorni dopo la sua ultima risposta, Claude userà whatsapp_send_template_message invece del testo libero.
Messaggi vocali
Usa whatsapp_send_audio con link puntato a un file OGG-Opus ospitato su un URL HTTPS pubblico. WhatsApp renderizza OGG-Opus come vero messaggio vocale (forma d'onda + pulsante play). MP3 e AMR funzionano ma compaiono come allegati audio normali.
FAQ
Gemini 1.5 Pro o 2.x supportano MCP? Sì — Gemini CLI ≥ 0.4 e la Vertex AI tools API accettano connettori MCP httpUrl con header Bearer.
Prossimi passi
Questa guida ti è stata utile?