添加 MCP 与 Skill

需要让 Agent 连接额外工具或服务时，可以添加 MCP 服务器；需要复用一套工作方法时，可以添加 Skill。它们由 Noea 统一管理，供不同 Agent 的普通对话使用。

这些扩展不是开始使用 Noea 的必需条件。解释和整理任务不使用这里添加的扩展。

选择适合的扩展

一个服务器是否能被某个 Agent 使用，还取决于该 Agent 支持的连接方式。Skill 的可用命令也以对话中的实际列表为准。

添加 MCP 服务器

打开“设置 → MCP 服务器”，点击“添加服务器…”，填写名称并选择连接方式。

• stdio：在本机启动服务。填写启动命令、参数和需要的环境变量，参数每行一个。
• HTTP：通过地址连接服务。填写服务器地址及需要的请求头。

如果服务提供方给出了兼容的 JSON 配置，也可以使用“粘贴 JSON”填入表单。保存前检查命令、地址和认证项是否与你使用的服务一致。

服务器名称不区分大小写且必须唯一；以 noea 开头的名称留给 Noea。列表第一行是内置 Noea 服务器，始终启用，不能删除。

测试连接

在服务器编辑面板点击“测试连接”，会使用表单中当前填写的值；在列表中测试，则使用已经保存的配置。

成功后显示工具数量和名称。失败时会说明停在哪一步，例如找不到命令、进程退出、超时、服务器拒绝请求或握手失败。HTTP 服务显示“需要授权”时，按对应 Agent 的授权流程继续处理。

测试通过说明这份配置能建立连接，不保证所有 Agent 都支持它。测试结果也不会自动为对话启用该服务器。

为对话启用服务器

服务器列表中的“新对话默认启用”决定新对话的默认选择。你也可以在对话的配置菜单中选择本次使用的 MCP 服务器。

选择会随对话保存。修改配置后，已连接的 Agent 不会立即加载新配置，要等下次重新连接时才生效。需要使用新配置时，可以新建对话并检查服务器选择。

菜单会标出不可用的原因，例如缺少环境变量或 Agent 不支持连接方式。

使用环境变量

环境变量和请求头的值支持 ${VAR} 写法，用来引用 Noea 运行环境中的变量。连接时会读取这些值，配置后可用“测试连接”检查是否可用。仅在某个终端中执行过 export，并不保证已经运行的 Noea 获得了该值。

字段默认隐藏具体值，点击后可以显示。隐藏只是防止值直接出现在界面上，不影响配置的保存和使用。

添加 Skill

打开“设置 → Skill”，点击“添加 Skill…”，选择一个包含 SKILL.md 的文件夹。格式不符合要求时，界面会说明原因。

添加后，Skill 出现在 Noea 的库中，新增和删除都在新对话中生效。可以在文件管理器中查看它；删除时移除 Noea 库中的副本，不影响最初选择的来源文件夹。

同一页面也只读展示从 Agent 目录发现的用户级和项目级 Skill。可以查看位置，或选择“复制到 Noea”。这里不会列出所有 Agent 内置或插件附带的 Skill。

在对话中使用

新建对话，在输入框开头输入 /，查看“Noea 的 skill”和“Agent 命令”。选择可用项，再补充当前任务的要求并发送。

如果扩展没有出现，先检查是否新建了对话、当前 Agent 是否支持，再看故障排查。