大模型应用
在 Copilot 工作流中需要 Fusion 感知的…
当用户询问 Fusion MCP 是什么、如何配置、如何验证或为何失败时,用托管生产服务器 + VS Code/Entra 认证路径引导其完成设置。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
在 Copilot 工作流中需要 Fus特定
解决思路
- 在提出设置步骤前,先收集:用户环境(OS、编辑器/运行时)、MCP 将运行的目标客户端(首选/主要目标是 VS Code)、用户是否拥有 Equinor Entra 账号;若缺少这些信息,先用简洁追问补齐。
- 解释 Fusion MCP 提供什么:面向 Fusion 的 MCP 检索与工作流支持能力;作为托管服务提供,大多数开发者不需要本地基础设施;检索工具包括 `search`、`search_framework`、`search_docs`、`search_eds`、`search_indexes`、`search_backend_code`;工具面可能随版本演进。
- 引导用户设置 hosted production server,这是唯一推荐路径:不需要 Docker、不需要 API keys、不需要本地 clone;VS Code 通过 Microsoft Entra(Equinor 账号)认证;使用 prod 的一键安装链接(见 `references/vscode-mcp-config.md`);或按 `references/vscode-mcp-config.md` 用 `"type": "http"` 和 server URL 手动配置;除非用户有明确运维需求,不要建议本地 Docker、GHCR 或自托管替代方案。
- 描述认证流程:首次调用工具时,VS Code 会提示使用 Equinor Entra 账号登录;token 自动管理,尽可能静默续订,需要时弹出交互提示;访问由现有 Fusion role assignments 控制。
- 做轻量 MCP smell test:运行 `initialize` 并确认成功响应;运行 `tools/list` 并确认至少返回一个工具;对一个可用工具运行一次非破坏性的 `tools/call`;通过标准是调用响应非空(`content` 或 `structuredContent` 包含数据);不要硬编码固定工具列表,因为工具清单可能在不同版本间变化。
- 按文档顺序排障:Entra 登录提示未出现 → 验证配置中的 `oauth.clientId`,并确认 VS Code 已用 Equinor 账号登录;出现 `401 Unauthorized` → 通过 VS Code 账号设置重新认证,确保 Equinor Entra 账号处于 active 状态;`tools/list` 返回空或工具调用失败 → 验证 MCP server entry 在 VS Code 中已选择/启用,并在 reload 后重试;工具行为部分异常 → 检查 VS Code Output > Copilot 获取错误详情,并重启 MCP server。
- 当 MCP 设置失败或用户要求提 bug 时,从 `assets/bug-report-template.md` 生成 bug report 草稿:默认目标仓库为 `equinor/fusion-mcp`;包含具体复现步骤、预期与实际行为、已尝试的排障;包含非敏感环境细节(OS、VS Code 版本、MCP server URL、Entra 账号类型);绝不包含 secrets、tokens 或原始凭据值。
- 对不确定或仓库私有约束,明确陈述假设,并链接权威文档,而不是猜测。
- 按期望输出返回:Fusion MCP 的简短说明及其使用时机;针对用户环境定制的 hosted prod 设置步骤;验证清单(运行 `initialize` 预期成功响应,运行 `tools/list` 预期至少一个工具,运行一次 `tools/call` 预期非空 `content` 或 `structuredContent`);按观察到错误症状映射的排障步骤;设置失败/异常或用户要求时,用 `assets/bug-report-template.md` 起草 bug report 且默认目标为 `equinor/fusion-mcp`;用户要求复制/粘贴自动化辅助时提供脚本片段;明确标注假设与缺失信息;链接所用到的精确上游文档。
- Safety & constraints:绝不请求或暴露 secrets、tokens 或 credentials;绝不编造项目文档不支持的设置命令;没有验证输出时绝不声称设置成功;未经用户明确确认绝不运行破坏性命令。
- Safety & constraints:始终优先使用官方仓库文档作为事实来源;始终引导用户使用 hosted production server,不建议本地 Docker 或自托管替代方案;先提供最小权限、最小变更的设置指导;将已确认事实与假设分开。
适用边界 · 注意事项
- 实现与 MCP setup 无关的产品功能。
- 未经用户确认做出破坏性环境变更,或假设不可见的私有仓库细节。
- 在 MCP 已运行后,回答关于 Fusion Framework APIs、EDS components 或 skill catalog 的来源支持问题;这些应改用 `fusion-research`。