MCP Intercom Server

MCP内部通信服务器

一种模型上下文协议（MCP）服务器，提供对内部通信对话和聊天的访问。此服务器允许LLM使用各种过滤选项查询和分析您的对讲机对话。

特性

• 使用过滤选项查询内部通信对话：

- 日期范围（开始和结束日期） - 客户ID - 会话状态

• 使用您的对讲机API密钥进行安全访问
• 丰富的对话数据包括：

- 基本对话细节 - 联系方式 - 统计数据（回复、重新开放） - 状态和优先级信息

安装

1. 克隆存储库：

git clone https://github.com/fabian1710/mcp-intercom.git
cd mcp-intercom

1. 安装依赖项：

npm install

1. 设置您的环境：

cp .env.example .env

1. 将您的内部通信API密钥添加到 .env:

INTERCOM_API_KEY=your_api_key_here

1. 构建服务器：

npm run build

用法

运行服务器

启动服务器：

npm start

使用Claude for Desktop

1. 将服务器添加到Claude进行桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS或 %AppData%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "intercom": {
      "command": "node",
      "args": ["/path/to/mcp-intercom/dist/index.js"],
      "env": {
        "INTERCOM_API_KEY": "your_api_key_here"
      }
    }
  }
}

1. 重新启动桌面版的Claude

可用工具

搜索对话

使用可选过滤器搜索对讲机对话。

参数：

• createdAt （可选）：对象 operator （例如，“>”、“\”、“\<”、“=”）以及 value （UNIX时间戳）用于按更新日期进行筛选。
• sourceType （可选）：对话的来源类型（例如，“电子邮件”、“聊天”）。
• state （可选）：要过滤的对话状态（例如，“打开”、“关闭”）。
• open （可选）：按打开状态筛选的布尔值。
• read （可选）：按读取状态筛选的布尔值。

示例查询：

• “搜索2024年1月1日之后创建的所有对话”
• “查找上周之前更新的对话”
• “列出所有打开的电子邮件对话”
• “获取所有未读对话”

安全

• 服务器需要内部通信API密钥才能运行
• API密钥应安全地存储在环境变量中
• 服务器仅提供对话的读取权限
• 所有API请求都是通过正确的身份验证发出的

发展

1. 使用自动重新编译启动开发模式：

npm run dev

1. 运行linting：

npm run lint

贡献

1. 分叉存储库
2. 为您的功能创建新分支
3. 进行更改
4. 提交拉取请求

许可证

麻省理工学院