Mcp сервер для интеркома
Обзор
Что такое MCP Server для Intercom?
MCP Server для Intercom — это инновационное решение, разработанное для улучшения коммуникации и интеграционных возможностей для бизнеса, использующего платформу Intercom. Этот сервер выступает в роли моста, позволяя бесшовный обмен данными между различными приложениями и системой Intercom, тем самым улучшая взаимодействие с клиентами и процессы поддержки.
Особенности MCP Server для Intercom
- Синхронизация данных в реальном времени: Обеспечивает обновление всех взаимодействий с клиентами и данных в реальном времени на всех платформах.
- Настраиваемые интеграции: Предлагает гибкость для интеграции с различными сторонними приложениями, адаптированными под конкретные бизнес-потребности.
- Удобный интерфейс: Разработан с интуитивно понятным интерфейсом, который упрощает управление взаимодействиями с клиентами.
- Масштабируемость: Легко масштабируется для удовлетворения растущих бизнес-потребностей и увеличения взаимодействий с клиентами.
- Надежная безопасность: Реализует передовые меры безопасности для защиты конфиденциальных данных клиентов во время передачи.
Как использовать MCP Server для Intercom
- Установка: Начните с загрузки MCP Server для Intercom из официального репозитория. Следуйте инструкциям по установке, приведенным в документации.
- Конфигурация: Настройте параметры сервера для подключения к вашей учетной записи Intercom и любым другим приложениям, которые вы хотите интегрировать.
- Тестирование: Проведите тесты, чтобы убедиться, что данные синхронизируются правильно и все интеграции работают как ожидалось.
- Развертывание: После завершения тестирования разверните сервер в вашей производственной среде.
- Мониторинг и обслуживание: Регулярно отслеживайте производительность сервера и обновляйте конфигурации по мере необходимости, чтобы адаптироваться к изменяющимся бизнес-требованиям.
Часто задаваемые вопросы
Какие платформы поддерживает MCP Server для Intercom?
MCP Server для Intercom поддерживает различные платформы, включая CRM-системы, платформы электронной коммерции и другие инструменты взаимодействия с клиентами.
Есть ли стоимость, связанная с использованием MCP Server для Intercom?
MCP Server для Intercom является открытым исходным кодом и бесплатен в использовании, но могут возникнуть дополнительные расходы на сторонние интеграции или хостинг.
Как я могу внести свой вклад в проект MCP Server для Intercom?
Вклад приветствуется! Вы можете внести свой вклад, сообщая о проблемах, предлагая функции или отправляя улучшения кода через репозиторий GitHub.
Какой вид поддержки доступен для MCP Server для Intercom?
Поддержка доступна через форумы сообщества, страницу проблем GitHub и документацию. Пользователи также могут обратиться за помощью к другим разработчикам, имеющим опыт работы с сервером.
Могу ли я настроить MCP Server для Intercom?
Да, сервер разработан с возможностью настройки. Вы можете изменить код, чтобы он соответствовал вашим конкретным бизнес-потребностям и интегрировать дополнительные функции по мере необходимости.
Деталь
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.
Конфигурация сервера
{
"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"
}
}
}
}