Servidor de intercomunicación MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a conversaciones y chats de Intercom. Este servidor permite a los LLM consultar y analizar sus conversaciones de Intercom con diversas opciones de filtrado.

Características

Consultar conversaciones de Intercom con opciones de filtrado:
- Rango de fechas (fechas de inicio y finalización)
- ID de cliente
- Estado de la conversación
Acceso seguro usando su clave API de Intercom
Datos de conversación enriquecidos que incluyen:
- Detalles básicos de la conversación
- Información del contacto
- Estadísticas (respuestas, reaperturas)
- Información sobre el estado y las prioridades

Instalación

Clonar el repositorio:

git clone https://github.com/fabian1710/mcp-intercom.git
cd mcp-intercom

Instalar dependencias:

npm install

Configura tu entorno:

cp .env.example .env

Agregue su clave API de Intercom a .env :

INTERCOM_API_KEY=your_api_key_here

Construir el servidor:

npm run build

Uso

Ejecución del servidor

Iniciar el servidor:

npm start

Uso con Claude para escritorio

Agregue el servidor a su configuración de Claude for Desktop ( ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %AppData%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "intercom": {
      "command": "node",
      "args": ["/path/to/mcp-intercom/dist/index.js"],
      "env": {
        "INTERCOM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Reiniciar Claude para escritorio

Herramientas disponibles

conversaciones de búsqueda

Busca conversaciones de Intercom con filtros opcionales.

Parámetros:

createdAt (opcional): Objeto con operator (por ejemplo, ">", "<", "=") y value (marca de tiempo UNIX) para filtrar por fecha de creación.
updatedAt (opcional): Objeto con operator (por ejemplo, ">", "<", "=") y value (marca de tiempo UNIX) para filtrar por fecha de actualización.
sourceType (opcional): Tipo de fuente de la conversación (por ejemplo, "correo electrónico", "chat").
state (opcional): Estado de la conversación por el que filtrar (por ejemplo, "abierto", "cerrado").
open (opcional): booleano para filtrar por estado abierto.
read (opcional): booleano para filtrar por estado de lectura.

Consultas de ejemplo:

Buscar todas las conversaciones creadas después del 1 de enero de 2024
"Encuentra conversaciones actualizadas antes de la semana pasada"
"Enumerar todas las conversaciones de correo electrónico abiertas"
Obtener todas las conversaciones no leídas

Seguridad

El servidor requiere una clave API de Intercom para funcionar
La clave API debe almacenarse de forma segura en variables de entorno
El servidor sólo proporciona acceso de lectura a las conversaciones.
Todas las solicitudes de API se realizan con la autenticación adecuada.

Desarrollo

Iniciar el modo de desarrollo con recompilación automática:

npm run dev

Ejecutar linting:

npm run lint

Contribuyendo

Bifurcar el repositorio
Crea una nueva rama para tu función
Realiza tus cambios
Enviar una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

MCP Intercom Server

Integrations