宝塔 MCP：让 AI 智能体通过自然语言管理服务器
宝塔 MCP 服务可将宝塔面板的运维能力接入支持 MCP 的 Agent。安装完成后，Agent 可以通过授权的 MCP 服务查询和管理服务器，实现“对话即运维”。
一、安装前准备
开始安装前，请确认以下条件：
• 已取得宝塔面板管理员权限和服务器终端权限 • 面板版本为正式版 13.0 • 面板运行环境已升级到 Python 3.13 • Agent 支持连接远程 MCP 服务 • Agent 所在网络可以访问服务器的 8765 端口
1. 更新面板和 Python
已有面板升级到 13.0：在面板首页右上角点击【更新】按钮即可。
# 全新安装 13.0 curl -sSO http://download.bt.cn/install/install13.sh && bash install13.sh # 更新 Python 到 3.13 bash /www/server/panel/ｓｃｒｉｐｔ/upgrade_py313_bundle.sh
2. 安装宝塔 MCP 服务
登录宝塔面板 → 软件商店 → 搜索“宝塔 MCP” → 找到【宝塔 MCP 服务】并点击安装
3. 放行 8765 端口
安装完成后，需要同时在宝塔面板防火墙和云服务器厂商的安全组中放行 8765 端口（TCP）。不建议向所有来源开放，优先填写 Agent 的固定公网出口 IP。
4. 设置 IP 白名单
软件商店 → 宝塔 MCP 服务 → 接入与体验 → 添加 Agent 的公网出口 IP
注意：IP 段放通暂不可用，请填写单个公网 IP。
二、配置 Agent
支持自动配置和手动配置两种方式，推荐优先使用自动配置。
方式一：使用提示词自动配置
接入与体验页面 → 生成并复制安装提示词 → 发送给 Agent → 按 Agent 提示完成安装与连接
方式二：手动配置
安全授权页面 → 获取 MCP 服务器地址和授权令牌 → 填入 Agent 的 MCP 配置文件
参考配置（JSON）：
{
"mcpServers": {
"baota-mcp": {
"url": "https://<面板公网IP>:8765/bt-mcp-<实例标识>/mcp",
"headers": {
"Authorization": "Bearer <授权令牌>"
},
"disabled": false
}
}
}MCP 服务器地址和授权令牌属于敏感信息，请勿提交到公开仓库或分享给无关人员。
三、支持接入的 Agent
• Codex • WorkBuddy（腾讯） • Claude Code • TRAE Work（字节跳动） • DeepSeek Harness（深度求索） • Hermes 与 OpenClaw 消息通道
未列出的 Agent 可参考通用 JSON 配置，根据客户端文档调整配置文件路径和认证字段。
四、宝塔 MCP 工具能力概览
宝塔 MCP 共提供 98 个工具，覆盖服务器运维的方方面面。工具按风险等级分为三类：
• low：只读操作（查询、查看），安全无副作用 • medium：有副作用（创建、修改、启停），需谨慎使用 • high：高危操作（删除、覆盖、执行命令），调用前须二次确认
主要工具分类如下：
| 分类 | 核心工具 | 说明 |
|---|---|---|
| 基础 | Read、Edit、Write、Glob、Grep、LS、Bash | 文件读写、目录浏览、内容搜索、命令执行 |
| 网站 | SiteList、SiteCreate、SiteDelete、SiteSSLApply、OneClickDeploy | 网站管理、SSL证书、一键部署CMS |
| 数据库 | DatabaseList、DatabaseCreate、DatabaseDelete、MysqlQuery | MySQL数据库管理、只读查询 |
| Docker | ContAInerList、ContainerControl、ImagePull、ComposeList | 容器管理、镜像拉取、编排项目 |
| Node.js | NodeVersion、NodeProjectCreate、NodeProjectControl | Node版本管理、项目部署与启停 |
| Python | PythonVersion、PythonEnv、PythonProjectCreate | Python版本管理、虚拟环境、项目部署 |
| Java | JavaJdk、JavaProjectCreate、JavaProjectControl | JDK管理、Java项目部署与启停 |
| Go | GoVersion、GoProjectCreate、GoProjectControl | Go环境管理、项目部署与启停 |
| 防火墙 | FirewallStatus、FirewallPortSet、FirewallIpSet | 防火墙状态、端口规则、IP规则 |
| 反向代理 | ProxyProjectCreate、ProxyProjectInfo、ProxyWriteConfig | 反代项目创建、查看、配置编辑 |
| 系统 | SystemInfo、ServiceStatus、ServiceControl | 系统信息、服务状态与启停 |
| 通知 | GetChannel、SendMessage | 通知通道管理、消息推送 |
| 计划任务 | GetCrontab、ManageCrontab | 计划任务列表查看与创建删除 |
五、验证连接
完成配置后，让 Agent 执行一项只读操作（如查询服务器基本信息）。如果 Agent 能正常返回信息，即表示 MCP 服务已成功接入。
六、常见问题
安装提示词获取失败：提示“未探测到有效证书链”，需在面板【设置】→【安全设置】→【面板 SSL】中申请可信 IP 证书。
Agent 无法连接 MCP 服务：依次检查面板防火墙是否放行 8765 端口、云服务器安全组是否放行、Agent 出口 IP 是否加入白名单、授权令牌是否填写正确。
官方链接：
https://docs.bt.cn/ai-ops/mcp/installation