Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Intercom 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
Fai lavorare la tua AI in Intercom: trova e aggiorna contatti e aziende, leggi, cerca e smista conversazioni e ticket (rispondi, aggiungi note, assegna, posticipa, chiudi, applica tag) e gestisci articoli e raccolte dell'Help Center. Workspace negli Stati Uniti, nell'UE o in Australia, con l'access token di un'app del Developer Hub.
Prova a chiedere
Prompt di esempio per Intercom
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 → Intercom, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Intercom + Cursor
Fai lavorare la tua AI in Intercom: trova e aggiorna contatti e aziende, leggi, cerca e smista conversazioni e ticket (rispondi, aggiungi note, assegna, posticipa, chiudi, applica tag) e gestisci articoli e raccolte dell'Help Center. Workspace negli Stati Uniti, nell'UE o in Australia, con l'access token di un'app del Developer Hub.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
INTERCOM_API_URL, INTERCOM_ACCESS_TOKEN
Step 1 — Ottieni le credenziali
- Accedi al tuo workspace Intercom come admin e apri il Developer Hub su
https://app.intercom.com/a/apps/_/developer-hub(oppure Settings → Integrations → Developer Hub). I workspace nell'UE e in Australia usano lo stesso percorso su app.eu.intercom.com o app.au.intercom.com. - Fai clic su New app, dai un nome all'app (per esempio AnythingMCP), scegli il workspace e fai clic su Create app. L'app viene installata subito su quel workspace: per il tuo workspace non servono né OAuth né una revisione dell'app.
- Apri la pagina Configure → Authentication dell'app. Mostra l'Access token del workspace e le autorizzazioni che ha. Per tutti i tool concedi lettura e scrittura su users e companies, conversations, tickets e articles, più Read admins, Read tags e Write tags. Dopo aver cambiato le autorizzazioni, rigenera il token e usa quello nuovo.
- Incolla il token in
INTERCOM_ACCESS_TOKEN, senza la parola Bearer. Trattalo come una password: apre i dati dei clienti del tuo workspace. - Imposta
INTERCOM_API_URLsulla regione del tuo workspace:https://api.intercom.io(Stati Uniti, apri app.intercom.com),https://api.eu.intercom.io(UE, app.eu.intercom.com) oppurehttps://api.au.intercom.io(Australia, app.au.intercom.com). - Installa il connettore ed esegui
intercom_get_me. Restituisce il tuo id admin e il workspace con la sua regione.
Per provarlo: basta un workspace di sviluppo gratuito da https://app.intercom.com/admins/sign_up/developer. Si trova nella regione US, non invia email né notifiche push, contiene fino a 20 users e leads e non può mai diventare un workspace di produzione.
Configurazione in sola lettura: concedi solo le autorizzazioni di lettura (Read and list users and companies, Read conversations, Read tickets, Read and List articles, Read admins, Read tags) e disattiva i tool di scrittura. I tre tool di ricerca leggono soltanto.
Agire come admin: risposte, note, assegnazioni, posticipi, chiusure e riaperture vengono attribuite a un membro del team, così come un nuovo articolo. intercom_get_me trova il tuo id admin, intercom_list_admins quelli degli altri membri del team.
Prima conferma: una risposta in una conversazione, una risposta a un ticket di tipo comment, la chiusura di una conversazione con un messaggio e la pubblicazione di un articolo arrivano ai clienti, e le modifiche a un articolo pubblicato sono subito online. L'AI ti mostra il testo e aspetta il tuo sì. Le note restano interne e i nuovi articoli nascono come bozze. intercom_delete_contact, intercom_delete_article e intercom_delete_collection sono disattivati all'installazione; intercom_archive_contact è il modo reversibile per nascondere un contatto.
Limiti: di default 10.000 chiamate al minuto per app e 25.000 per workspace, distribuite su finestre di 10 secondi. Un 429 vuol dire aspettare qualche secondo.
Errori comuni: 401: il token è sbagliato o è stato rigenerato, l'app è stata disinstallata, oppure INTERCOM_API_URL non corrisponde alla regione del tuo workspace. 403: al token manca un'autorizzazione, oppure il tuo piano non include la funzione (per esempio i ticket). Un 404 su un ticket di solito significa che è stato usato il numero dell'Inbox invece dell'id del ticket. 410: il contatto è stato unito a un altro, quindi cerca per email il contatto rimasto.
Il connettore non avvia messaggi in uscita, non crea conversazioni o ticket, non elimina conversazioni, non unisce contatti e non copre data events, news items, macro, Fin, custom objects, chiamate, esportazioni di dati, webhook e impostazioni del workspace.
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 mostraYOUR_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" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia Cursor.
- Apri Cursor → Settings → MCP e verifica che
anythingmcpsia elencato e connesso. - Inizia a chattare: l'agente ora può usare i tool di
Intercom.
Tool disponibili
| Tool | What it does |
|---|---|
intercom_get_me | Read who the access token belongs to: the admin id, name and email, plus the workspace (app) with its id_code, name, timezone and region |
intercom_list_admins | List the workspace admins (teammates) with id, name, email, away_mode_enabled, has_inbox_seat and team_ids |
intercom_get_admin | Read one admin (teammate): name, email, away mode and reason, inbox seat and the ids of their teams |
intercom_list_teams | List the workspace teams with id, name and admin_ids |
intercom_get_team | Read one team: name, the ids of its admins, the assignment limit and the distribution method |
intercom_list_tags | List every tag in the workspace with id and name |
intercom_create_tag | Create a tag, or return the existing tag with that name (names are case-insensitive) |
intercom_list_segments | List the saved contact and company segments with id, name, person_type and dates, optionally with how many contacts each holds |
intercom_list_data_attributes | List the data attributes of contacts and companies, standard and custom: name, full_name (the field name to use in searches and updates)… |
intercom_list_contacts | List contacts (users and leads), newest first, with id, role, email, name, phone, external_id, owner_id, location, timestamps and… |
intercom_search_contacts | Search contacts by their attributes, e.g. email, name, phone, external_id, role (user or lead), created_at, last_seen_at, tag_id… |
intercom_get_contact | Read one contact: role, email, phone, name, external_id, owner_id, location, browser and device, unsubscribe and bounce flags, timestamps… |
intercom_find_contact_by_external_id | Find a user by the external_id your own system gave them (users only, not leads) |
intercom_create_contact | Create a contact, a user or a lead |
intercom_update_contact | Change a contact: only the fields given are overwritten |
intercom_archive_contact | Archive a contact: it disappears from lists, searches and the Inbox until unarchived with intercom_unarchive_contact |
intercom_unarchive_contact | Bring an archived contact back, so it shows again in lists, searches and the Inbox |
intercom_delete_contact | Delete a contact for good, with their data |
intercom_list_contact_tags | List the tags on one contact with id, name, applied_at and who applied them |
intercom_tag_contact | Put an existing tag on a contact (intercom_create_tag makes a new one) |
intercom_untag_contact | Take a tag off a contact; the tag itself stays in the workspace |
intercom_list_contact_notes | List the internal notes teammates left on a contact, newest first, with id, body (HTML), created_at and author |
intercom_add_contact_note | Leave an internal note on a contact |
intercom_list_contact_companies | List the companies a contact belongs to, with id, company_id, name, plan, user_count, monthly_spend and custom_attributes |
intercom_attach_contact_to_company | Add a contact to a company |
intercom_detach_contact_from_company | Remove a contact from a company; both stay in the workspace |
intercom_list_companies | List companies, or find one by name or by your own company_id, or filter by tag or segment |
intercom_get_company | Read one company by the id Intercom gave it: company_id, name, plan, size, website, industry, user_count, session_count, monthly_spend… |
intercom_create_or_update_company | Create a company, or update the one that already has this company_id (your own id for it, which cannot be changed later) |
intercom_list_company_contacts | List the contacts that belong to a company, with id, role, email and name |
intercom_list_conversations | List conversations, most recently updated first, with id, title, state (open, closed, snoozed), open, read, priority, admin_assignee_id and… |
intercom_search_conversations | Search conversations, e.g. by open, state (open, closed, snoozed), admin_assignee_id, team_assignee_id, contact_ids, tag_ids, priority… |
intercom_get_conversation | Read one conversation with its messages: state, assignees, contacts, tags, priority, statistics and conversation_parts (replies, notes… |
intercom_reply_to_conversation | Reply to a conversation as an admin |
intercom_add_conversation_note | Add an internal note to a conversation |
intercom_assign_conversation | Assign a conversation to an admin or to a team (a conversation can have both), or unassign it with assignee_id "0" |
intercom_close_conversation | Close a conversation (intercom_open_conversation reopens it) |
intercom_snooze_conversation | Snooze a conversation until a time; it reopens by itself then |
intercom_open_conversation | Open a closed or snoozed conversation again, so it is back in the Inbox |
intercom_tag_conversation | Put an existing tag on a conversation (intercom_create_tag makes a new one) |
intercom_untag_conversation | Take a tag off a conversation; the tag itself stays in the workspace |
intercom_search_tickets | Search tickets, e.g. by ticket_type_id, open, state, title, description, category (request for customer tickets, task for back-office… |
intercom_get_ticket | Read one ticket: id, ticket_id (the Inbox number), ticket_attributes (title, description and custom ones), ticket_state, ticket_type… |
intercom_reply_to_ticket | Reply to a ticket as an admin. message_type note stays internal; comment is shown to the customer: show the text and confirm with the user… |
intercom_update_ticket | Change a ticket: its attributes (title, description, custom ones), state, assignee, open or closed, snooze, sharing with the customer |
intercom_list_ticket_types | List the ticket types with id, name, category (Customer, Back-office, Tracker), archived and their ticket_type_attributes (name, data_type… |
intercom_list_ticket_states | List the ticket states with id, category (submitted, in_progress, waiting_on_customer, resolved), internal_label, external_label and the… |
intercom_list_help_centers | List the Help Centers of the workspace with id, identifier, display_name, url, custom_domain and whether the website is on |
intercom_list_collections | List Help Center collections and sections, most recently updated first, with id, name, description, url, parent_id (set on sections and… |
intercom_get_collection | Read one Help Center collection: name, description, url, icon, order, parent_id, help_center_id and translated_content |
intercom_create_collection | Create a Help Center collection, or a sub-collection with parent_id |
intercom_update_collection | Rename a Help Center collection, change its description or move it under another parent |
intercom_delete_collection | Delete a Help Center collection for good |
intercom_list_articles | List Help Center articles, most recently updated first, with id, title, description, body (HTML), author_id, state (published or draft)… |
intercom_search_articles | Search Help Center articles for a phrase |
intercom_get_article | Read one Help Center article: title, description, body (HTML), author_id, state, parent_ids, url, statistics and translated_content per… |
intercom_create_article | Write a new Help Center article |
intercom_update_article | Change a Help Center article |
intercom_delete_article | Delete a Help Center article for good; setting state draft with intercom_update_article only unpublishes it |
Esempi di prompt
- "Mostrami tutte le conversazioni aperte non assegnate a nessuno, con il cliente e l'argomento di ciascuna."
- "Trova il contatto con l'email [email protected] e riassumi le sue aziende, i tag e le conversazioni recenti."
- "Scrivi una bozza di risposta alla conversazione aperta più vecchia sulla fatturazione e mostramela prima di inviarla."
- "Elenca gli articoli dell'Help Center ancora in bozza e dimmi quali sembrano pronti per la pubblicazione."
FAQ
Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.
Prossimi passi
Questa guida ti è stata utile?
