工具与扩展
工具与技能
工具提供可调用能力，技能说明某类任务的执行方法。
本页内容
先明确需要什么
MCP 连接用于向智能体提供工具和资料；技能通常说明一类工作的方法和约束。安装技能说明，不意味着它依赖的外部程序或服务已经可用。
使用之前先确认能力来源、访问范围，以及是否需要额外账户或本地依赖。
本地 MCP 服务
27.8 的“本地 MCP 服务”配置用于已安装的本地科学工具。它不是任意远程 MCP 地址的通用配置框。
按该工具的安装要求准备本机运行环境。
打开本地 MCP 配置，启用服务并选择所需的程序和仓库目录。
保存配置。
新启动智能体运行时后再测试工具是否出现。
配置保存后，正在运行的会话不会自动切换到新连接。本地工具会接触其获准访问的文件，应只配置可信来源。
技能与故障检查
在技能页面查看已安装内容和可用状态。遇到失败时，先区分是工具未注册、依赖未准备、连接失败，还是输入内容不符合要求，再按对应提示处理。
公开手册 MCP 的接入由客户端版本决定，本页不把规划中的自动连接写成 27.8 已有设置入口。用户始终可以在浏览器阅读本手册。
保存后做一次最小验证
完成配置并新启动运行时后，先发起一个范围小、无需修改数据的任务，检查工具是否可发现、能否返回预期类型的信息。确认连接工作，再把真实任务交给它。
不要一开始就用长任务判断连接是否成功。连接成功也不表示所有工具都有权限，具体能力还要按服务的访问范围核对。
按失败位置处理
| 表现 | 优先检查 |
|---|---|
| 找不到工具 | 服务是否启用，配置是否保存，是否启动了新的运行时 |
| 启动失败 | 程序路径、仓库目录和本地依赖是否准备好 |
| 返回权限错误 | 服务账户和访问范围是否符合任务 |
| 输入被拒绝 | 文件位置、参数和工具要求是否匹配 |
| 有返回但没有所需结果 | 该工具是否适合这类任务，是否还缺后续步骤 |
反馈时提供服务名称、失败阶段和经过脱敏的错误。密钥等配置通过对应受保护入口提供，不放入普通任务对话。