STARWARCLOUD STARWAR.AI
返回市场
内部通信-MCP服务器

内部通信-MCP服务器

作者：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数据时：

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

使用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服务器支持两种认证方式：

  1. OAuth流程（推荐）：自动浏览器认证
  2. 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服务器的具体设置说明。请查阅您提供商的官方文档：

必要的权限范围

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

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

MCP Inspector用于服务器探索

测试连接使用：

npx @modelcontextprotocol/inspector

然后连接到：

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

调试和故障排除MCP-Remote

  1. 认证问题
# 终止现有连接
pkill -f mcp-remote

# 清除MCP认证缓存
rm -rf ~/.mcp-auth
  1. 连接测试
# 测试直接连接
npx mcp-remote https://mcp.intercom.com/mcp

# 使用bearer令牌
npx mcp-remote https://mcp.intercom.com/mcp --header "Authorization:Bearer YOUR_TOKEN"
  1. 查看活跃的MCP连接
ps aux | grep mcp-remote | grep -v grep

错误处理

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

故障排除提示

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