内部通信-MCP服务器

Name: 内部通信-MCP服务器
Author: intercom

作者：intercom4 星标更新：2025-09-22

安装使用来源：spider==github.com

项目介绍

模型上下文协议（MCP）

了解如何使用模型上下文协议（MCP），让AI代理能够安全地访问并与您的Intercom数据进行交互，以提供帮助。

区域可用性目前，Intercom MCP服务器仅支持在美国托管的工作空间中使用。

什么是模型上下文协议？

MCP是一种协议，使AI工具和应用程序能够通过一种安全且标准化的方式连接到Intercom的数据和服务。它提供了一种结构化的方法，使AI模型能够：

查找和检索Intercom数据（对话、联系人等）
访问Intercom提供的特定工具和功能
在与AI助手交互时维护关于您的Intercom工作区的上下文信息

MCP是如何工作的？

Intercom托管了一个遵循认证远程MCP规范的远程MCP服务器（文档）。此服务器处理来自AI工具的请求，并通过一个安全接口提供对Intercom数据的访问。

连接URL：

可流式传输HTTP（推荐）：https://mcp.intercom.com/mcp
旧版SSE：https://mcp.intercom.com/sse（已弃用，为了向后兼容而保留）

当AI工具或应用程序需要访问Intercom数据时：

工具连接到Intercom的MCP服务器
验证用户权限
工具可以访问相关的Intercom数据和功能
连接保持活动状态，以便接收所需的更新

使用MCP的好处

安全访问：所有数据访问都是经过身份验证和授权的
标准化接口：不同AI工具之间一致的交互模式
上下文理解：AI助手保持对您的Intercom环境的认识
提高开发效率：通过内部AI工具从Intercom检索和解释客户数据，从而提高工作效率

可用工具

Intercom MCP服务器提供了6个工具用于与Intercom API交互：

通用工具

搜索

使用查询DSL方法查找对话和联系人的通用搜索工具。

关键特性：

必须指定 object_type:conversations 或 object_type:contacts 来指示调用哪个API
支持基于字段的复杂查询操作（eq, neq, gt, lt, contains等）
返回带有类型前缀ID的摘要结果（conversation_* 或 contact_*）
内置分页支持，使用 starting_after 参数
使用 q: 参数的全文搜索能力

示例查询：

object_type:conversations state:open source_type:email
object_type:contacts email_domain:"example.com"
object_type:conversations source_body:contains:"退款" limit:20

获取

检索特定资源的完整详细信息。

关键特性：

使用从搜索结果返回的ID（前缀为 conversation_ 或 contact_）
返回完整的资源详情，包括元数据、对话部分和自定义属性
包含直接链接到Intercom应用的导航链接

直接API工具

搜索对话

根据特定ID搜索对话，具有高级过滤选项，包括来源类型、作者详情、状态和时间统计。

获取对话

通过ID检索单个对话及其完整细节，包括所有对话部分和元数据。

搜索联系人

根据ID、姓名、电子邮件、电话、自定义属性或电子邮件域搜索联系人，具有灵活的匹配选项。

获取联系人

获取完整的联系人信息，包括自定义属性、位置数据和活动时间戳。

设置指南

认证方法

MCP服务器支持两种认证方式：

OAuth流程（推荐）：自动浏览器认证
Bearer令牌：直接API令牌认证

配置示例

配置指南以下示例是通用模板。始终参考您特定LLM提供商的官方文档，以获取最新的配置说明，因为设置细节可能因版本和提供商而异。

对于OAuth认证（推荐）：

{
  "mcpServers": {
    "intercom": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.intercom.com/mcp"
      ]
    }
  }
}

对于Bearer令牌认证：

{
  "mcpServers": {
    "intercom": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.intercom.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_INTERCOM_API_TOKEN"
      }
    }
  }
}

LLM提供商设置指南

每个AI提供商都有针对MCP服务器的具体设置说明。请查阅您提供商的官方文档：

Claude Desktop：MCP设置文档
Claude Code：MCP设置文档
OpenAI：MCP集成指南
Claude.ai：前往设置 > 集成 > + 添加集成，然后使用 https://mcp.intercom.com/mcp
Cursor：MCP配置指南
Windsurf：MCP设置说明
VS Code：MCP集成文档

必要的权限范围

Intercom MCP服务器需要以下权限来访问您的工作区数据。在使用Bearer令牌认证时，请确保您的访问令牌包含这些范围。了解更多关于OAuth权限。

读取和列出用户和公司：需要访问Intercom用户和公司数据
读取对话：需要访问Intercom对话数据

MCP Inspector用于服务器探索

测试连接使用：

npx @modelcontextprotocol/inspector

然后连接到：

传输类型：可流式传输HTTP
URL：https://mcp.intercom.com/mcp（或 /sse 用于旧版）

调试和故障排除MCP-Remote

认证问题

# 终止现有连接
pkill -f mcp-remote

# 清除MCP认证缓存
rm -rf ~/.mcp-auth

连接测试

# 测试直接连接
npx mcp-remote https://mcp.intercom.com/mcp

# 使用bearer令牌
npx mcp-remote https://mcp.intercom.com/mcp --header "Authorization:Bearer YOUR_TOKEN"

查看活跃的MCP连接

ps aux | grep mcp-remote | grep -v grep

错误处理

无效查询：搜索工具会验证字段名称和操作符，并返回具体的错误消息
认证失败：检查令牌有效性或重新启动OAuth流程
速率限制：Intercom API限速适用 - 如需减少请求频率

故障排除提示

配置更改后重启AI代理
使用MCP Inspector验证工具可用性
检查浏览器控制台中的OAuth相关错误
验证Intercom API令牌权限以进行Bearer认证