Come collegare Interakt a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Interakt, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Interakt + Cursor

Fai lavorare la tua AI con il tuo account Interakt per WhatsApp Business: elenca i modelli approvati, cerca ed elenca i clienti con i loro attributi e tag, aggiungi o aggiorna clienti, registra eventi e assegna le chat. L'invio di messaggi con modello e di testo è disattivato all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

INTERAKT_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Interakt con piano Growth o superiore: l'accesso API parte da lì.

1. In Interakt apri Settings → Developer Setting.
2. Copia la Secret Key in INTERAKT_API_KEY esattamente come appare, senza la parola Basic davanti. La chiave è già codificata, e il connettore la invia solo ad api.interakt.ai.
3. Installa il connettore ed esegui interakt_list_templates: elenca i tuoi modelli WhatsApp e conferma che chiave e piano funzionano.

Numeri di telefono: quasi tutti gli strumenti vogliono il numero senza prefisso internazionale e il prefisso a parte, per esempio 9876543210 e +91 (l'India è il valore predefinito). Lo strumento per il testo libero vuole il numero completo senza +, per esempio 919876543210.

Cosa legge: i tuoi modelli WhatsApp con nome in codice, nome visualizzato, lingua, categoria, stato di approvazione, intestazione, corpo con i segnaposto, piè di pagina e pulsanti; i clienti per numero di telefono o id Interakt, con attributi come nome, email, consenso WhatsApp e i tuoi attributi personalizzati, più tag e date di creazione e ultima modifica; e i clienti creati o modificati in un intervallo di tempo, 100 alla volta.

Nessuna cronologia dei messaggi: l'API di Interakt non restituisce i messaggi passati né lo stato di consegna, che arrivano solo ai webhook di Interakt. L'AI non può dirti se un cliente ha letto un messaggio.

Chiede prima di ogni modifica: interakt_upsert_customer crea un cliente o aggiorna quello con lo stesso numero (gli attributi vengono uniti, i tag aggiunti e mai rimossi), interakt_track_event registra un evento come Order Placed nella timeline del cliente, che può avviare automazioni Interakt che scrivono al cliente, e interakt_assign_chat assegna la chat di un cliente nella inbox condivisa a un membro del team tramite email. L'AI ti mostra il cliente e la modifica esatta e aspetta il tuo sì.

Disattivati all'installazione: interakt_send_template e interakt_send_text. Raggiungono subito il cliente, e per i modelli Meta addebita la conversazione. Il testo libero funziona solo entro 24 ore dall'ultimo messaggio del cliente; fuori da questa finestra Interakt lo rifiuta e funziona solo un modello approvato. Un modello richiede esattamente un valore per ogni segnaposto ({{1}}, {{2}} e così via), nell'ordine giusto, quindi l'AI legge prima il modello e li conta; i modelli con intestazione immagine o documento richiedono anche un link pubblico al file. Un amministratore attiva questi strumenti consapevolmente, e anche allora l'AI ti mostra modello o testo, numero e valori e aspetta il tuo sì. Una risposta positiva significa che Interakt ha accettato il messaggio, non che è stato consegnato.

Limiti: Interakt consente 300 richieste al minuto con Growth e 600 con Advanced, e una singola richiesta può pesare al massimo 32 KB. Dopo un 429 l'AI aspetta un minuto prima di riprovare.

Errori comuni: 401 significa che la chiave è sbagliata o che il tuo piano non ha accesso API: copia di nuovo la Secret Key senza Basic e verifica di avere Growth o superiore. 400 indica un campo mancante o errato, e il messaggio di Interakt dice quale, per esempio "Missing variable values for template's body" quando manca un valore del modello. 429 indica che è stato raggiunto il limite di richieste.

Il connettore non crea modelli, non gestisce campagne, non carica media, non ripiega su RCS o SMS e non gestisce webhook.

Step 2 — Installa l'adapter

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

Step 3 — 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 Interakt.

Tool disponibili

Esempi di prompt

• "Cerca la cliente +91 98765 43210 e mostrami nome, tag e se ha dato il consenso a WhatsApp."
• "Quali dei nostri modelli approvati sono di marketing, e quanti segnaposto richiede ciascuno?"
• "Elenca i clienti aggiunti o modificati ieri in Interakt."
• "Registra un evento Order Placed per +91 98765 43210 con ordine numero 1042 e totale Rs 1,499. Mostramelo prima."
• "Assegna la chat di Rahul Sharma (+91 99887 76655) a [email protected]. Chiedimi conferma prima di farlo."

FAQ

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

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT