Skip to main content
Glama
Sign In
enesjakozh

MCP Server for Intercom

by raoulbia-ai
Verified
GitHub
TypeScript
Apache 2.0
4
  • Linux
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Enables access and analysis of customer support data from Intercom, with capabilities for searching conversations and tickets using advanced filters, filtering by customer, status, date range, and keywords, and searching email content even without existing contacts.

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

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.

You must be authenticated.

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

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor compatible con MCP que permite a los asistentes de IA como Claude Desktop acceder y analizar los tickets de soporte de Intercom con un historial de conversaciones completo.

  1. Features
    1. Installation
      1. Prerequisites
      2. Quick Setup
    2. Available MCP Tools
      1. 1. list_conversations
      2. 2. search_conversations_by_customer
      3. 3. search_tickets_by_status
      4. 4. search_tickets_by_customer
    3. Configuration with Claude Desktop
      1. Implementation Notes
        1. Development
          1. Disclaimer
            1. License
              ID: m4uflija10