Mcp-Server für Intercom
Übersicht
Was ist der MCP-Server für Intercom?
Der ### MCP-Server für Intercom ist eine innovative Lösung, die entwickelt wurde, um die Kommunikations- und Integrationsmöglichkeiten für Unternehmen, die die Intercom-Plattform nutzen, zu verbessern. Dieser Server fungiert als Brücke und ermöglicht einen nahtlosen Datenaustausch zwischen verschiedenen Anwendungen und dem Intercom-System, wodurch das Kundenengagement und die Supportprozesse verbessert werden.
Funktionen des MCP-Servers für Intercom
- Echtzeit-Daten-Synchronisation: Stellt sicher, dass alle Kundeninteraktionen und Daten in Echtzeit über die Plattformen hinweg aktualisiert werden.
- Anpassbare Integrationen: Bietet Flexibilität, um sich mit verschiedenen Drittanbieteranwendungen zu integrieren, die auf spezifische Geschäftsbedürfnisse zugeschnitten sind.
- Benutzerfreundliche Oberfläche: Entworfen mit einer intuitiven Benutzeroberfläche, die das Management von Kundeninteraktionen vereinfacht.
- Skalierbarkeit: Leicht skalierbar, um wachsende Geschäftsbedürfnisse und zunehmende Kundeninteraktionen zu berücksichtigen.
- Robuste Sicherheit: Implementiert fortschrittliche Sicherheitsmaßnahmen, um sensible Kundendaten während der Übertragung zu schützen.
So verwenden Sie den MCP-Server für Intercom
- Installation: Beginnen Sie mit dem Herunterladen des MCP-Servers für Intercom aus dem offiziellen Repository. Befolgen Sie die Installationsanweisungen, die in der Dokumentation bereitgestellt werden.
- Konfiguration: Konfigurieren Sie die Servereinstellungen, um eine Verbindung zu Ihrem Intercom-Konto und anderen Anwendungen, die Sie integrieren möchten, herzustellen.
- Testen: Führen Sie Tests durch, um sicherzustellen, dass die Daten korrekt synchronisiert werden und dass alle Integrationen wie erwartet funktionieren.
- Bereitstellung: Sobald die Tests abgeschlossen sind, stellen Sie den Server in Ihrer Produktionsumgebung bereit.
- Überwachung und Wartung: Überwachen Sie regelmäßig die Serverleistung und aktualisieren Sie die Konfigurationen nach Bedarf, um sich an sich ändernde Geschäftsanforderungen anzupassen.
Häufig gestellte Fragen
Welche Plattformen unterstützt der MCP-Server für Intercom?
Der MCP-Server für Intercom unterstützt verschiedene Plattformen, einschließlich CRM-Systemen, E-Commerce-Plattformen und anderen Kundenengagement-Tools.
Gibt es Kosten für die Nutzung des MCP-Servers für Intercom?
Der MCP-Server für Intercom ist Open Source und kostenlos zu nutzen, jedoch können zusätzliche Kosten durch Drittanbieterintegrationen oder Hosting-Dienste entstehen.
Wie kann ich zum Projekt MCP-Server für Intercom beitragen?
Beiträge sind willkommen! Sie können beitragen, indem Sie Probleme melden, Funktionen vorschlagen oder Codeverbesserungen über das GitHub-Repository einreichen.
Welche Art von Unterstützung ist für den MCP-Server für Intercom verfügbar?
Unterstützung ist über die Community-Foren, die GitHub-Issues-Seite und die Dokumentation verfügbar. Benutzer können auch Hilfe von anderen Entwicklern suchen, die Erfahrung mit dem Server haben.
Kann ich den MCP-Server für Intercom anpassen?
Ja, der Server ist so konzipiert, dass er anpassbar ist. Sie können den Code ändern, um ihn an Ihre spezifischen Geschäftsbedürfnisse anzupassen und zusätzliche Funktionen nach Bedarf zu integrieren.
Detail
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.
Serverkonfiguration
{
"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"
}
}
}
}