Skip to content
iCore TechnologyKnowledge Base

cPanel 新增 AI MCP：将 Codex 或 Claude 连接至您的主机账户

cPanel 最新的 Meridian 界面已经支持模型上下文协议（Model Context Protocol，简称 MCP）。连接后，OpenAI Codex、Claude Code 等兼容的 AI 工具可以在获得授权的情况下读取 cPanel 资料、协助维护主机账户及部署网站应用。

开始前：切换至 Meridian

MCP Connection 功能必须通过 cPanel 的 Meridian 界面设置。请使用主机商提供的最新 Meridian 版本。

登入 cPanel 后：

  1. 点击右上角的头像。
  2. 选择 Profile。
  3. 找到 Theme 部分。
  4. 选择 Meridian。
  5. 确认 Meridian 显示为 Active。

是否可以切换主题，取决于主机商是否开放 Meridian，以及您的账户是否符合使用条件。

进入 Meridian 后，如需返回传统 Jupiter 界面，可以点击页面顶部的 Classic cPanel Theme。

查看 cPanel 官方主题切换说明。

第一步：连接 WebPros Account

  1. 在 Meridian 点击右上角头像，然后选择 Profile。
  2. 打开 Account Preferences。
  3. 进入 Connections，找到 MCP Connection。
  4. 点击 Link WebPros Account。
  5. 登入或注册 WebPros Account。
  6. 按照浏览器提示批准连接。

连接成功后，cPanel 会显示 MCP 的连接资料。

如果看不到 MCP Connection，代表主机商可能尚未为您的账户开放此功能。

连接 Claude Code

  1. 在 MCP Connection 下载 mcp.json，或复制画面上的连接配置。
  2. 将配置加入电脑上的 ~/.claude.json 文件，并放在 mcpServers 部分。
  3. 重新启动 Claude Code。
  4. 输入 /mcp。
  5. 选择验证连接。
  6. 在浏览器中完成授权。

连接 OpenAI Codex

先从 cPanel 的 MCP Connection 复制 clientId。

在电脑的 ~/.codex/config.toml 文件加入：

[mcp_servers.webpros-mcp]
url = "https://mcp.webpros.com/api/mcp"

[mcp_servers.webpros-mcp.oauth]
client_id = "<clientId>"
callback_port = 64474

将 <clientId> 替换为 cPanel 显示的实际值，然后运行：

codex mcp login webpros-mcp --scopes=mcp

浏览器会自动打开。登入 WebPros Account 并批准连接即可。

查看 cPanel 官方 MCP 连接步骤。

cPanel MCP 可以做什么？

MCP 让 AI 工具通过 cPanel 的授权接口执行任务。实际可用功能取决于主机配套、服务器设置及主机商开放的权限。

网站与应用部署

AI 可以协助：

  • 部署 Node.js 网站或应用。
  • 设置应用使用的域名。
  • 安装应用依赖。
  • 设置环境变量。
  • 启动、停止、重新启动或重新部署应用。
  • 查看应用的构建及运行记录。

Node.js 与 AI App Hosting 必须由主机商开放。部署至现有域名时，该应用可能改变域名当前显示的内容。

查看如何通过 WebPros MCP 部署 Node.js 应用。

域名、DNS 与 SSL

根据账户权限，AI 可以协助：

  • 查看账户中的域名。
  • 查询或修改 DNS 记录。
  • 检查 DNS 是否指向正确的服务器。
  • 检查 SSL 与 AutoSSL 状态。
  • 查看 AutoSSL 错误。
  • 开启或关闭 HTTPS Redirect。
  • 管理 DNSSEC。
  • 新增或移除附加域名。

修改 DNS、DNSSEC 或 SSL 可能影响网站及邮件服务。执行前应确认域名和记录内容。

Email 管理

AI 可以协助：

  • 查看或创建 Email Account。
  • 检查邮箱容量。
  • 调整邮箱 Quota。
  • 创建 Forwarder。
  • 设置 Autoresponder。
  • 建立或管理 Email Filter。
  • 查看邮件客户端连接设置。
  • 管理受支持的 SpamAssassin 功能。

请勿在聊天内容中提供现有邮箱密码。需要设置新密码时，请使用独立、高强度的密码。

文件与备份

AI 可以协助：

  • 查看文件及文件夹。
  • 读取或更新网站文件。
  • 上传、复制、移动及重新命名文件。
  • 将文件移至 Trash。
  • 从 Trash 恢复文件。
  • 创建网站或账户备份。
  • 查看及恢复备份。
  • 设置文件夹密码保护。

删除文件、覆盖内容或恢复备份前，应先建立并验证备份。

数据库管理

AI 可以协助：

  • 查看 MySQL 数据库。
  • 创建数据库及数据库用户。
  • 设置用户权限。
  • 检查数据库结构。
  • 检查或修复数据库。
  • 重新命名或删除数据库。

删除数据库或修改用户权限属于高风险操作。执行前必须确认数据库名称、影响范围及备份状态。

用量与故障检查

AI 还可以读取：

  • Disk Quota。
  • Bandwidth Usage。
  • 网站错误记录。
  • SSL 与 AutoSSL 问题。
  • FTP、Email 和数据库资料。
  • 部分网站及应用运行状态。

这让 AI 可以先收集资料，再提供较准确的排查建议。

可以怎样向 AI 下指令？

建议先使用只读指令：

使用 webpros-mcp 检查我的 cPanel 磁盘用量，只读取资料，不要修改任何设置。
检查这个域名的 SSL 和 AutoSSL 状态，并说明发现的问题。暂时不要执行修复。
列出目前的 Email Account、使用量和 Quota，不要显示或更改任何密码。

需要执行变更时：

先为网站建立备份，然后列出将被取代的文件，等待我确认后才上传新版本。
使用 webpros-mcp 准备将这个 Node.js 项目部署至我的 cPanel。部署前先说明域名、运行环境和所有预期变更。

安全建议

MCP 不只是聊天功能。获得授权的 AI 工具可能读取资料，也可能执行会改变账户状态的操作。

  • 先要求 AI 进行只读检查。
  • 修改前要求 AI 列出完整计划。
  • 对删除、覆盖、DNS、SSL、Email 和数据库操作逐项确认。
  • 重要变更前先建立并验证备份。
  • 不要在聊天内容中发送密码、API Token、私人密钥或一次性验证码。
  • 操作后检查网站、Email、SSL 和数据库是否正常。
  • 只在自己的电脑和受信任的 AI 客户端上连接 MCP。

如何断开 MCP？

  1. 登入 cPanel Meridian。
  2. 打开 Account Preferences。
  3. 找到 MCP Connection。
  4. 点击 Unlink WebPros Account。

断开后，WebPros Account 将不再连接至该 cPanel 账户。日后如需再次使用，必须重新登入和授权。

需要协助？

如果您的 cPanel 没有 Meridian、Theme 或 MCP Connection 选项，请联络 iCore Support，并提供您的 cPanel 用户名或主域名。

请勿通过 Email、Telegram 或 WhatsApp 发送 cPanel 密码、WebPros 密码、API Token、私人密钥或一次性验证码。