Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Chatwoot con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Chatwoot, la inbox di supporto omnicanale, in cloud o self-hosted: conversazioni e messaggi da WhatsApp, e-mail, web chat e canali social, contatti, etichette, agenti, team, risposte predefinite e report di supporto (prima risposta, tempi di risoluzione e di risposta). Risposte, note private e nuove conversazioni sono incluse, ma disattivate all'installazione.
Prova a chiedere
Prompt di esempio per Chatwoot
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Chatwoot, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Chatwoot + Meta Muse
Chatwoot, la inbox di supporto omnicanale, in cloud o self-hosted: conversazioni e messaggi da WhatsApp, e-mail, web chat e canali social, contatti, etichette, agenti, team, risposte predefinite e report di supporto (prima risposta, tempi di risoluzione e di risposta). Risposte, note private e nuove conversazioni sono incluse, ma disattivate 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:
CHATWOOT_URL, CHATWOOT_API_TOKEN, CHATWOOT_ACCOUNT_ID
Step 1 — Ottieni le credenziali
La configurazione richiede circa 2 minuti. Ti serve un account Chatwoot, su Chatwoot Cloud o self-hosted, e l'access token dell'utente con cui l'AI deve lavorare.
- Accedi a Chatwoot con quell'utente. Gli agenti vedono solo le conversazioni delle inbox di cui fanno parte e non possono leggere i report, quindi per il quadro completo usa un amministratore.
- Clicca sul tuo avatar, poi su Profile Settings, e copia l'Access Token in fondo alla pagina in
CHATWOOT_API_TOKEN. Non scade; puoi reimpostarlo dalla stessa pagina. - Imposta
CHATWOOT_URLsull'indirizzo con cui apri Chatwoot:https://app.chatwoot.comsu Chatwoot Cloud, oppure il tuo dominio, per esempiohttps://chat.example.com, se è self-hosted. Niente percorso, niente/app, niente/api. - Imposta
CHATWOOT_ACCOUNT_IDsul numero dopo/app/accounts/nella barra degli indirizzi del browser:https://app.chatwoot.com/app/accounts/3/dashboardsignifica 3. - Installa il connettore ed esegui
chatwoot_get_profile: mostra l'utente dietro il token, il suo ruolo e tutti gli account che il token raggiunge, con il relativo id.
Token di account, non Platform API: il token di una Platform App di un super admin (/platform/api) qui non funziona. Il connettore usa la Application API di Chatwoot per un account.
Self-hosted dietro nginx: il token viaggia nell'header api_access_token, e nginx scarta gli header con il trattino basso finché non imposti underscores_in_headers on;. Si vede come un 401 a ogni chiamata anche se il token è giusto. Un Chatwoot self-hosted raggiungibile solo in una rete privata non è accessibile da AnythingMCP Cloud; in quel caso usa un AnythingMCP self-hosted dentro quella rete.
Cosa legge: l'account e l'utente dietro il token; le tue inbox (WhatsApp, e-mail, web widget, API, Instagram, Telegram e altre) con i loro membri; agenti e amministratori con la loro disponibilità; i team e i loro membri; etichette, risposte predefinite (canned responses) e definizioni degli attributi personalizzati; le conversazioni con stato, priorità, inbox, etichette, contatto, assegnatario e team, come elenco, come conteggio o con filtri come create dopo una data e assegnate a un agente; i messaggi di una conversazione, comprese note private e allegati; i contatti per nome, e-mail, telefono o identificativo, con tutte le loro conversazioni su ogni inbox; e i report di supporto: totali di un periodo accanto al periodo precedente, una metrica nel tempo, agenti, inbox o team a confronto e cosa è aperto e senza risposta in questo momento. I segreti dei canali delle inbox e l'access token dell'utente vengono rimossi dalle risposte.
Orari e numeri: gli orari di conversazioni e messaggi e i periodi dei report sono timestamp Unix in secondi (UTC), e l'AI li converte prima di citarti un orario. Prima risposta, tempo di risoluzione e tempo di risposta nei report sono in secondi.
Chiede prima di ogni modifica: chatwoot_set_conversation_labels. Chatwoot sostituisce l'intero elenco di etichette di una conversazione, quindi l'AI legge prima le etichette attuali e le invia insieme a quella nuova (o senza quella da togliere). Le etichette devono già esistere nell'account. L'AI ti mostra la conversazione e il nuovo elenco e aspetta il tuo sì.
Disattivati all'installazione: chatwoot_send_message (una risposta, o una nota privata visibile solo agli agenti) e chatwoot_create_conversation. Una risposta o un primo messaggio arriva subito al cliente su WhatsApp, e-mail o chat, quindi un amministratore li attiva consapevolmente. Anche allora l'AI ti mostra il testo e il destinatario e aspetta il tuo sì. Nelle inbox WhatsApp Cloud API il testo libero arriva a un contatto solo entro 24 ore dal suo ultimo messaggio; fuori da questa finestra Chatwoot richiede un modello approvato, che questo connettore non invia.
Limiti: le conversazioni arrivano 25 per pagina, i contatti 15 per pagina e i messaggi 20 alla volta, quindi l'AI scorre le pagine; per un semplice numero conta invece di elencare. Report e statistiche live richiedono il token di un amministratore.
Errori comuni: 401 significa un token sbagliato o reimpostato, oppure nginx che scarta l'header. Un 404 a ogni chiamata di solito indica un CHATWOOT_URL o un CHATWOOT_ACCOUNT_ID sbagliato; un 404 su una sola conversazione indica un id che questo utente non può vedere. I report rispondono 401 o 403 agli agenti che non sono amministratori.
Il connettore non usa la Platform API, non invia modelli WhatsApp, non risolve, riassegna o elimina conversazioni esistenti e non modifica né elimina contatti.
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 Muse
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 mostraYOUR_SERVER_ID.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Chatwoot.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
chatwoot_get_profile | Get the user behind the access token: id, name, email, role, availability and every account the token can reach (accounts[].id and name) |
chatwoot_get_account | Get the Chatwoot account configured in CHATWOOT_ACCOUNT_ID: name, locale, domain, support e-mail, status, enabled features and custom… |
chatwoot_list_inboxes | List the inboxes (channels) of the account: id, name, channel type (WhatsApp, API, web widget, e-mail, Instagram, Telegram...), phone… |
chatwoot_list_inbox_agents | List the agents who are members of one inbox (id, name, email, role, availability) |
chatwoot_list_agents | List the agents and administrators of the account: id, name, email, role (agent or administrator), availability (online, busy, offline) and… |
chatwoot_list_teams | List the teams of the account (id, name, description, whether auto-assignment is on) |
chatwoot_list_team_members | List the agents in one team (id, name, email, role, availability) |
chatwoot_list_labels | List the labels defined in the account: id, title, description and color |
chatwoot_list_canned_responses | List the canned responses (saved replies) of the account: id, short code and content |
chatwoot_list_custom_attributes | List the custom attribute definitions of the account for conversations (attribute_model 0) or contacts (1): key, display name, type and… |
chatwoot_list_conversations | List conversations, 25 per page, newest activity first, with counts (mine, assigned, unassigned, all) |
chatwoot_count_conversations | Count conversations without listing them: mine_count, assigned_count, unassigned_count and all_count for a status, inbox, team or label |
chatwoot_filter_conversations | Filter conversations with Chatwoot's advanced filter, 25 per page: a list of conditions on status, assignee_id, inbox_id, team_id… |
chatwoot_get_conversation | Get one conversation by its id (the number shown in the Chatwoot URL): status, priority, inbox, labels, contact, assignee, team, custom and… |
chatwoot_list_messages | List the messages of a conversation, oldest first: the latest 20 by default, or 20 older than before. message_type 0 = incoming (from the… |
chatwoot_list_contacts | List contacts with an e-mail, phone number or identifier, 15 per page: id, name, e-mail, phone, identifier, custom and additional… |
chatwoot_search_contacts | Search contacts by name, e-mail, phone number or identifier (case-insensitive, partial), 15 per page. meta.has_more tells whether another… |
chatwoot_get_contact | Get one contact: name, e-mail, phone, identifier, custom and additional attributes, last activity and the inboxes the contact is reachable… |
chatwoot_list_contact_conversations | List the conversations of one contact across all inboxes, with status, labels, assignee and last message |
chatwoot_get_report_summary | Get the totals of a period for the account, an agent, an inbox, a label or a team: conversations, incoming and outgoing messages… |
chatwoot_get_report_timeseries | Get one metric over time as [{value, timestamp}] buckets, for the account, an agent, an inbox, a label or a team, grouped by hour, day… |
chatwoot_get_summary_by | Compare agents, inboxes or teams over a period, one row each: conversations, resolved and handled conversations, average resolution, first… |
chatwoot_get_live_conversation_stats | Right now: how many conversations are open, unattended (no reply yet) and unassigned for the whole account (type account), or open and… |
chatwoot_send_message | Send a reply in an existing conversation, or add a private note that only agents see (private true) |
chatwoot_set_conversation_labels | Set the labels of a conversation |
chatwoot_create_conversation | Start a new conversation with an existing contact in an inbox, optionally with a first message, status, assignee and team |
Esempi di prompt
- "Quante conversazioni aperte non sono assegnate a nessuno in questo momento, e quali agenti hanno chat senza risposta?"
- "Leggi la conversazione 1284 e riassumimi cosa vuole il cliente e cosa gli abbiamo già promesso."
- "Trova il contatto [email protected] ed elenca tutte le sue conversazioni su WhatsApp ed e-mail."
- "Confronta i nostri agenti negli ultimi 30 giorni: conversazioni gestite, tempo di prima risposta e tempo di risoluzione."
- "Aggiungi l'etichetta rimborso alla conversazione 1284 mantenendo le altre. Mostrami prima il nuovo elenco."
FAQ
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
Questa guida ti è stata utile?
