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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Chatwoot. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, 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 |
chatwoot_add_agent | Invite a person to the account as an agent or administrator |
chatwoot_update_agent | Change an agent's role (agent or administrator), availability or auto-offline setting |
chatwoot_remove_agent | Remove an agent from the account |
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?