MCP 服务器

MCP Server for Intercom

一个符合 MCP 协议的服务器，使像 Claude Desktop 这样的 AI 助手能够访问和分析包含完整对话历史的 Intercom 支持工单。

远程shell执行

数据库交互

AI集成系统

数据与应用分析

访问服务器

README

用于 Intercom 的 MCP 服务器

一个符合 MCP 规范的服务器，用于从 Intercom 检索客户支持工单。此工具使 AI 助手（如 Claude Desktop 和 Cline）能够访问和分析您的 Intercom 支持工单。

功能

检索所有支持工单（包括打开和关闭的），并包含完整的对话历史记录
按创建日期筛选工单
支持分页，以处理大量工单
与符合 MCP 规范的 AI 助手无缝集成

免责声明

本项目是一个独立的集成，与 Intercom Inc. 无关联，未获得其正式连接或认可。“Intercom”是 Intercom Inc. 的注册商标。

遵守 Intercom 开发者条款

本项目旨在通过以下方式遵守 Intercom 的开发者服务条款：

保护 API 令牌：确保 Intercom API 令牌的保密性和安全性
负责任的数据处理：负责任地访问和存储用户数据
有限范围：仅实现检索工单数据的必要功能
透明度：清楚地记录数据使用情况和应用程序功能

此集成的用户应查看 Intercom 的开发者条款，以确保他们的实施符合所有要求。

安装

前提条件

Node.js 18.0.0 或更高版本
具有 API 访问权限的 Intercom 帐户

快速开始

全局安装软件包：
```
npm install -g mcp-server-for-intercom
```

设置您的 Intercom API 令牌：

# 对于 Linux/Mac
export INTERCOM_ACCESS_TOKEN="your_token_here"

# 对于 Windows 命令提示符
set INTERCOM_ACCESS_TOKEN=your_token_here

# 对于 PowerShell
$env:INTERCOM_ACCESS_TOKEN = "your_token_here"

运行服务器：
```
intercom-mcp
```

开发设置

克隆存储库：

git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom

安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```
将您的 Intercom API 令牌设置为环境变量（参见上文）
在开发模式下运行服务器：
```
npm run dev
```

测试

运行测试：

npm test

在监视模式下运行测试：

npm run test:watch

使用 MCP Inspector

MCP Inspector 是一个有用的工具，用于调试和测试您的 MCP 服务器实现。它提供了一个 Web 界面，用于与您的服务器交互并可视化请求和响应。

安装

MCP Inspector 可以作为 npm 包使用：

npm install -g @modelcontextprotocol/inspector

运行 Inspector

要检查您的 MCP 服务器，请使用以下命令：

npx @modelcontextprotocol/inspector node build/index.js

这将：

启动您的 MCP 服务器
启动一个 Web 界面（通常在 http://localhost:3000）
允许您发送请求并查看响应

重要提示

将 Inspector 与此服务器一起使用时，必须如上所示，在命令前加上 node
确保您的环境变量（如 INTERCOM_ACCESS_TOKEN）已正确设置
Web 界面允许您：
- 查看可用的工具
- 发送测试请求
- 调试响应格式
- 监控请求/响应流程

在以下情况下，Inspector 特别有用：

实现新工具
调试参数处理问题
测试日期格式验证
验证错误消息

API 参考

`list_tickets`

检索特定日期范围内所有支持工单及其对话历史记录。

请求参数：

startDate（DD/MM/YYYY 格式）– 检索工单的开始日期（必需）
endDate（DD/MM/YYYY 格式）– 检索工单的结束日期（必需）
keyword（字符串）– 可选过滤器，仅包含包含此文本的工单
exclude（字符串）– 可选过滤器，排除包含此文本的工单

重要提示：

日期范围不得超过 7 天
startDate 和 endDate 都是必需的
日期必须使用 DD/MM/YYYY 格式（例如，“15/01/2025”）

示例请求：

{
  "startDate": "15/01/2025",
  "endDate": "21/01/2025",
  "keyword": "billing"
}

响应格式：

{
  "result": [
    {
      "ticket_id": "12345",
      "subject": "Billing Issue",
      "status": "resolved",
      "created_at": "2024-03-06T10:15:00Z",
      "conversation": [
        {
          "from": "customer",
          "text": "Hey, I was double charged!",
          "timestamp": "2024-03-06T10:15:00Z"
        },
        {
          "from": "support_agent",
          "text": "We've refunded the duplicate charge.",
          "timestamp": "2024-03-06T10:45:00Z"
        }
      ]
    }
  ]
}

与 Claude Desktop 一起使用

要将用于 Intercom 的 MCP 服务器与 Claude Desktop 集成：

获取 API 令牌：确保您拥有 Intercom API 令牌。您可以从您的 Intercom 帐户设置中获取此令牌。

配置 Claude Desktop：将以下配置添加到您的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "intercom-mcp": {
      "command": "intercom-mcp",
      "args": [],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token"
      }
    }
  }
}

将 "your_intercom_api_token" 替换为您的实际 Intercom API 令牌。

使用本地开发版本

如果您已克隆存储库并想运行用于 Intercom 的 MCP 服务器的本地版本：

克隆存储库：

git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom

安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```

配置 Claude Desktop：将以下配置添加到您的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "intercom-mcp-local": {
      "command": "npm",
      "args": ["run", "dev"],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token",
        "NODE_ENV": "development"
      },
      "cwd": "/path/to/your/mcp-server-for-intercom"
    }
  }
}

将 "your_intercom_api_token" 替换为您的实际 Intercom API 令牌，并将 "/path/to/your/mcp-server-for-intercom" 替换为您克隆的存储库的路径。