AI导哈

模型上下文协议

MCP是一种协议，使AI工具和应用程序能够以安全、标准化的方式连接和交互Intercom的数据和服务。

  • by intercom
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 intercom/intercom-mcp-server

使用说明

模型上下文协议（MCP）

学习如何使用 模型上下文协议（MCP） 使AI代理能够在有需要时安全地访问您的对讲机数据并与之交互。

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

什么是模型上下文协议？

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

  • 查找和检索内部通信数据（对话、联系人等）
  • 访问对讲机提供的特定工具和功能
  • 与人工智能助手一起工作时，保持对讲机工作空间的上下文

MCP的工作原理

Intercom托管一个遵循经过身份验证的远程MCP规范的远程MCP服务器(文档).该服务器处理来自人工智能工具的请求，并通过安全接口提供对内部通信数据的访问。

连接URL:

  • 流式HTTP（推荐）: https://mcp.intercom.com/mcp
  • 传统SSE: https://mcp.intercom.com/sse （已弃用，为向后兼容性而保留）

当人工智能工具或应用程序需要访问对讲机数据时：

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

使用MCP的好处

  • 安全访问：所有数据访问都经过身份验证和授权
  • 标准化接口：不同AI工具之间的一致交互模式
  • 情境理解：人工智能助手保持对内部通信环境的感知
  • 提高开发效率：通过内部AI工具从Intercom检索和解释客户数据，以提高工作效率

可用工具

内部通信MCP服务器提供 6工具 用于与内部通信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:"refund" limit:20

获取

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

主要特点：

  • 使用搜索结果返回的ID（前缀为 conversation_ 或 contact_)
  • 返回完整的资源详细信息，包括元数据、对话部分、自定义属性
  • 包括与对讲机应用程序的直接链接，便于导航

API直接工具

搜索_对话

使用高级过滤选项按特定ID搜索对话，包括源类型、作者详细信息、状态和时间统计。

get_对话

按ID检索单个会话，包括所有会话部分和元数据的完整详细信息。

search_contacts

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

get_contact

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

设置东西

身份验证方法

MCP服务器支持 两种身份验证方法:

  1. OAuth流（推荐）：基于浏览器的自动身份验证
  2. 持有者令牌：直接API令牌身份验证

配置示例

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

对于 OAuth身份验证 （推荐）：

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

对于 承载令牌身份验证:

{
  "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服务器需要以下权限才能访问您的工作区数据。使用承载令牌身份验证时，请确保您的访问令牌包括这些范围。 了解有关OAuth权限的更多信息.

  • 阅读并列出用户和公司：内部通信用户和公司数据访问所需
  • 阅读对话：对讲机对话数据访问所需

用于服务器探索的MCP检查器

使用以下方法测试连接：

npx @modelcontextprotocol/inspector

然后连接到：

  • 传输类型：流式HTTP
  • 统一资源定位符: https://mcp.intercom.com/mcp （或 /sse 为遗产）

MCP远程调试和故障排除

  1. 身份验证问题
# Kill existing connections
pkill -f mcp-remote

# Clear MCP auth cache
rm -rf ~/.mcp-auth
  1. 连接测试
# Test direct connection
npx mcp-remote https://mcp.intercom.com/mcp

# With bearer token
npx mcp-remote https://mcp.intercom.com/mcp --header "Authorization:Bearer YOUR_TOKEN"
  1. 查看活动MCP连接
ps aux | grep mcp-remote | grep -v grep

错误处理

  • 无效查询：搜索工具验证字段名和运算符，返回特定的错误消息
  • 身份验证失败：检查令牌有效性或重新启动OAuth流
  • 速率限制：适用内部通信API限制-如果需要，降低请求频率

故障排除提示

  • 配置更改后重新启动AI代理
  • 使用MCP检查器验证工具可用性
  • 检查浏览器控制台是否存在与OAuth相关的错误
  • 验证承载身份验证的内部通信API令牌权限

相关 MCP