Servidor Mcp Para Intercom

¿Qué es el Servidor MCP para Intercom?

El ### Servidor MCP para Intercom es una solución innovadora diseñada para mejorar las capacidades de comunicación e integración para empresas que utilizan la plataforma Intercom. Este servidor actúa como un puente, permitiendo el intercambio de datos sin problemas entre varias aplicaciones y el sistema Intercom, mejorando así el compromiso y los procesos de soporte al cliente.

Características del Servidor MCP para Intercom

• Sincronización de Datos en Tiempo Real: Asegura que todas las interacciones y datos de los clientes se actualicen en tiempo real en todas las plataformas.
• Integraciones Personalizables: Ofrece flexibilidad para integrarse con varias aplicaciones de terceros, adaptadas a necesidades comerciales específicas.
• Interfaz Amigable: Diseñada con una interfaz intuitiva que simplifica la gestión de las interacciones con los clientes.
• Escalabilidad: Fácilmente escalable para acomodar las crecientes necesidades comerciales y el aumento de interacciones con los clientes.
• Seguridad Robusta: Implementa medidas de seguridad avanzadas para proteger los datos sensibles de los clientes durante la transmisión.

Cómo Usar el Servidor MCP para Intercom

1. Instalación: Comienza descargando el Servidor MCP para Intercom desde el repositorio oficial. Sigue las instrucciones de instalación proporcionadas en la documentación.
2. Configuración: Configura los ajustes del servidor para conectarte con tu cuenta de Intercom y cualquier otra aplicación que desees integrar.
3. Pruebas: Realiza pruebas para asegurarte de que los datos se estén sincronizando correctamente y que todas las integraciones estén funcionando como se espera.
4. Despliegue: Una vez completadas las pruebas, despliega el servidor en tu entorno de producción.
5. Monitoreo y Mantenimiento: Monitorea regularmente el rendimiento del servidor y actualiza las configuraciones según sea necesario para adaptarte a los cambios en los requisitos comerciales.

Preguntas Frecuentes

¿Qué plataformas soporta el Servidor MCP para Intercom?

El Servidor MCP para Intercom soporta varias plataformas, incluyendo sistemas CRM, plataformas de comercio electrónico y otras herramientas de compromiso con el cliente.

¿Hay algún costo asociado con el uso del Servidor MCP para Intercom?

El Servidor MCP para Intercom es de código abierto y gratuito para usar, pero pueden surgir costos adicionales por integraciones de terceros o servicios de alojamiento.

¿Cómo puedo contribuir al proyecto del Servidor MCP para Intercom?

¡Las contribuciones son bienvenidas! Puedes contribuir reportando problemas, sugiriendo características o enviando mejoras de código a través del repositorio de GitHub.

¿Qué tipo de soporte está disponible para el Servidor MCP para Intercom?

El soporte está disponible a través de los foros de la comunidad, la página de problemas de GitHub y la documentación. Los usuarios también pueden buscar ayuda de otros desarrolladores que tengan experiencia con el servidor.

¿Puedo personalizar el Servidor MCP para Intercom?

Sí, el servidor está diseñado para ser personalizable. Puedes modificar el código para adaptarlo a tus necesidades comerciales específicas e integrar funcionalidades adicionales según sea necesario.

MCP Server for Intercom

<a href="https://glama.ai/mcp/servers/@raoulbia-ai/mcp-server-for-intercom"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@raoulbia-ai/mcp-server-for-intercom/badge" /> </a>

An MCP-compliant server that enables AI assistants to access and analyze customer support data from Intercom.

Features

• Search conversations and tickets with advanced filtering
• Filter by customer, status, date range, and keywords
• Search by email content even when no contact exists
• Efficient server-side filtering via Intercom's search API
• Seamless integration with MCP-compliant AI assistants

Installation

Prerequisites

• Node.js 18.0.0 or higher
• An Intercom account with API access
• Your Intercom API token (available in your Intercom account settings)

Quick Setup

Using 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

Using Docker

The default Docker configuration is optimized for Glama compatibility:

### 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

Validation Steps:

### 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

Alternative Standard Version

If you prefer a lighter version without Glama-specific dependencies:

### 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

The default version includes specific dependencies and configurations required for integration with the Glama platform, while the standard version is more lightweight.

Available MCP Tools

1. list_conversations

Retrieves all conversations within a date range with content filtering.

Parameters:

• startDate (DD/MM/YYYY) – Start date (required)
• endDate (DD/MM/YYYY) – End date (required)
• keyword (string) – Filter to include conversations with this text
• exclude (string) – Filter to exclude conversations with this text

Notes:

• Date range must not exceed 7 days
• Uses efficient server-side filtering via Intercom's search API

Example:

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

2. search_conversations_by_customer

Finds conversations for a specific customer.

Parameters:

• customerIdentifier (string) – Customer email or Intercom ID (required)
• startDate (DD/MM/YYYY) – Optional start date
• endDate (DD/MM/YYYY) – Optional end date
• keywords (array) – Optional keywords to filter by content

Notes:

• Can find conversations by email content even if no contact exists
• Resolves emails to contact IDs for efficient searching

Example:

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

3. search_tickets_by_status

Retrieves tickets by their status.

Parameters:

• status (string) – "open", "pending", or "resolved" (required)
• startDate (DD/MM/YYYY) – Optional start date
• endDate (DD/MM/YYYY) – Optional end date

Example:

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

4. search_tickets_by_customer

Finds tickets associated with a specific customer.

Parameters:

• customerIdentifier (string) – Customer email or Intercom ID (required)
• startDate (DD/MM/YYYY) – Optional start date
• endDate (DD/MM/YYYY) – Optional end date

Example:

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

Configuration with Claude Desktop

Add to your claude_desktop_config.json:

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

Implementation Notes

For detailed technical information about how this server integrates with Intercom's API, see src/services/INTERCOM_API_NOTES.md. This document explains our parameter mapping, Intercom endpoint usage, and implementation details for developers.

Development

### 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

Disclaimer

This project is an independent integration and is not affiliated with, officially connected to, or endorsed by Intercom Inc. "Intercom" is a registered trademark of Intercom Inc.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.