Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Intercom con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Deja que tu IA trabaje en Intercom: busca y actualiza contactos y empresas, lee, busca y clasifica conversaciones y tickets (responde, añade notas, asigna, pospone, cierra, etiqueta) y gestiona artículos y colecciones del Help Center. Workspaces de EE. UU., la UE o Australia, con el access token de una app del Developer Hub.
Prueba a pedir
Prompts de ejemplo para Intercom
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Intercom, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Intercom + Gemini
Deja que tu IA trabaje en Intercom: busca y actualiza contactos y empresas, lee, busca y clasifica conversaciones y tickets (responde, añade notas, asigna, pospone, cierra, etiqueta) y gestiona artículos y colecciones del Help Center. Workspaces de EE. UU., la UE o Australia, con el access token de una app del Developer Hub.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
INTERCOM_API_URL, INTERCOM_ACCESS_TOKEN
Paso 1 — Obtener credenciales
- Inicia sesión en tu workspace de Intercom como administrador y abre el Developer Hub en
https://app.intercom.com/a/apps/_/developer-hub(o Settings → Integrations → Developer Hub). Los workspaces de la UE y de Australia usan la misma ruta en app.eu.intercom.com o app.au.intercom.com. - Haz clic en New app, ponle un nombre (por ejemplo AnythingMCP), elige el workspace y haz clic en Create app. La app queda instalada en ese workspace al momento: tu propio workspace no necesita OAuth ni revisión de la app.
- Abre la página Configure → Authentication de la app. Muestra el Access token del workspace y los permisos que tiene. Para todas las herramientas, concede lectura y escritura sobre users y companies, conversations, tickets y articles, además de Read admins, Read tags y Write tags. Después de cambiar los permisos, regenera el token y usa el nuevo.
- Pega el token en
INTERCOM_ACCESS_TOKEN, sin la palabra Bearer. Trátalo como una contraseña: da acceso a los datos de clientes de tu workspace. - Pon
INTERCOM_API_URLen la región de tu workspace:https://api.intercom.io(EE. UU., abres app.intercom.com),https://api.eu.intercom.io(UE, app.eu.intercom.com) ohttps://api.au.intercom.io(Australia, app.au.intercom.com). - Instala el conector y ejecuta
intercom_get_me. Devuelve tu id de administrador y el workspace con su región.
Para probarlo: basta con un workspace de desarrollo gratuito de https://app.intercom.com/admins/sign_up/developer. Está en la región de EE. UU., no envía correos ni notificaciones push, admite hasta 20 users y leads y nunca puede convertirse en un workspace de producción.
Configuración de solo lectura: concede solo los permisos de lectura (Read and list users and companies, Read conversations, Read tickets, Read and List articles, Read admins, Read tags) y desactiva las herramientas de escritura. Las tres herramientas de búsqueda solo leen.
Actuar como administrador: las respuestas, notas, asignaciones, posposiciones, cierres y reaperturas se atribuyen a un miembro del equipo, igual que un artículo nuevo. intercom_get_me encuentra tu propio id de administrador, intercom_list_admins los del resto del equipo.
Confirmar antes: una respuesta en una conversación, una respuesta a un ticket de tipo comment, cerrar una conversación con un mensaje y publicar un artículo llegan a los clientes, y los cambios en un artículo publicado se ven al momento. La IA te muestra el texto y espera tu sí. Las notas son internas y los artículos nuevos se crean como borrador. intercom_delete_contact, intercom_delete_article y intercom_delete_collection vienen desactivadas al instalar; intercom_archive_contact es la forma reversible de ocultar un contacto.
Límites: por defecto 10.000 llamadas por minuto por app y 25.000 por workspace, repartidas en ventanas de 10 segundos. Un 429 significa esperar unos segundos.
Errores comunes: 401: el token es incorrecto o se regeneró, la app se desinstaló, o INTERCOM_API_URL no es la región de tu workspace. 403: al token le falta un permiso, o tu plan no incluye la función (los tickets, por ejemplo). Un 404 en un ticket suele significar que se usó el número del Inbox en lugar del id del ticket. 410: el contacto se fusionó con otro, así que busca por correo el contacto que quedó.
El conector no inicia mensajes salientes, no crea conversaciones ni tickets, no elimina conversaciones, no fusiona contactos y no cubre data events, news items, macros, Fin, custom objects, llamadas, exportaciones de datos, webhooks ni la configuración del workspace.
Paso 2 — Instalar el 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
Paso 3 — Añadir el conector en Gemini
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
Intercom.
Herramientas disponibles
| 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 |
Ejemplos de prompts
- "Muéstrame todas las conversaciones abiertas que no tienen a nadie asignado, con el cliente y el tema de cada una."
- "Busca el contacto con el correo [email protected] y resume sus empresas, etiquetas y conversaciones recientes."
- "Redacta una respuesta a la conversación abierta más antigua sobre facturación y enséñamela antes de enviarla."
- "Lista los artículos del Help Center que siguen en borrador y dime cuáles parecen listos para publicar."
FAQ
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Siguientes pasos
¿Te ha sido útil esta guía?
