Come collegare Whatsapp Business a Cursor — via MCP

💡 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 Cursor

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 Cursor 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).
• Cursor installato.

Step 1 — Ottieni le credenziali WhatsApp Business

1. Apri https://developers.facebook.com/ → la tua App → WhatsApp → API Setup. Annota il WhatsApp Business Account ID (WABA ID).
2. 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ù.
3. 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

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, clicca WhatsApp Business e compila:

Clicca Install — l'adapter è ora nel tuo catalogo con 14 tool.

Step 3 — Scopri il tuo phoneNumberId

Chiedi a Cursor 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 Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di WhatsApp Business.

Tool disponibili (14 totali)

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 Cursor, così quando chiedi "manda un follow-up a quel cliente" giorni dopo la sua ultima risposta, Cursor 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

Funziona senza un numero business verificato? Il numero di test di Meta funziona per le prove (solo verso numeri aggiunti come tester). Per inviare in produzione a qualsiasi destinatario, il tuo numero mittente deve essere verificato e registrato sul tuo WABA.

Cosa succede se invio testo libero fuori dalla finestra 24h? Meta risponde con codice 131047 ("Re-engagement message"). Usa whatsapp_send_template_message.

L'adapter può ricevere messaggi in entrata? No direttamente — Meta usa webhook per l'inbound, e il REST engine di AnythingMCP è outbound-only. Fai girare un piccolo receiver webhook accanto a AnythingMCP e usa questo connettore per outbound + whatsapp_mark_message_as_read per le ricevute.

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Gemini
• Collega a Meta Muse