Saltar a la navegación

Intercom

Busca clientes, conversaciones y artículos de ayuda mediante el servidor MCP de Intercom.

Conecta el servidor MCP alojado de Intercom para que tu recepcionista pueda reconocer a quienes llaman y son clientes, consultar sus conversaciones abiertas y responder preguntas a partir de los artículos de tu Centro de ayuda.

Las conversaciones pueden contener datos privados. Indica a tu recepcionista, en sus instrucciones o en un procedimiento, que comparta detalles de conversaciones solo después de confirmar que quien llama es el contacto, por ejemplo, haciendo coincidir su número de teléfono o correo electrónico.

Configuración

1

Crea una app privada

En Intercom, abre Developer Hub y crea una nueva app para tu espacio de trabajo. Abre la app y ve a Configure → Authentication; después, copia el token de acceso.

Comprueba que los permisos de la app incluyan lectura de usuarios, empresas y conversaciones, además de lectura de artículos. Añade escritura en conversaciones solo si quieres que tu recepcionista deje notas internas.

2

Añade el servidor MCP

En Reception.ai, ve a Integrations, selecciona Add integration y elige MCP Server.

CampoValor
NameIntercom
Server typeStreamable HTTP
Server URLLa URL de la región de tu espacio de trabajo, a continuación
Secret TokenTu token de acceso
Región del espacio de trabajoURL del servidor
EE. UU. (inicias sesión en app.intercom.com)https://mcp.intercom.com/mcp
UE (inicias sesión en app.eu.intercom.com)https://mcp.eu.intercom.com/mcp

Selecciona Enable. Reception.ai envía el token como token bearer y muestra las herramientas de Intercom.

3

Asigna herramientas

Abre la pestaña Tools y asigna estas herramientas al Client (recepcionista):

  • search_contacts y get_contact: buscan a quien llama y sus datos.
  • search_conversations y get_conversation: consultan el estado de las solicitudes de quien llama.
  • search_articles y get_article: responden preguntas de tu Centro de ayuda.

Opcionalmente, asigna add_internal_note para que tu recepcionista pueda añadir un resumen de la llamada a la conversación de quien llama. Las notas solo las ve tu equipo. Deja create_article y update_article sin asignar.

4

Pruébalo

Prueba tu recepcionista llamando desde un número guardado en un contacto de prueba y preguntando por una conversación abierta.

Limitaciones

El servidor MCP de Intercom no admite espacios de trabajo alojados en Australia.

Resolución de problemas

ProblemaQué comprobar
No se muestran herramientasUsa el tipo de servidor Streamable HTTP y la URL de la región de tu espacio de trabajo.
Una herramienta devuelve un error de permisosAñade el permiso que falta a la app en Developer Hub.
La recepcionista no encuentra a quien llamaIntercom compara los números de teléfono tal como están guardados en el contacto. Guarda los números en un único formato.
Has cambiado el tokenEdita la integración y usa Rotate Secret Token (optional). El token guardado no volverá a mostrarse.