MCP Intercom Server

Servidor MCP Intercom

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

Características

• Consulta conversaciones de Intercom con opciones de filtrado:
  • Rango de fechas (fechas de inicio y fin)
  • ID de cliente
  • Estado de la conversación
• Acceso seguro usando tu clave de API de Intercom
• Datos enriquecidos de conversaciones que incluyen:
  • Detalles básicos de la conversación
  • Información de contacto
  • Estadísticas (respuestas, reaperturas)
  • Información de estado y prioridad

Instalación

1. Clona el repositorio:

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

2. Instala las dependencias:

npm install

3. Configura tu entorno:

cp .env.example .env

4. Agrega tu clave de API de Intercom a .env:

INTERCOM_API_KEY=your_api_key_here

5. Compila el servidor:

npm run build

Uso

Ejecutar el servidor

Inicia el servidor:

npm start

Uso con Claude para Desktop

1. Agrega el servidor a tu configuración de Claude para 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"
      }
    }
  }
}

2. Reinicia Claude para Desktop

Herramientas disponibles

search-conversations

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, "email", "chat").
• state (opcional): Estado de la conversación para filtrar (por ejemplo, "abierta", "cerrada").
• open (opcional): Booleano para filtrar por estado de apertura.
• read (opcional): Booleano para filtrar por estado de lectura.

Ejemplos de consultas:

• "Buscar todas las conversaciones creadas después del 1 de enero de 2024"
• "Encontrar conversaciones actualizadas antes de la semana pasada"
• "Listar todas las conversaciones de email abiertas"
• "Obtener todas las conversaciones no leídas"

Seguridad

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

Desarrollo

1. Inicia el modo de desarrollo con recompilación automática:

npm run dev

2. Ejecuta el linting:

npm run lint

Contribuciones

1. Haz un fork del repositorio
2. Crea una nueva rama para tu funcionalidad
3. Realiza tus cambios
4. Envía una solicitud de pull

Licencia

MIT