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: jitbit-helpdesk-mcp

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.