3CX MCP 工具与权限级别

介绍

下文对 3CX MCP 服务器支持的 AI 功能及相关权限级别进行说明。这将帮助您管理 AI 客户端权限、MCP 连接以及 AI 可访问的具体 PBX 功能。

AI 客户端工具审批设置

这些设置定义了 AI 客户端如何访问各个工具，是任何请求到达 PBX 之前的第一道门禁。

  • 始终允许：客户无需干预即可立即执行该工具。
  • 需要批准：客户端在执行每个请求之前都会提示用户确认。
  • 否定：客户端完全阻止了该工具的运行。

这些客户端侧设置并不会授予额外的 3CX 权限，而是控制请求以何种方式（以及是否）提交给 3CX。3CX MCP 服务器仍会将每个请求作为经过身份验证的 3CX 用户进行评估。

3CX 权限集成

AI 的能力严格限制于授权连接的 3CX 用户的权限。MCP 服务器将 AI 请求映射到此特定账户，并继承所有相关的基于角色的访问控制和功能。

  • 账户级别的限制（如部门访问、队列管理或 DID 设置）始终得到遵守。
  • 如果特定 3CX 用户缺乏修改数据的权限，无论客户端配置如何，AI 都无法执行这些操作。
  • Query 工具严格限制为只读操作，以确保数据库完整性。

用户角色和工具访问权限

下表列出了 3CX MCP 服务器提供的可用工具。用户能够查看或操作哪些内容，取决于用于连接的 3CX 账户的权限。

只读工具

这些工具允许 AI 查看 PBX 的信息。它们不会更改 PBX 设置或影响通话。

用户、联系人和目录

  • 通过电子邮件查找- 通过电子邮件地址查找联系人。
  • 查找分机- 通过确切的分机号码查找联系人。
  • 列出 CRM 联系人- 从集成的 CRM 系统中搜索联系人。
  • 列出电话簿- 搜索可用的 3CX 电话簿。
  • 列出用户- 列出PBX用户和分机号。

通话、录音和语音邮箱

  • 列出正在进行的通话- 显示当前正在进行的通话。
  • 列出录音- 列出已认证用户可访问的录音。
  • 列出语音邮箱- 列出已认证用户可访问的语音邮件条目。

队列、部门和个人资料

  • 列出部门成员- 显示部门成员。
  • 列出部门- 显示已认证用户可以访问的部门。
  • 列出个人资料- 显示当前用户可用的转发或在线状态配置文件。
  • 列出队列代理- 显示队列中的坐席。
  • 列出队列- 显示当前用户可以访问或管理的队列。

系统和诊断

  • 获取服务器时间- 显示当前PBX服务器时间。
  • 列出事件日志- 搜索或列出结构化的 PBX 事件信息。
  • 列表服务- 列出 PBX 服务及其当前状态。
  • 搜索日志- 使用可用过滤器搜索应用程序日志。

PBX库存和数据库

  • 描述表 - 返回可访问数据库表的架构。
  • 列出 DID - 列出 PBX 上可用的 DID。
  • 列出 IP 黑名单 - 列出 IP 黑名单中的条目。
  • 列出对等体 - 列出已配置的 PBX 对等体。
  • 列出电话黑名单 - 列出电话黑名单中的条目。
  • 列出表 - 列出当前用户可访问的数据库表。
  • 列出中继 - 列出已配置的 SIP 中继。

呼叫流程工具

  • 获取呼叫流程应用程序- 获取呼叫流程应用程序的详细信息。
  • 获取呼叫流程应用程序文件- 获取与呼叫流程应用程序关联的文件。
  • 获取编辑网址- 返回受支持的 PBX 对象的编辑 URL。
  • 列出呼叫流程应用程序- 列出PBX上可用的呼叫流程应用程序。

写入或删除工具

写入或删除工具可能会更改呼叫状态、用户状态、路由数据、黑名单或呼叫流程。强烈建议将这些工具设置为禁用状态。需要批准 或者 已屏蔽，除非工作流程已经过审核，并且已授权经过身份验证的用户执行该操作。

通话、队列与个人资料操作

  • 挂断通话 - 结束选定的活动通话。
  • 选择个人资料 - 激活转接或状态个人资料。
  • 设置个人资料消息 - 设置或清除活动个人资料的消息。
  • 设置个人资料覆盖 - 应用临时的个人资料覆盖。
  • 设置队列坐席状态 - 当用户拥有所需权限时，将队列坐席签入或签出。
  • 设置队列状态 - 将当前用户签入或签出队列。

PBX 配置操作

  • 添加 IP 黑名单条目- 将 IP 地址添加到 PBX IP 黑名单中。
  • 添加电话号码到黑名单- 将号码添加到电话黑名单。
  • 分配 DID- 使用已认证用户可用的权限分配 DID。
  • 删除 IP 黑名单条目- 从 PBX IP 黑名单中删除 IP 地址。
  • 移除电话号码黑名单- 从电话黑名单中移除号码。
  • 更新呼叫流程应用程序脚本- 更新呼叫流程应用程序使用的脚本。

另请参阅

最后更新时间
本文件最后更新日期为2026年7月28日。
https://www.3cx.cn/docs/mcp-tools-permissions/