Serveur Mcp pour Intercom
Aperçu
Qu'est-ce que le serveur MCP pour Intercom ?
Le ### serveur MCP pour Intercom est une solution innovante conçue pour améliorer les capacités de communication et d'intégration pour les entreprises utilisant la plateforme Intercom. Ce serveur agit comme un pont, permettant un échange de données fluide entre diverses applications et le système Intercom, améliorant ainsi l'engagement client et les processus de support.
Fonctionnalités du serveur MCP pour Intercom
- Synchronisation des données en temps réel : Assure que toutes les interactions et données clients sont mises à jour en temps réel sur toutes les plateformes.
- Intégrations personnalisables : Offre la flexibilité d'intégrer diverses applications tierces, adaptées aux besoins spécifiques de l'entreprise.
- Interface conviviale : Conçu avec une interface intuitive qui simplifie la gestion des interactions clients.
- Scalabilité : Facilement évolutif pour s'adapter aux besoins croissants de l'entreprise et à l'augmentation des interactions clients.
- Sécurité robuste : Met en œuvre des mesures de sécurité avancées pour protéger les données sensibles des clients pendant la transmission.
Comment utiliser le serveur MCP pour Intercom
- Installation : Commencez par télécharger le serveur MCP pour Intercom depuis le dépôt officiel. Suivez les instructions d'installation fournies dans la documentation.
- Configuration : Configurez les paramètres du serveur pour vous connecter à votre compte Intercom et à toute autre application que vous souhaitez intégrer.
- Test : Effectuez des tests pour vous assurer que les données sont synchronisées correctement et que toutes les intégrations fonctionnent comme prévu.
- Déploiement : Une fois les tests terminés, déployez le serveur dans votre environnement de production.
- Surveillance et maintenance : Surveillez régulièrement les performances du serveur et mettez à jour les configurations si nécessaire pour s'adapter aux exigences commerciales changeantes.
Questions Fréquemment Posées
Quelles plateformes le serveur MCP pour Intercom prend-il en charge ?
Le serveur MCP pour Intercom prend en charge diverses plateformes, y compris les systèmes CRM, les plateformes de commerce électronique et d'autres outils d'engagement client.
Y a-t-il un coût associé à l'utilisation du serveur MCP pour Intercom ?
Le serveur MCP pour Intercom est open-source et gratuit à utiliser, mais des coûts supplémentaires peuvent survenir en raison d'intégrations tierces ou de services d'hébergement.
Comment puis-je contribuer au projet du serveur MCP pour Intercom ?
Les contributions sont les bienvenues ! Vous pouvez contribuer en signalant des problèmes, en suggérant des fonctionnalités ou en soumettant des améliorations de code via le dépôt GitHub.
Quel type de support est disponible pour le serveur MCP pour Intercom ?
Le support est disponible via les forums communautaires, la page des problèmes GitHub et la documentation. Les utilisateurs peuvent également demander de l'aide à d'autres développeurs ayant de l'expérience avec le serveur.
Puis-je personnaliser le serveur MCP pour Intercom ?
Oui, le serveur est conçu pour être personnalisable. Vous pouvez modifier le code pour l'adapter à vos besoins commerciaux spécifiques et intégrer des fonctionnalités supplémentaires si nécessaire.
Détail
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.
Configuration du serveur
{
"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"
}
}
}
}