跳到主要内容
DocumentationAPI ReferenceVideo Tutorials

MCP 服务器

MCP——模型上下文协议——是一种开放标准,允许 AI 助手发现并调用外部工具。如果您运行 MCP 兼容的服务器(您自己的服务器,或众多社区服务器之一),您可以将其插入 Hanc.AI,您的代理将在通话开始时获得该服务器的工具。

一旦连接,代理就可以在对话中调用这些工具——拉取实时数据、运行计算、启动后端工作流——就像内置的日历、HubSpot 或 API 工具集成一样。

适用于所有套餐

MCP 服务器适用于所有套餐,包括免费套餐。无每服务器费用——您只需为代理在调用工具时使用的通话分钟付费。

何时使用 MCP​

场景为什么 MCP 适合
您已经运行内部工具服务器一次连接,所有工具可供每个代理使用
您想在代理之间共享工具连接一次,附加到任意数量的代理
您使用社区 MCP 服务器插入流行的开源 MCP 服务器,无需编写自定义代码
您的工具表面经常变化代理在每次通话时重新发现工具——在服务器端添加/删除工具,无需触及仪表板

如果您有单个一次性端点,API 工具 更简单。如果您有一组相关工具,或者您已经维护一个 MCP 服务器,这是正确的集成。

连接 MCP 服务器​

1. 打开集成页面​

在仪表板侧边栏中,转到集成。滚动到 MCP 服务器部分。

2. 点击"连接 MCP 服务器"​

将打开一个模态框。填写:

字段描述
标签此连接的简短名称(例如 "销售工具"、"内部 CRM")。标签显示在代理工具选择器中,并作为提供给 AI 的工具名称的前缀,因此请保持简短且有意义。
URLMCP 服务器的 HTTPS URL。必须是公开可访问的地址——http:// 和私有/内部地址会被拒绝。
认证如果您的服务器是开放的,选择 None;如果它期望 Authorization: Bearer … 标头,选择 Bearer token。
令牌(仅限 Bearer)您的认证令牌。加密存储——只有您的平台账户可以解密以供使用。

点击保存。Hanc.AI 验证 URL 格式并存储连接。连接现在可供您工作区中的每个代理使用。

标签很重要

每个 MCP 服务器的工具名称都以连接标签为前缀,因此具有 lookup_order 工具的 MCP 服务器连接为 "Shop API" 时,在代理中将显示为 Shop_API_lookup_order。这可以防止当您连接多个恰好具有相似命名工具的 MCP 服务器时发生冲突。

3. 编辑、禁用或删除​

MCP 服务器列表显示您添加的每个连接的标签、URL、认证类型和状态。使用行操作来:

  • 编辑 — 更改标签、URL、认证类型或令牌
  • 删除 — 完全删除连接

删除连接会为所有已附加该连接的代理停用它——这些代理在下一次通话时会失去对其工具的访问。

将 MCP 工具附加到代理​

工作区中的连接对您的代理可用——但每个代理单独决定要暴露您的哪些连接。这意味着您可以拥有从不同 MCP 服务器拉取的单独销售和支持代理。

1. 打开代理的动作选项卡​

选择代理。打开动作选项卡。点击添加动作。

2. 从实时通话组中选择"MCP 服务器"​

下拉菜单显示三组:预取、实时通话、通话后。在实时通话组中查找——这是 MCP 服务器所属的位置,因为代理在对话期间调用 MCP 工具,而不是之前或之后。

3. 切换要启用的连接​

模态框列出您工作区中的每个 MCP 连接,每个连接都有一个开/关切换。打开此代理应使用的连接。您还可以在**"何时使用"**字段中写一个简短的说明——这是代理用来决定在对话中何时使用这些工具的内容。

点击保存。代理现在可以访问每个已启用的 MCP 连接的工具。

混合搭配

您可以让一个 MCP 连接在五个代理上启用,另一个仅在一个代理上启用——每个代理都有自己的 MCP 服务器工具,有自己的切换集合。

通话时如何工作​

通话开始时,代理连接到每个已启用的 MCP 服务器并询问"您提供哪些工具?"服务器返回的任何内容都暴露给 AI 作为它可以在对话期间调用的工具。

需要了解的几件事:

  • 工具在通话开始时被发现。 如果您在 MCP 服务器上添加或删除工具,更改会在下一次通话中显示——无需在 Hanc.AI 中更新任何内容。
  • 工具名称带有前缀(连接标签)(因此 "Shop API" + 工具 search_products → Shop_API_search_products)。内置代理工具和其他 MCP 工具不会冲突。
  • 工具描述和参数模式来自您的 MCP 服务器。 在那里写好描述——这是 AI 用来决定何时以及如何调用工具的内容。
  • 错误会报告回代理。 如果工具调用失败,代理会看到错误消息并可以决定重试、道歉或尝试其他工具。

对您的 MCP 服务器的要求​

要与 Hanc.AI 一起工作,您的服务器需要:

要求详情
HTTPS普通 http:// 不被接受。使用真实的 TLS 证书。
公共 URLURL 必须解析为公共地址——Hanc.AI 无法访问私有网络或 localhost 上的服务器。
MCP 可流式 HTTP 传输当前 MCP HTTP 传输通过单个端点。此集成不支持仅 SSE 和 stdio 传输。
Bearer 认证(可选)如果您的服务器需要认证,它必须接受标准 Authorization: Bearer <token> 标头。

如果您在防火墙后托管自己的服务器,请通过具有公共 HTTPS 端点的隧道或反向代理暴露它。

安全和隐私​

您的 bearer 令牌静态加密存储。只有 Hanc.AI 的通话基础设施可以解密它们,并且只有在通话开始且代理需要连接到您的服务器时。

工具调用流程为代理 → Hanc.AI → 您的 MCP 服务器 → 返回。我们不记录工具调用有效负载。您的服务器记录您选择在您端记录的任何内容。

如果您更改或轮换令牌,请在仪表板中编辑连接——新值在下一次通话时生效。

套餐可用性​

套餐MCP 服务器
Free可用
Starter / Pro / Business / Enterprise可用

无每连接费用——您只需为代理调用工具的通话分钟付费。

故障排除​

"连接无法保存"​

  • 确保 URL 以 https:// 开头,而不是 http://。
  • 确保主机公开可访问——localhost、127.0.0.1 和内部地址被设计阻止。
  • 如果您设置了 bearer 令牌,请重新检查——额外的空白或引号将破坏保存。

"代理看不到工具"​

  • 检查代理的动作选项卡上的 MCP 服务器条目是否至少有一个连接切换为开,并且条目已保存。
  • 确保您的 MCP 服务器响应 tools/list 请求,且不需要交互式认证流。
  • 在代理的通话日志中查找通话开始时来自 MCP 连接的消息。

"工具在通话中失败"​

  • 代理将看到您的服务器返回的任何错误。检查您的服务器日志。
  • 长时间运行的工具可能会超时——保持 MCP 工具执行每次通话不超过几秒钟,以便访客不会坐在沉默中。

"我在服务器上更改了工具,但代理仍使用旧的"​

  • 工具在每次通话开始时重新发现,不跨通话缓存。下一次新通话会看到更新的工具集。正在进行的通话保留它们在开始时获得的工具。

相关​