跳转到主要内容

概述

MCP(Model Context Protocol)让 AI SRE Agent 接入外部工具与数据源。每台 MCP 服务器是一个对外暴露一组工具(函数)的标准化端点,例如查询 GitHub Issue、向 Slack 发消息、读取 Kubernetes 资源、检索可观测平台指标等。 在控制台里配置好 MCP 服务器并启用后,Agent 会在排障故障时自主判断何时需要外部能力,并直接调用对应工具,无需您手工搬运数据。
本页讲的是 AI SRE 控制台里的“MCP”——也就是Agent 去调用的第三方 MCP 服务器(您把外部工具接进来给 Agent 用)。这与开发者文档里的 Flashduty MCP Server 是两回事:后者是 Flashduty 自家对外暴露的 MCP 服务,供您把 Flashduty 的能力接入到第三方 AI 客户端(如 Claude、Cursor)。一个是“Agent 调外部”,一个是“外部调 Flashduty”,方向相反,不要混淆。

什么是 MCP

MCP(Model Context Protocol,模型上下文协议)是一套开放协议,用统一的方式描述“一台服务器对外提供哪些工具、每个工具接收什么参数、返回什么结果”。任何遵循 MCP 的服务器,Agent 都能直接发现和调用,无需为每个外部系统单独写适配代码。 在 AI SRE 中,MCP 的作用是把 Agent 的能力从“内置工具”扩展到“任意外部系统”:
  • 您在控制台添加一台 MCP 服务器(声明它的端点、传输方式与认证)。
  • 会话开始时,已启用且在当前作用域可见的服务器即对 Agent 可见、可调用。
  • Agent 在需要时即可发现该服务器提供的工具并直接调用。
MCP 与 Skill 的区别:MCP 提供外部工具的接入能力,Skill 提供如何编排这些工具完成一类任务的方法论。Skill 可以在 SKILL.md 中以 mcp:服务名/工具名 的形式声明它需要哪台 MCP 服务器的哪个工具。详见 Skill。

从市场安装 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 编辑。如果账户中已有同名连接器,请直接使用它,或由账户所有者或管理员改名或删除后再连接。
从市场安装的 MCP 服务器会记录来源模板,固定为共享范围(账户内所有成员可用)。同一模板在一个账户内只能安装一次。
需要 BYOC Runner 的模板(通过 uvx / npx 在本地启动的 stdio 类型)只能在您自己部署的 Runner 上使用,云 Sandbox 不支持。安装前请确认账户已有可用的 BYOC Runner,目录中每个模板都会标注是否需要,详见 运行环境(BYOC)。

只能由 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 询问您要接入自己的服务还是安装现成的,先查插件目录,没有再联网搜索候选供您选择。只有在能确定写入范围时(您有账户级权限,或当前只选中了一个您所属的团队)才显示此按钮。
列表为空且没有在搜索时,页面显示“插件目录里有 N 个预置 MCP,安装后即可在会话中使用。”,并在有创建权限时给出 浏览预置 MCP 按钮直接跳转;插件目录为空或正在搜索时,仍显示“尚未配置 MCP 服务器。点击上方按钮添加。”

基础字段

Agent 首次列出某服务器的工具后,系统会自动生成一段 AI 描述 显示在列表中,并随工具变化自动更新。

传输方式

stdio 仅适用于 BYOC 运行环境(Runner 部署在您自己的机器上)。云 Sandbox 不能启动本地子进程;如果使用云端运行环境,请改用 HTTP 流式或 SSE,并确保该 MCP 服务器对 Sandbox 网络可达。运行环境的区别见 运行环境(BYOC)。
stdio 命令在 Runner 所在机器上运行,而不是您的电脑。不要使用个人路径(如 /Users/<用户名>/...),并确保 Runner 上已安装所需的运行时(如 uv / uvx / node / npx),否则连接会失败。
连接与调用各有一个默认超时:连接超时默认 10 秒,工具调用超时默认 60 秒。
只有当 HTTPS 服务器使用自签证书、且网络环境受控时,才开启“跳过 TLS 证书校验”。不要对公网上不可信的端点开启。

认证

MCP 服务器支持三种授权模式,决定凭证如何提供给服务器:
所有会话以同一个服务身份调用。凭证直接写在服务器配置里——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 里受保护的值(键名规则见上文认证),必须在同一次编辑里重新以明文填写。留空、不填或把掩码原样提交都会被拒绝,页面显示下面的错误,并列出涉及的键名:
同一次编辑还会撤销这台服务器的全部成员凭证:成员授权(密钥)要重新填密钥,成员授权(OAuth)要重新授权。撤销在保存之前执行,因此即使这次保存最终失败,成员也可能要重新授权一次。通过 API 只替换 OAuth 元数据(指向令牌端点的那个值)时,不需要重填共享凭证,但成员凭证同样会被撤销;把它清空只会按原端点重新发现,不撤销任何凭证。

受保护的值怎么显示

受保护的值(环境变量与 Headers 里键名符合上述规则的那些)读取时一律显示为固定的掩码 ****,不保留任何首尾字符;把 **** 原样提交表示保留已存的值。只能查看、不能编辑的成员看到的连接配置更少:参数完全不返回,端点(以及通过 API 设置的代理地址)会去掉其中的 用户名:密码,并把查询串里每个参数的值替换成 ****,端点无法解析时留空。有编辑权限的成员看到的是原样的端点与参数。

管理与检视

MCP 列表显示您添加的每台服务器的名称与描述、范围(共享或团队)、传输方式和启用状态。可以按“全部 / 共享 / 团队”筛选,并按名称、描述、传输方式或 URL 搜索。内置的 Flashduty MCP 服务器不在此列表中。
用列表里的开关切换。只有已启用的服务器才会对 Agent 可见;禁用后 Agent 看不到、也无法调用它。已停用的连接器不能在 连接 入口中使用,也不会出现在 插件 → 概览 的已启用区,需要账户所有者或管理员在 插件 → MCP 中重新启用。
点击编辑按钮(或直接点击行)打开表单,可修改名称、传输方式、描述、端点 / 命令、授权模式与作用域。无编辑权限时表单以只读模式打开,并提示原因。
将 MCP 服务器从当前范围移除。依赖它的 Agent 将无法再访问其工具,正在使用它的活跃会话会随之失败。此操作有确认提示。

检视:查看某台服务器暴露的工具

控制台不展示 MCP 服务器的工具列表,因为同一台服务器在不同运行环境中的可达性和工具可能不同。
想确认某台 MCP 服务器在某个运行环境下实际暴露了哪些工具,最直接的方式是在对话里让 Agent 列出该服务器的工具,它会把工具清单与每个工具的用法列出来。详见 对话。
Agent 读取 Flashduty 故障、告警等数据的能力是内置的(Flashduty MCP 服务器),默认可用,不需要也不能在此配置。

跨环境连接器

MCP 服务器可能绑定在当前会话之外的执行环境中。由于不同环境的网络不互通,会话不能直接调用它,但 Agent 知道它的存在:
  • Agent 能看到这类连接器的名称、用途和可用环境,按名字询问时也会得到说明,而不是“找不到”。
  • Agent 会派一个子代理到目标环境中调用它(见 Agent),再把结果带回当前对话。
  • 可派往账户级 Runner、当前会话所绑定团队的 Runner,以及绑定的云端环境。曾连接过的 Runner(含当前离线的)都在候选里,从未连接的 Runner 不在;离线 Runner 要到派发时才会报该环境不可用的原因。
  • 只有主会话能这样派发,子代理不能再派发。
在当前环境里直接可用,把它加进该服务器的“执行环境”列表即可(前提是它对这个会话可达)。运行环境本身的区别见 运行环境(BYOC)。

作用域

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 服务。