将 Claude Terminal 连接到 3CX MCP 服务器

介绍

本指南说明如何将终端中的Claude Code连接到3CX MCP服务器。授权完成后,Claude可以使用批准该连接的3CX用户所拥有的3CX MCP工具。

要求

  • 您的3CX PBX必须可以公开访问。
  • 一个被允许认证应用程序并使用所需工具的3CX用户。
  • 已安装并登录的Claude Code。
  • 在将使用此连接的项目文件夹中打开的终端。

从 3CX 复制 MCP 服务器 URL

登录到 3CX 管理控制台并打开管理 > 集成 > MCP 客户端 > 添加 MCP 客户端复制 3CX 显示的 MCP 服务器 URL,并完全按照显示的内容使用。

连接Claude终端

添加 MCP 服务器

在项目文件夹中运行以下命令。将示例FQDN替换为您从3CX复制的MCP服务器URL。

claude mcp add --scope project --transport http 3CX "https://yourpbx.3cx.eu/mcp"

在同一个文件夹中启动Claude。

claude

Claude检测到新的项目MCP服务器,并询问您希望如何继续。

从 /mcp 进行身份验证

  • 输入 /mcp 打开MCP服务器管理器。

  • 使用方向键选择3CX服务器,然后按Enter键。

  • 选择 Authenticate(认证)。

  • Claude会在您的浏览器中打开授权页面。如果未自动打开,请复制终端中显示的URL并自行打开。

  • 登录3CX,查看请求的访问权限,然后选择 Allow(允许)。

  • 认证成功后,Claude会给出确认信息。

  • 该连接也会出现在3CX管理控制台的管理 > 集成 > MCP客户端中。

测试连接

  • 询问“我的PBX有多少个分机?” Claude会显示它想要使用的3CX工具,并请求您的批准

  • 批准该请求以接收结果。

权限与限制

Claude使用批准连接的3CX用户的权限。它只能访问该用户在3CX中已被允许使用的数据和执行该用户已被允许执行的操作。

如果请求被拒绝或返回的数据有限,请检查该用户的3CX角色和权限。详细信息请参阅“3CX MCP工具与权限参考”。

另请参阅

最后更新时间

本文件最后更新于2026年8月6日。

https://www.3cx.cn/docs/connect-claude-terminal/