自定义 MCP
自定义 MCP 用于给 Luna 接入额外的 Model Context Protocol 服务。新发现的工具默认归入 只读 分类，并为已绑定的应用启用。使用前请根据工具的实际行为，把会修改数据或具有高风险的工具调整到相应分类。分类控制 Soln 的执行策略，不会改变上游工具本身的能力。
打开 Luna，进入 智能体设置 > 自定义 MCP。
添加前须知
- 远程 MCP 需要租户运行环境能访问该地址，先确认网络区域和地址
- 凭据和环境变量加密保存、之后不再回显，安装前请自行留一份
- 只安装可信的 MCP 服务：它的工具会以运行环境的权限执行
添加一个 MCP 连接
- 点击 添加 MCP，选择来源：远程 HTTPS MCP 地址、本地执行命令，或 Docker 镜像；也可以直接粘贴
mcpServersJSON 导入 - 填写配置：
- 远程：名称、描述、HTTPS MCP 地址、网络区域，以及认证方式（Bearer Token 或 API Key Header）
- 本地：名称、描述、执行命令或 Docker 镜像、JSON 数组形式的启动参数、JSON 对象形式的环境变量
- 确认网络与凭据权限后安装。凭据和环境变量加密保存在租户数据库中，安装后不再回显
- 看安装日志：配置已保存 → 启动 MCP Runtime → 同步工具目录 → 激活连接 → 完成或失败
- 打开 管理工具，检查工具名称、描述、分类和启用状态；只有启用的工具才会提供给智能体
- 按需要把连接共享到工作空间或设为私有、绑定/解绑到应用，不再使用时卸载
验证连接
- 等安装日志走到完成步骤
- 打开 管理工具，确认已经发现工具并标出了风险
- 确认启用状态，停用不允许该应用使用的工具，然后在应用的智能体会话里让它调用其中一个；会话会显示工具调用组件和执行结果
- 工具列表不是最新时，确认 MCP 服务可访问后重新同步工具目录
工具管理
左侧菜单包含 全部工具、只读、写入、高风险，不再提供未分类选项。
- 在列表上方按工具名称或描述搜索，按 Enter 执行搜索；清空搜索可恢复列表。
- 点击工具行的 启用 或 停用 文字按钮，调整工具是否提供给智能体。
- 点击工具行查看详情：工具名称、描述、输入 Schema，以及服务提供的输出 Schema。Schema 使用代码面板展示，支持复制。
- 调整分类时，点击目标分类旁的 +。气泡内展示全部工具，并用不同颜色的标签标明分类。支持按 Enter 搜索、多选工具，点击 添加 后将所选工具移入目标分类；点击 关闭 不会应用本次选择。
- 工具分类由 MCP 连接所属应用管理。调整分类不会自动启用已停用的工具。
从含未分类工具的旧版本升级时，数据库迁移会将未由管理员指定分类的工具归入只读，保留管理员明确指定的分类，并为启用中的绑定补充默认启用的工具选择。已有的停用选择保持停用。
卸载
卸载会把连接从应用中移除。共享到工作空间的连接，在被其他应用绑定时无法卸载，需要先在其他应用解绑。
常见问题
| 现象 | 检查方向 |
|---|---|
导入 mcpServers JSON 报错 | JSON 必须包含 mcpServers 对象且只能有一个服务；args 必须是字符串数组，env 必须是字符串对象；远程导入只支持一个 Bearer 或 API Key Header |
| 安装失败 | 打开安装日志看失败在哪一步，再修正地址、凭据或命令 |
| 工具目录不更新 | 重新同步工具目录，并确认运行环境能访问该 MCP 服务 |
| 操作等待超时 | 安装和工具操作会直接访问该 MCP 服务，确认上游服务正常后重试 |