---
title: "宝塔 MCP 介绍"
description: "介绍宝塔 MCP 的作用、工作方式、适用场景，以及它与宝塔面板 AI 助手的区别。"
---

> 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.

# 宝塔 MCP 介绍

MCP（Model Context Protocol，模型上下文协议）是一种用于连接 AI 应用与外部工具、数据和服务的开放协议。宝塔 MCP 服务通过标准化接口，将宝塔面板的运维能力接入支持 MCP 的 Agent，让用户可以在常用的 AI 工具中查询服务器状态并执行经过授权的面板操作。

## 宝塔 MCP 能做什么

完成安装和授权后，Agent 可以通过自然语言理解用户意图，再调用宝塔 MCP 服务完成对应的服务器运维任务。它适合以下场景：

- 在支持 MCP 的 Agent 中查询服务器和服务状态
- 辅助完成网站、数据库、防火墙等面板运维工作
- 将宝塔面板能力接入已有的 AI 工作流
- 减少在多个管理界面之间切换和手动编写命令

## 与宝塔 AI 助手的区别

| 对比项 | 宝塔 AI 助手 | 宝塔 MCP |
|--------|--------------|----------|
| 使用入口 | 宝塔面板内的 AI 功能 | 支持 MCP 的外部 Agent |
| 主要用途 | 在面板内对话、诊断、分析和执行运维任务 | 将宝塔面板能力提供给外部 Agent 调用 |
| 接入方式 | 在面板中配置模型后使用 | 安装 MCP 服务并配置服务地址、授权令牌和 IP 白名单 |
| 适用场景 | 希望直接在宝塔面板中使用 AI | 希望在已有 Agent 或 AI 工作流中管理宝塔面板 |

两者可以并行使用：宝塔 AI 助手提供面板内的一体化 AI 运维体验，宝塔 MCP 则负责连接外部 Agent。

## 工作方式

宝塔 MCP 的接入流程包括：

1. 在宝塔面板中安装【宝塔 MCP 服务】
2. 配置 HTTPS、`8765` 端口和 Agent 的公网 IP 白名单
3. 获取 MCP 服务器地址和授权令牌
4. 在支持 MCP 的 Agent 中完成连接配置
5. Agent 通过 MCP 服务调用经过授权的面板能力

:::warning 安全说明
MCP 服务器地址和授权令牌属于敏感信息。生产环境应仅允许可信 IP 访问服务端口，并妥善保存授权令牌；如发现泄露，请立即重新生成授权信息。
:::

## 下一步

- [安装并配置宝塔 MCP 服务](/ai-ops/mcp/installation)
- [查看宝塔 MCP 工具说明](/ai-ops/mcp/tools-reference)
- [宝塔 MCP 正式发布！AI 运维版图，再补一块关键拼图](https://mp.weixin.qq.com/s/vJcbah40anqwtVVxxIczyg)

Source: https://docs.bt.cn/ai-ops/mcp/index.mdx