2.3 把 MCP 接进 Agent：自动与手动配置

2.3 把 MCP 接进 Agent：自动与手动配置

两种配置方式，先选自动

插件装好、端口放行、白名单加好之后，就剩把 MCP 服务接进你的 Agent。官方给了两种方式，推荐先用方式一。

方式	入口	适合谁
方式一：提示词自动配置	【接入与体验】页生成提示词	大多数人，推荐
方式二：手动配置	【安全授权】页获取地址和令牌	熟悉 Agent 配置文件的老手

两种方式拿到的接入信息是同一套，区别只在填写路径：自动配置让 Agent 自己按提示词完成，手动配置由你写进配置文件。

开始之前，先确认服务器侧三件事已经就绪：面板是正式版 13.0、Python 已升级到 3.13、8765 端口与 IP 白名单都配好了。这三件是 2.2 的内容，没做的先回去补——Agent 侧配得再对，服务器侧缺一项都连不上。

方式一：提示词自动配置（推荐）

操作路径：软件商店打开【宝塔 MCP 服务】→【接入与体验】→ 生成并复制安装提示词 → 把提示词发给要接入的 Agent → 按 Agent 的提示完成安装与连接。

这种方式的好处是把该填什么、填到哪都交给提示词和 Agent 协商，你主要就是复制、发送、确认。不同 Agent 的交互细节会有差异，按屏幕提示走即可。官方对这种方式的态度也是明确的：推荐先用它，走不通再考虑手动。

实际体验上，提示词里通常已经带了接入所需的关键信息，Agent 拿到后会引导你确认连接、测试可用性，整个过程你几乎不需要理解配置文件长什么样。对不熟悉 JSON 的站长来说，这相当于把技术细节都藏起来了。

如果发送提示词后 Agent 没有反应，或者获取提示词时就失败，先别怀疑 Agent，多半是面板侧的前置条件没就绪——比如证书链没就绪，或者 Python 没升级到位。这些在下面“证书这道前置关”里会说。

方式二：手动配置

如果自动配置走不通，或者你习惯自己掌控配置文件，就用手动方式。

入口：【安全授权】页获取 MCP 服务器地址和授权令牌，然后填入 Agent 的 MCP 配置文件。官方参考配置如下（JSON 原文照录）：

{
  "mcpServers": {
    "baota-mcp": {
      "url": "https://<面板公网IP>:8765/bt-mcp-<实例标识>/mcp",
      "headers": { "Authorization": "Bearer <授权令牌>" },
      "disabled": false
    }
  }
}

字段逐个解释：

字段	含义
mcpServers	MCP 服务器配置的根节点，一个 Agent 可以在这里配多个 MCP 服务
baota-mcp	你给这个 MCP 服务起的名字，可自定义，Agent 里按这个名字识别
url	MCP 服务器地址，依次包含面板公网 IP、端口 8765、实例标识和 mcp 路径
headers.Authorization	认证请求头，值为 Bearer 加上授权令牌
disabled	开关，false 表示启用；设为 true 可临时停用而不删配置

这张表建议对着自己的配置看一遍，尤其是 url 和 headers 两项——连接类问题，八成出在这两个值的正确性上。url 错了连不上，令牌错了鉴权失败，报错不同但都表现为连不上。

注意 url 里的地址和令牌都是【安全授权】页动态获取的，每套面板都不一样，不要照抄示例里的占位值，更不要把别人的配置直接拿来用。

再强调一次令牌的性质：它是动态生成的，重新生成之后旧令牌立即失效。所以手动配置的配置文件要注意同步更新，不然会出现昨天还好用、今天连不上的情况——遇到这种灵异现象，先想想是不是有人动过【安全授权】页。

证书这道前置关

部分系统需要有效的 HTTPS 证书链才能连接 MCP，表现就是获取安装提示词失败，提示未探测到有效证书链，或者 HTTPS 未就绪。官方给的解法是申请可信 IP 证书：

面板左侧【设置】→【安全设置】→【面板 SSL】；
打开面板 SSL，选择 IP 证书申请入口完成申请；
安装证书后，重新获取 MCP 接入信息。

建议在配置 Agent 之前就把这步确认掉：能正常拿到地址和令牌，说明证书链已经就绪；拿不到，先修证书，别急着去 Agent 侧折腾。

不同 Agent 的接入差异

官方提供了分客户端的接入教程，已覆盖的通道如下：

Agent / 通道	教程形式
Codex	官方分客户端教程
WorkBuddy	官方分客户端教程
Claude Code	官方分客户端教程
TRAE	官方分客户端教程
DeepSeek Harness	官方分客户端教程
Hermes 与 OpenClaw 消息通道	官方分客户端教程

其中两篇常用入口：

如果你的 Agent 不在列表里，可以参考通用 JSON，再按客户端文档调整三处：配置路径、远程 HTTP 传输字段、认证请求头。重点提醒：不要照抄其他 Agent 的配置路径——每个客户端读配置文件的位置和写法都不一样，照搬大概率连不上，还可能改错文件影响别的配置。

验证连接：先只读，后动手

配置完成后，让 Agent 执行一项只读操作，比如查询服务器基本信息。能正常返回，说明整条链路（端口 → 白名单 → 令牌 → Agent 配置）已经打通。

请查询这台服务器的基本信息：系统版本、CPU、内存、磁盘使用情况。只做查询，不要执行任何修改。

连不上怎么办？按 2.2 的常见问题表逐项排查：面板防火墙、云服务器安全组、白名单、地址与令牌、面板 SSL 证书，五项挨个过。经验上十有八九是前两项之一——端口没放全，或者出口 IP 没加对。

连接成功长什么样？Agent 会像平时回答问题一样，把服务器基本信息列给你：系统版本、CPU、内存、磁盘使用情况，一目了然。这时候你可以再补一个只读查询加深验证，比如让它列一下面板里有哪些网站：

列一下我这台服务器上所有的网站，以及每个网站的运行状态。只做查询，不要修改任何配置。

两个只读查询都能正常返回，就可以放心进入日常使用阶段了。第一次做管理类操作时，仍然建议挑个影响小的下手，比如重启一个测试站点，观察 Agent 的执行流程和面板侧的反应，熟悉之后再逐步放开。

自动与手动，怎么取舍

两种方式没有高下之分，只有场景之别：

你的情况	建议
第一次接触、想快点用上	方式一，按提示走
自动配置失败、提示语看不懂	先查证书和 Python，再试方式一
要接入的 Agent 不在官方教程列表	方式二，按通用 JSON 加客户端文档自己调
想把配置写进版本管理、批量分发	方式二，配置文件更可控
生产环境、多人协作	方式二，配置内容自己审核过才放心

敏感信息保管纪律

MCP 服务器地址和授权令牌属于敏感信息，纪律只有两条，但每条都得执行：

勿提交公开仓库、勿粘贴到公开聊天——令牌相当于 Agent 操作你服务器的钥匙，谁拿到谁就能连；
怀疑泄露，立即在插件里重新生成，旧令牌随之作废。

再补三个实操习惯：配置文件如果进了私有仓库，确认仓库权限最小化；截图分享配置时，把令牌和 IP 打码；团队共用 Agent 时，谁用谁的凭证，别共用一把钥匙。

单独说说团队场景。很多站长是替客户维护服务器，客户也有自己的 Agent 需求。这时候令牌就是责任边界：谁的令牌谁的操作记录可追溯，出了状况能定位到人。把令牌当密码管，这句话怎么强调都不过分。

小结

自动配置适合绝大多数人，手动配置适合想完全掌控的人；无论哪种，配置完都先用只读查询验证。Agent 种类繁多、接入方式各异，核心思路不变：拿到地址和令牌，按你自己 Agent 的规矩填进去。更细的官方步骤可以看宝塔 MCP 安装指引。

到这里，MCP 路线就完整了：知道它是什么（2.1）、装好它（2.2）、接进 Agent（2.3）。下一篇 2.4，我们换条路线，看看不用 MCP 的宝塔 Skill 怎么玩。