---
title: "Agent 接入宝塔 MCP 与使用 Skills"
description: "介绍 MCP 与 Skills 的区别、宝塔面板 Skill 的当前实现，以及 Agent 接入宝塔 MCP 和安装 Skill 的方法。"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.bt.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

1. 在宝塔面板中安装【宝塔 MCP 服务】。
2. 配置 HTTPS、服务端口和 Agent 公网出口 IP 白名单。
3. 获取 MCP 服务器地址和授权令牌。
4. 在 Agent 中添加 MCP 服务。
5. 先执行查询服务器信息等只读操作，确认连接正常后再进行写操作。

完整步骤请参考 [宝塔 MCP 安装指引](/ai-ops/mcp/installation)。

已安装宝塔 MCP 服务的用户，可以继续阅读对应客户端的接入教程：

- [使用 Codex 接入宝塔 MCP](/ai-ops/agent/panel-integration/codex-mcp)
- [使用 WorkBuddy 接入宝塔 MCP](/ai-ops/agent/panel-integration/workbuddy-mcp)
- [使用 Claude Code 接入宝塔 MCP](/ai-ops/agent/panel-integration/claude-code-mcp)
- [使用 TRAE 接入宝塔 MCP](/ai-ops/agent/panel-integration/trae-mcp)
- [使用 DeepSeek Harness 接入宝塔 MCP](/ai-ops/agent/panel-integration/deepseek-harness-mcp)
- [通过 Hermes 与 OpenClaw 消息通道接入宝塔 MCP](/ai-ops/agent/panel-integration/hermes-openclaw-mcp)

## 安装宝塔面板 Skill

推荐优先将以下提示词直接发送给需要接入的 AI Agent：

```text
请根据 https://skillhub.cn/install/skillhub.md，安装 @btpanel/btpanel。
```

AI Agent 会根据 SkillHub 安装说明完成配置。SkillHub 页面还提供 Skill 压缩包下载，也可以使用 Skills CLI 安装。

完整安装方式、能力说明和配套 Skills 清单请参考[宝塔面板 Skill 安装与使用指引](/ai-ops/agent/panel-integration/skill-installation)。

:::warning 安全提示
- MCP 服务地址、授权令牌和 Skill 中的凭据均属于敏感信息，请勿提交到公开仓库或发送到公开聊天。
- 仅允许可信 Agent 和可信 IP 访问面板能力。
- 对删除文件、修改防火墙、重启服务等高风险操作保留人工确认。
:::

Source: https://docs.bt.cn/ai-ops/agent/panel-integration/index.mdx