Agent 接入宝塔 MCP 与使用 Skills
已经安装好的 Agent 可以直接接入宝塔 MCP，也可以安装宝塔面板 Skill，让 Agent 按照预设流程完成 MCP 部署、接入、运维和排障任务。
技术区别与宝塔当前实现
MCP 和 Skills 是相互独立的机制：MCP 可以在不安装 Skill 的情况下直接为 Agent 提供工具；Skill 也可以只包含知识、脚本或操作流程，不依赖 MCP。
| 组件 | 主要作用 | 使用方式 |
|---|---|---|
| 宝塔 MCP | 建立 Agent 与宝塔面板之间的连接，并提供可调用的运维工具 | 在宝塔面板安装 MCP 服务，再在 Agent 中配置服务地址和授权信息 |
| 宝塔面板 Skill | 指导 Agent 安全部署、接入和使用 MCP，并提供项目部署、故障排查等标准流程 | 通过 SkillHub、压缩包或 Skills CLI 安装到 Agent |
当前宝塔面板 Skill 选择以宝塔 MCP 作为面板操作通道：未配置 MCP 时，Skill 会指导 Agent 部署并接入 MCP；已经配置 MCP 时，则指导 Agent 调用工具完成任务。因此，用户可以只配置宝塔 MCP，也可以再安装 Skill 获得更完整的自动化流程和安全约束。
配置宝塔 MCP
- 在宝塔面板中安装【宝塔 MCP 服务】。
- 配置 HTTPS、服务端口和 Agent 公网出口 IP 白名单。
- 获取 MCP 服务器地址和授权令牌。
- 在 Agent 中添加 MCP 服务。
- 先执行查询服务器信息等只读操作，确认连接正常后再进行写操作。
完整步骤请参考 宝塔 MCP 安装指引。
已安装宝塔 MCP 服务的用户，可以继续阅读对应客户端的接入教程：
- 使用 Codex 接入宝塔 MCP
- 使用 WorkBuddy 接入宝塔 MCP
- 使用 Claude Code 接入宝塔 MCP
- 使用 TRAE 接入宝塔 MCP
- 使用 DeepSeek Harness 接入宝塔 MCP
- 通过 Hermes 与 OpenClaw 消息通道接入宝塔 MCP
安装宝塔面板 Skill
推荐优先将以下提示词直接发送给需要接入的 AI Agent：
请根据 https://skillhub.cn/install/skillhub.md，安装 @btpanel/btpanel。
AI Agent 会根据 SkillHub 安装说明完成配置。SkillHub 页面还提供 Skill 压缩包下载，也可以使用 Skills CLI 安装。
完整安装方式、能力说明和配套 Skills 清单请参考宝塔面板 Skill 安装与使用指引。
安全提示
- MCP 服务地址、授权令牌和 Skill 中的凭据均属于敏感信息，请勿提交到公开仓库或发送到公开聊天。
- 仅允许可信 Agent 和可信 IP 访问面板能力。
- 对删除文件、修改防火墙、重启服务等高风险操作保留人工确认。