Skip to main content
Glama
enesjakozh

MCP Server for Intercom

by raoulbia-ai
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote
Apache 2.0
7

Servidor MCP para intercomunicador

Un servidor compatible con MCP que permite a los asistentes de IA acceder y analizar datos de soporte al cliente de Intercom.

Características

  • Busque conversaciones y tickets con filtrado avanzado

  • Filtrar por cliente, estado, rango de fechas y palabras clave

  • Busque por contenido de correo electrónico incluso cuando no exista ningún contacto

  • Filtrado eficiente del lado del servidor a través de la API de búsqueda de Intercom

  • Integración perfecta con asistentes de IA compatibles con MCP

Related MCP server: Claude AI Documentation Assistant

Instalación

Prerrequisitos

  • Node.js 18.0.0 o superior

  • Una cuenta de Intercom con acceso a la API

  • Su token de API de Intercom (disponible en la configuración de su cuenta de Intercom)

Configuración rápida

Uso de NPM

# Install the package globally npm install -g mcp-server-for-intercom # Set your Intercom API token export INTERCOM_ACCESS_TOKEN="your_token_here" # Run the server intercom-mcp

Usando Docker

La configuración predeterminada de Docker está optimizada para la compatibilidad con Glama:

# Start Docker (if not already running) # On Windows: Start Docker Desktop application # On Linux: sudo systemctl start docker # Build the image docker build -t mcp-intercom . # Run the container with your API token and port mappings docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom:latest

Pasos de validación:

# Test the server status curl -v http://localhost:8080/.well-known/glama.json # Test the MCP endpoint curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"mcp.capabilities"}' http://localhost:3000
Versión estándar alternativa

Si prefieres una versión más ligera sin dependencias específicas de Glama:

# Build the standard image docker build -t mcp-intercom-standard -f Dockerfile.standard . # Run the standard container docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom-standard:latest

La versión predeterminada incluye dependencias y configuraciones específicas necesarias para la integración con la plataforma Glama, mientras que la versión estándar es más liviana.

Herramientas MCP disponibles

1. list_conversations

Recupera todas las conversaciones dentro de un rango de fechas con filtrado de contenido.

Parámetros:

  • startDate (DD/MM/AAAA) – Fecha de inicio (obligatoria)

  • endDate (DD/MM/AAAA) – Fecha de finalización (obligatoria)

  • keyword (cadena) – Filtrar para incluir conversaciones con este texto

  • exclude (cadena) – Filtro para excluir conversaciones con este texto

Notas:

  • El rango de fechas no debe exceder los 7 días

  • Utiliza un filtrado eficiente del lado del servidor a través de la API de búsqueda de Intercom

Ejemplo:

{ "startDate": "15/01/2025", "endDate": "21/01/2025", "keyword": "billing" }

2. search_conversations_by_customer

Encuentra conversaciones para un cliente específico.

Parámetros:

  • customerIdentifier (cadena): correo electrónico del cliente o ID de Intercom (obligatorio)

  • startDate (DD/MM/AAAA) – Fecha de inicio opcional

  • endDate (DD/MM/AAAA) – Fecha de finalización opcional

  • keywords (matriz): palabras clave opcionales para filtrar por contenido

Notas:

  • Puede encontrar conversaciones por contenido de correo electrónico incluso si no existe ningún contacto

  • Resuelve correos electrónicos a identificaciones de contactos para una búsqueda eficiente

Ejemplo:

{ "customerIdentifier": "customer@example.com", "startDate": "15/01/2025", "endDate": "21/01/2025", "keywords": ["billing", "refund"] }

3. search_tickets_by_status

Recupera tickets por su estado.

Parámetros:

  • status (cadena) – «abierto», «pendiente» o «resuelto» (obligatorio)

  • startDate (DD/MM/AAAA) – Fecha de inicio opcional

  • endDate (DD/MM/AAAA) – Fecha de finalización opcional

Ejemplo:

{ "status": "open", "startDate": "15/01/2025", "endDate": "21/01/2025" }

4. search_tickets_by_customer

Encuentra tickets asociados a un cliente específico.

Parámetros:

  • customerIdentifier (cadena): correo electrónico del cliente o ID de Intercom (obligatorio)

  • startDate (DD/MM/AAAA) – Fecha de inicio opcional

  • endDate (DD/MM/AAAA) – Fecha de finalización opcional

Ejemplo:

{ "customerIdentifier": "customer@example.com", "startDate": "15/01/2025", "endDate": "21/01/2025" }

Configuración con Claude Desktop

Añade a tu claude_desktop_config.json :

{ "mcpServers": { "intercom-mcp": { "command": "intercom-mcp", "args": [], "env": { "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token" } } } }

Notas de implementación

Para obtener información técnica detallada sobre la integración de este servidor con la API de Intercom, consulte src/services/INTERCOM_API_NOTES.md . Este documento explica la asignación de parámetros, el uso de los endpoints de Intercom y los detalles de implementación para desarrolladores.

Desarrollo

# Clone and install dependencies git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git cd mcp-server-for-intercom npm install # Build and run for development npm run build npm run dev # Run tests npm test

Descargo de responsabilidad

Este proyecto es una integración independiente y no está afiliado, conectado oficialmente ni respaldado por Intercom Inc. "Intercom" es una marca registrada de Intercom Inc.

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0: consulte el archivo de LICENCIA para obtener más detalles.

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/raoulbia-ai/mcp-server-for-intercom'

If you have feedback or need assistance with the MCP directory API, please join our Discord server