将 ChatGPT 或 Claude 连接到 3CX MCP 服务器

介绍

本文档说明如何在您的 AI（本例中我们将介绍使用聊天代理）与您的 PBX 之间建立集成。

这使得您的聊天代理能够查询 PBX 上的大多数信息（例如：查询分机列表或活动通话）。此功能可作为管理控制台的绝佳辅助工具。

设置要求

在开始之前，PBX 管理员必须准备以下内容：

  • 您的 3CX PBX 必须可通过公网访问，且使用 443 端口。
  • 一个 3CX 用户，该用户被允许对应用程序进行身份验证并使用所需的工具。
  • 您偏好的 AI 客户端/代理，例如 ChatGPT 或 Claude。

设置 ChatGPT

  • 访问您的 OpenAI ChatGPT 账户并登录。

  • 在 ChatGPT 页面上，点击侧边栏底部的个人资料，然后点击 设置 选项。

  • 启用 开发者模式。
  • 如果该选项被隐藏或无法启用，您可能属于企业工作区。请联系您的管理员以启用创建自定义 MCP 连接器的权限。

  • 在 3CX 管理控制台中，从“管理 → 集成 → MCP 客户端 → 添加 MCP 客户端”获取您的 PBX 的 MCP URL。
  • 访问 OpenAI ChatGPT 插件管理页面。

  • 点击 + 图标。

  • 提供以下详细信息：
  • 图标（Icon）
  • 名称（Name）
  • 描述（Description）
  • 连接 URL（Connection URL）

  • 如果您使用的是 ChatGPT 桌面版，输入 URL 的相应位置在“Streamable HTTP”选项卡下。

  • 提供正确的设置凭据和授权信息：
  • 身份验证（Authentication）（身份验证类型必须为 OAuth）。
  • 点击“我理解并希望继续”复选框。
  • 点击 创建（Create） 按钮继续。

  • 当提示授权集成时，您将通过 3CX 门户登录。

  • 确认 AI 客户端提供的附加工具、运行时设置和选项。

  • 打开一个新对话，并使用如下查询测试功能：“我的 PBX 有多少个分机？”

设置 Claude

  • 访问您的 Claude 账户并登录。

  • 导航至 自定义 → 连接器（Customize -> Connectors），然后点击 添加 → 添加自定义连接器（Add -> Add custom connector） 菜单选项。

  • 在 3CX 管理控制台中，从“管理 → 集成 → MCP 客户端 → 添加 MCP 客户端”获取您的 PBX 的 MCP URL。

  • 为您的连接器命名，并添加 3CX MCP Server 端点 URL；然后点击 添加（Add） 按钮。

  • 确认 AI 客户端提供的附加工具、运行时设置和选项。

  • 打开一个新对话，并使用如下查询测试功能：“我的 PBX 有多少个分机？”

权限与限制

通过 MCP 进行的 AI 操作使用您的 3CX 账户凭证，这意味着它继承您现有的角色和权限。它只能执行您已经在 3CX 中被授权直接处理的操作或访问的信息。

这意味着，尝试提示和使用您无权访问的功能将会返回错误，这属于预期行为。有关权限的更多信息，请参阅 3CX MCP 工具与权限级别。

启用组织范围内插件的添加

通过上述相同方式，也可以在您的 AI 提供商 UI 中与工作区相关的区域，使您的连接器可供整个组织使用。

要管理组织级部署、发布权限和管理员级限制，请参阅平台提供商提供的官方文档：

另请参阅

最后更新
本文档最后更新于 2026 年 8 月 3 日
https://www.3cx.cn/docs/connect-chatgpt-claude-mcp-server/