用途：指导将宝塔 Linux 面板 13.0 通过 MCP 协议接入 AI Agent（Codex/ZCode/Kimi/Claude Code），实现服务器状态查询等操作。
主要能力：提供安装前置条件、5 步安装流程、8765 端口放行（面板防火墙与云安全组两处）、IP 白名单设置、多客户端 MCP 配置示例、Bearer Token 鉴权、HTTPS 证书要求、常见错误排查表与安全建议。
使用方式：前置需宝塔 13.0 正式版、root/sudo 终端权限、Python 3.13、Agent 支持远程 MCP（Streamable HTTP）且网络可达 8765 端口。步骤包括升级面板与 Python（bash /www/server/panel/script/upgrade_py313_bundle.sh）、软件商店安装宝塔 MCP 服务、放行 8765 端口、在接入与体验页添加 Agent 公网出口 IP（仅支持单个 IP，可用 curl ifconfig.me 查询）、配置 Agent（自动生成提示词或手动填写 JSON/TOML，含 url 与 Authorization: Bearer <授权令牌>）。接入路径为 /bt-mcp-<实例标识>/mcp，需有效 HTTPS 证书，不可用自签名。
适用场景：需要安全安装并配置宝塔 MCP 多客户端接入、按最小权限与可回滚方式执行并保留审计证据时。
限制：仅支持单个公网 IP 白名单，不支持 IP 段；需 HTTPS 证书链，Agent 会拒绝自签名证书；Python 未升至 3.13 会导致接入信息 HTTP 500；不关闭 TLS 校验，不执行来源不明脚本；生产变更前需备份并确认回滚路径；涉及凭据时需脱敏，不复制完整令牌。