管理 MCP 服务器
MCP 页面管理本地配置库，并可把受支持的服务器配置应用到已检测到的本机 Agent。 勾选某个 Agent 表示配置已写入，不代表 MCP 服务器已启动或工具可用。 运行时、命令和凭据等仍需按服务器要求准备。
添加并应用 MCP
- 在桌面端侧栏打开 MCP。若尚未检测到受支持的 Agent，仍可将配置保存在本地库中；先到 Agent 管理检查本机 Agent。
- 选择 添加 MCP，填写标识和显示名称。选择连接方式：本地命令（stdio）、HTTP 或 SSE。传输方式是否受支持取决于目标 Agent；Codex、Grok Build 和 Pi 不支持 SSE，请对这些 Agent 使用 Streamable HTTP。
- 对本地命令，填写已安装的可执行命令、每行一个的参数、可选工作目录和所需环境变量。对 HTTP 或 SSE，填写 URL 和需要的请求头。也可切换到 编辑 JSON。模板只填写配置内容，不会安装服务器或依赖。
- 选择要应用到的 Agent。全部不选表示仅保存到本地库。按每个目标 Agent 检查路径、命令、参数和传输方式是否兼容，并遵循客户端显示的兼容性结果；对环境变量、URL 与请求头中的凭据也逐项核对。
- 选择 预览变更，检查将写入哪些 Agent，再确认应用。成功后，MCP 表格中相应 Agent 显示 已配置；如目标 Agent 尚未加载新配置，按需重启它。
- 在目标 Agent 中调用 MCP 提供的工具，确认服务器正常响应。返回 MCP 页面看到 已配置 仅说明配置已写入，不是连通性测试。
导入现有配置
从 Agent 导入：选择 导入，在检测到的 Agent 项下勾选现有条目，然后选择 预览导入。这一步读取现有配置；导入本地库后，仍需选择目标 Agent 并预览应用，才会由 Lumoswitch 管理。导入窗口会标出已经在库中的条目。
粘贴配置：选择 粘贴配置，粘贴 JSON、Codex TOML 或 OpenCode 配置。检查识别到的条目，逐项选择要导入的项目；同名项目会替换本地库条目，Agent 文件不会因此自动覆盖。你也可以在此处选定 Agent 一并应用。Agent 专用字段无法通过此导入流程覆盖，请回原 Agent 修改。
打开 lumoswitch-mcp: 导入链接时，客户端会把配置放入粘贴导入流程；仍需检查要导入的条目和目标 Agent，再预览并确认。
编辑、启用和停用
- 在列表选择 MCP 名称可编辑配置。可按 Agent 勾选启用，也可点击 Agent 列标题批量管理当前列表范围；若正在搜索或筛选，批量操作只作用于当前结果。
- 绿色勾选代表受管理的配置已写入。红色或冲突状态表示有更新待同步或同名配置冲突；暂不兼容、只读或无法解析的目标不能安全写入。打开条目查看具体提示和路径。
- 停用会移除 Lumoswitch 管理的连接；从资料库删除只删本地库条目，保留 Agent 配置；从所有受管 Agent 移除会删除这些 Agent 中受管理的连接。确认前先检查操作名称和目标。
- 如操作结果有失败项，可从结果面板检查错误并重试失败项；有 撤销 操作时，可使用该按钮恢复本次变更。
凭据与常见问题
- 输入的环境变量和请求头值默认隐藏。已有凭据不会回显明文；切换 JSON 编辑时敏感值也会被遮罩。除非确实需要，不要显示、复制或分享包含真实凭据的配置。
- MCP 使用的本地命令必须已安装，且在目标 Agent 的运行环境中可执行。HTTP/SSE 服务器则必须可从该 Agent 访问。Lumoswitch 保存并应用配置，不负责安装所有外部程序或服务器依赖。
- 目标显示只读或报错：展开目标提示检查配置路径、版本或自定义目录。先在 Agent 管理中重新检测；不要直接覆盖含有外部修改或冲突的文件。
- 导入没有条目：检查格式是否为 JSON、Codex TOML 或 OpenCode 配置，并确认其中含有效 MCP 项。部分 Agent 专用配置需要回原 Agent 编辑。
- 显示已配置但工具不可用：逐项检查命令、参数、工作目录、URL、请求头和环境变量是否正确，确认服务器本身已安装并可访问；再按需重启 Agent，并在 Agent 中实际调用该工具。
- 本地库配置不会自动写入 Agent：保存时未勾选目标 Agent，就只会留在本地库。重新编辑或使用批量管理操作应用到目标。