Mcp Server per Intercom
Panoramica
Che cos'è il Server MCP per Intercom?
Il ### Server MCP per Intercom è una soluzione innovativa progettata per migliorare le capacità di comunicazione e integrazione per le aziende che utilizzano la piattaforma Intercom. Questo server funge da ponte, consentendo uno scambio di dati senza soluzione di continuità tra varie applicazioni e il sistema Intercom, migliorando così il coinvolgimento e i processi di supporto ai clienti.
Caratteristiche del Server MCP per Intercom
- Sincronizzazione dei Dati in Tempo Reale: Garantisce che tutte le interazioni e i dati dei clienti siano aggiornati in tempo reale su tutte le piattaforme.
- Integrazioni Personalizzabili: Offre flessibilità per integrarsi con varie applicazioni di terze parti, adattate alle esigenze specifiche dell'azienda.
- Interfaccia Intuitiva: Progettata con un'interfaccia intuitiva che semplifica la gestione delle interazioni con i clienti.
- Scalabilità: Facilmente scalabile per soddisfare le crescenti esigenze aziendali e l'aumento delle interazioni con i clienti.
- Sicurezza Robusta: Implementa misure di sicurezza avanzate per proteggere i dati sensibili dei clienti durante la trasmissione.
Come Utilizzare il Server MCP per Intercom
- Installazione: Inizia scaricando il Server MCP per Intercom dal repository ufficiale. Segui le istruzioni di installazione fornite nella documentazione.
- Configurazione: Configura le impostazioni del server per connetterti al tuo account Intercom e a qualsiasi altra applicazione che desideri integrare.
- Test: Esegui test per assicurarti che i dati vengano sincronizzati correttamente e che tutte le integrazioni funzionino come previsto.
- Distribuzione: Una volta completati i test, distribuisci il server nel tuo ambiente di produzione.
- Monitoraggio e Manutenzione: Monitora regolarmente le prestazioni del server e aggiorna le configurazioni secondo necessità per adattarti ai cambiamenti delle esigenze aziendali.
Domande Frequenti
Quali piattaforme supporta il Server MCP per Intercom?
Il Server MCP per Intercom supporta varie piattaforme, inclusi sistemi CRM, piattaforme di e-commerce e altri strumenti di coinvolgimento dei clienti.
C'è un costo associato all'uso del Server MCP per Intercom?
Il Server MCP per Intercom è open-source e gratuito da utilizzare, ma potrebbero sorgere costi aggiuntivi per integrazioni di terze parti o servizi di hosting.
Come posso contribuire al progetto del Server MCP per Intercom?
I contributi sono benvenuti! Puoi contribuire segnalando problemi, suggerendo funzionalità o inviando miglioramenti del codice tramite il repository GitHub.
Che tipo di supporto è disponibile per il Server MCP per Intercom?
Il supporto è disponibile tramite i forum della comunità, la pagina delle issue di GitHub e la documentazione. Gli utenti possono anche cercare aiuto da altri sviluppatori che hanno esperienza con il server.
Posso personalizzare il Server MCP per Intercom?
Sì, il server è progettato per essere personalizzabile. Puoi modificare il codice per adattarlo alle tue esigenze aziendali specifiche e integrare funzionalità aggiuntive secondo necessità.
Dettaglio
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 textexclude
(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 dateendDate
(DD/MM/YYYY) – Optional end datekeywords
(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 dateendDate
(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 dateendDate
(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.
Configurazione Server
{
"mcpServers": {
"mcp-server-for-intercom": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--raoulbia-ai--mcp-server-for-intercom--mcp-server-for-intercom",
"npm run start"
],
"env": {
"INTERCOM_ACCESS_TOKEN": "intercom-access-token"
}
}
}
}