Intercom Mcp Server

Intercom MCP 服务

一个托管式 MCP 服务，让 AI Agent 可以全面使用 Intercom 的核心支持工作流——搜索联系人、管理对话、回复、分配、关闭工单和记录备注。

基于 Model Context Protocol 构建，使用官方 @modelcontextprotocol/sdk。

---

工具

工具	功能
search_contacts	按电子邮件、姓名或电话号码查找联系人
create_or_update_contact	创建新联系人或更新现有联系人
search_conversations	按状态、联系人或受指派人筛选对话
reply_to_conversation	发送客户回复或内部备注
close_conversation	解决并关闭未结对话
assign_conversation	将对话分配给管理员或团队
create_contact_note	在联系人的个人资料中添加内部审计备注

---

快速入门

1. 获取 Intercom API 令牌

1. 前往 app.intercom.com
2. 依次进入 Settings → Developer Hub → Your App → Authentication
3. 复制你的 Access Token

如需测试，可在 app.intercom.com/developers 创建免费的开发者工作区——无需付费方案。

---

2. 克隆并安装

git clone https://github.com/your-username/intercom-mcp-server.git
cd intercom-mcp-server
npm install

---

3. 设置环境变量

cp .env.example .env

打开 .env 并添加你的令牌：

INTERCOM_API_TOKEN=your_token_here

---

4. 连接到 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

Mac： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "intercom": {
      "command": "node",
      "args": ["/absolute/path/to/intercom-mcp-server/index.js"],
      "env": {
        "INTERCOM_API_TOKEN": "your_token_here"
      }
    }
  }
}

重启 Claude Desktop。此时应该可以看到 Intercom 工具。

---

5. 使用 MCP Inspector 测试

npx @modelcontextprotocol/inspector node index.js

这会打开一个浏览器界面，地址为 http://localhost:5173，你可以在其中手动调用每个工具并检查响应。

---

在 Railway 上部署

1. 将此仓库推送到 GitHub（可以是私有仓库）
2. 在 railway.app 创建新项目
3. 连接你的 GitHub 仓库——Railway 会自动检测 Node.js
4. 添加环境变量：INTERCOM_API_TOKEN = your_token
5. 部署——Railway 会提供一个公开 URL

---

环境变量

变量	必填	说明
INTERCOM_API_TOKEN	是	你的 Intercom Bearer 令牌

---

要求

• Node.js 18 或更高版本
• Intercom 账户（免费的开发者工作区可用于测试）

---

许可证

MIT