概述
MCP(Model Context Protocol)让 AI SRE Agent 接入外部工具与数据源。每台 MCP 服务器是一个对外暴露一组工具(函数)的标准化端点,例如查询 GitHub Issue、向 Slack 发消息、读取 Kubernetes 资源、检索可观测平台指标等。 在控制台里配置好 MCP 服务器并启用后,Agent 会在排障故障时自主判断何时需要外部能力,并直接调用对应工具,无需您手工搬运数据。什么是 MCP
MCP(Model Context Protocol,模型上下文协议)是一套开放协议,用统一的方式描述“一台服务器对外提供哪些工具、每个工具接收什么参数、返回什么结果”。任何遵循 MCP 的服务器,Agent 都能直接发现和调用,无需为每个外部系统单独写适配代码。 在 AI SRE 中,MCP 的作用是把 Agent 的能力从“内置工具”扩展到“任意外部系统”:- 您在控制台添加一台 MCP 服务器(声明它的端点、传输方式与认证)。
- 会话开始时,已启用且在当前作用域可见的服务器即对 Agent 可见、可调用。
- Agent 在需要时即可发现该服务器提供的工具并直接调用。
从市场安装 MCP 服务器
进入 自定义 → 插件 → 概览 页面,即可看到 Flashduty 精选的第三方 MCP 模板目录。目录按类别分页签展示(全部 / 可观测 / 云与基础设施 / 数据库与中间件 / 代码与协作 / Skill),右上角的搜索框按名称或描述过滤。 目录上方的 推荐 区会根据您账户已配置的告警集成(按近 30 天告警量排序)推荐最多 3 个模板,不包括已安装、需要 Runner 或您无权安装的模板。1
找到要连接的模板
点击模板行或其右侧的 +,打开 连接 对话框。如果模板需要自托管 Runner,而账户没有可用的 Runner,该模板会标注 需要自托管 Runner。您无权安装的模板显示为不可点击。
2
核对模板信息并填写连接参数
对话框会显示模板的供应商、官方文档、简介和示例问题,然后填写连接参数。共享字段由全账号共用;成员授权(密钥)模式的模板还需要填写您自己的 API Token,其他成员首次使用时各自填写。
3
选择运行环境并提交
选择从哪个运行环境发起连接(默认为会话所在环境)。只能在内网访问的系统,请选择内网中的自托管 Runner。成员授权(OAuth)模式的模板,点击 去〈名称〉授权 后会在浏览器中完成授权,见下文认证。
4
确认连接结果
提交后系统会创建连接器并测试连接。成功后可以点击示例问题,新建一条预填该问题的对话。失败时会显示错误,可以 重试;需要 Runner 的模板还可以让 AI SRE 在 Runner 上安装缺失的命令行工具(如
npx 需要的 Node.js、uvx 需要的 uv)。连接参数以首次提交为准,之后如需修改,请到 插件 → MCP 编辑。如果账户中已有同名连接器,请直接使用它,或由账户所有者或管理员改名或删除后再连接。
只能由 Monitors 查询的系统
目录中还列出了通过 Monitors 查询的系统(如 Loki、VictoriaLogs、Oracle)。它们不能在市场中连接:在 Monitors 中添加这类数据源后,AI SRE 就能直接查询,不需要地址、令牌或 Runner。点击这类行可以看到账户中已有的该类数据源;已有数据源时可以点击 在对话里试试,还没有时可以点击 去 Monitors 添加更多 →(需要添加数据源的权限)。 部分模板(如 Prometheus、MySQL、PostgreSQL、ClickHouse、Elasticsearch、SLS)同时支持直连 MCP 和通过 Monitors 查询,标签为MCP · Monitors,连接时可以选择接入方式。
行名与模板名共用同一套命名空间:如果某个系统已经有同名模板,就只显示模板行(模板行才是带连接参数的那一行)。私有化部署如果不含 Monitors 模块,不会显示这些行和 Monitors 接入方式。
添加 MCP 服务器
进入 自定义 → 插件 → MCP 页面,列表页右上角有三个入口:- 从插件目录添加:跳到 自定义 → 插件 → 概览(插件目录,见上文“从市场安装 MCP 服务器”),挑选并安装预置的 MCP 模板,安装后出现在本列表中。需要 MCP 的创建权限。
- 添加 MCP:点击后弹出表单,手工定义一台 MCP 服务器(字段见下文“基础字段”)。
- 在对话中添加:新建一条预填提示的会话,由 Agent 询问您要接入自己的服务还是安装现成的,先查插件目录,没有再联网搜索候选供您选择。只有在能确定写入范围时(您有账户级权限,或当前只选中了一个您所属的团队)才显示此按钮。
基础字段
Agent 首次列出某服务器的工具后,系统会自动生成一段 AI 描述 显示在列表中,并随工具变化自动更新。
传输方式
stdio 命令在 Runner 所在机器上运行,而不是您的电脑。不要使用个人路径(如
/Users/<用户名>/...),并确保 Runner 上已安装所需的运行时(如 uv / uvx / node / npx),否则连接会失败。认证
MCP 服务器支持三种授权模式,决定凭证如何提供给服务器:- 服务授权(默认)
- 成员授权(密钥)
- 成员授权(OAuth)
所有会话以同一个服务身份调用。凭证直接写在服务器配置里——HTTP/SSE 传输写进 Headers(JSON)(如
{ "Authorization": "Bearer xxx" }),stdio 传输写进环境变量(JSON)(如 { "API_KEY": "xxx" })。适合用账户级服务令牌访问的内部系统。以下键名(不区分大小写)的值会加密存储并以掩码显示,其余按原样保存,因此请把凭证放在这类键名下(如 Authorization、X-API-Key、GITHUB_TOKEN):- 包含
KEY、SECRET、TOKEN、PASSWORD、PASSWD、CREDENTIAL或AUTHORIZATION; - 或按非字母数字字符拆分后,某一段正好是
PWD或PASS(如REDIS_PWD、db-pass;BYPASS、COMPASS不算)。
成员授权模式下,缺少凭证时工具调用会暂停,提示当前成员填写或授权,完成后继续。
MCP 服务器授权(设置页)
成员授权(密钥 / OAuth)的凭证按成员隔离。除了在对话中按提示授权,您也可以在 MCP 列表中主动管理自己的授权,两种方式保存的是同一份凭证。 授权状态:MCP 列表的“成员授权”列显示您自己的授权状态:- 成员授权(OAuth):● 已连接(已保存有效凭证)/ ○ 未连接(尚未提供凭证)。
- 成员授权(密钥):● 已保存 / ○ 未填写。系统不会验证密钥是否有效。
- 两种模式通用:⚠ 已过期(凭证已过期,OAuth 令牌到期,需重新授权)。
- 成员授权(OAuth):选择执行环境(云端 Sandbox 或在线的 BYOC Runner,不能选“自动”),然后点击 去授权 或 重新授权,在弹出的浏览器窗口中完成授权,无需复制令牌。只能从内网访问的 OAuth 服务,请选择能访问它的 Runner。系统会默认选中上次授权成功且在线的环境。
- 成员授权(密钥):点击 填密钥 或 更新密钥。
- 撤销:删除您保存的凭证。
改连接目的地时已存的密钥不会跟过去
保存时改动传输方式、命令、参数或端点(URL)中的任意一项,就算换了连接目的地。参数按列表内容比较,内容没变不算改动。此时已存的共享凭证不会带到新目的地:环境变量与 Headers 里受保护的值(键名规则见上文认证),必须在同一次编辑里重新以明文填写。留空、不填或把掩码原样提交都会被拒绝,页面显示下面的错误,并列出涉及的键名:受保护的值怎么显示
受保护的值(环境变量与 Headers 里键名符合上述规则的那些)读取时一律显示为固定的掩码****,不保留任何首尾字符;把 **** 原样提交表示保留已存的值。只能查看、不能编辑的成员看到的连接配置更少:参数完全不返回,端点(以及通过 API 设置的代理地址)会去掉其中的 用户名:密码,并把查询串里每个参数的值替换成 ****,端点无法解析时留空。有编辑权限的成员看到的是原样的端点与参数。
管理与检视
MCP 列表显示您添加的每台服务器的名称与描述、范围(共享或团队)、传输方式和启用状态。可以按“全部 / 共享 / 团队”筛选,并按名称、描述、传输方式或 URL 搜索。内置的 Flashduty MCP 服务器不在此列表中。启用 / 禁用
启用 / 禁用
用列表里的开关切换。只有已启用的服务器才会对 Agent 可见;禁用后 Agent 看不到、也无法调用它。已停用的连接器不能在 连接 入口中使用,也不会出现在 插件 → 概览 的已启用区,需要账户所有者或管理员在 插件 → MCP 中重新启用。
编辑
编辑
点击编辑按钮(或直接点击行)打开表单,可修改名称、传输方式、描述、端点 / 命令、授权模式与作用域。无编辑权限时表单以只读模式打开,并提示原因。
删除
删除
将 MCP 服务器从当前范围移除。依赖它的 Agent 将无法再访问其工具,正在使用它的活跃会话会随之失败。此操作有确认提示。
检视:查看某台服务器暴露的工具
控制台不展示 MCP 服务器的工具列表,因为同一台服务器在不同运行环境中的可达性和工具可能不同。Agent 读取 Flashduty 故障、告警等数据的能力是内置的(Flashduty MCP 服务器),默认可用,不需要也不能在此配置。
跨环境连接器
MCP 服务器可能绑定在当前会话之外的执行环境中。由于不同环境的网络不互通,会话不能直接调用它,但 Agent 知道它的存在:- Agent 能看到这类连接器的名称、用途和可用环境,按名字询问时也会得到说明,而不是“找不到”。
- Agent 会派一个子代理到目标环境中调用它(见 Agent),再把结果带回当前对话。
- 可派往账户级 Runner、当前会话所绑定团队的 Runner,以及绑定的云端环境。曾连接过的 Runner(含当前离线的)都在候选里,从未连接的 Runner 不在;离线 Runner 要到派发时才会报该环境不可用的原因。
- 只有主会话能这样派发,子代理不能再派发。
作用域
MCP 与其他资源共用同一套两级作用域(共享 / 团队),通用规则见作用域与权限。MCP 特有的几点:- 从市场安装的服务器固定为共享范围,任何成员都可以安装,且不能改为团队范围。
- 成员授权模式下还需要填写自定义地址的模板,只有账户所有者或管理员能安装,以免其他成员的凭证被发往安装者指定的地址。
相关页面
Skill
Skill 在 SKILL.md 中以
mcp:服务名/工具名 调用 MCP 提供的工具。Agent
Agent 与 MCP 共用同一套授权模式与作用域模型。
BYOC
stdio MCP 服务器需运行在 BYOC Runner 上;了解云 Sandbox 与自托管运行环境的区别。
控制台对话
在会话中观察 Agent 如何检视并调用 MCP 工具。
Flashduty MCP Server(开发者)
方向相反的能力:把 Flashduty 接入第三方 AI 客户端的官方 MCP 服务。