# 连接数据源

让 MATLOOK Agent 使用指定本地目录、API 或 MCP 服务，明确每个连接的用途。

更新于: 2026-10-11
Desktop 0.5.0-rc.45 · Web 0.5.0-rc.45
Canonical: https://ai.z-group.cn/docs/zh/sources/

## 从后台资源库选择 MCP 或 API（桌面 RC45 起）
打开“设置 → 资源库与技能市场 → 浏览资源库”，选择 MCP 或 API，点击“查看”核对服务地址、认证方式、使用说明。确认后添加到当前工作区，再到数据源详情配置自己的凭据并测试连接。同名本地数据源会保留。
管理员只发布模板，不提供共享密钥。不要将密钥粘贴在模板正文、地址或命令参数中。HTTP/SSE MCP 需要可访问的服务；本地 stdio MCP 在使用时启动预览中的程序，用户电脑必须已安装该程序。资源模板不自动安装第三方 MCP 程序。
资源更新或下架后，旧预览可能无法添加，刷新列表再选择。下架不会删除已添加的数据源。原有手动添加 API、MCP 和本地资料的入口继续可用。

## 选择数据源类型
| 类型 | 常见用途 | 开始前准备 |
|---|---|---|
| 本地文件夹 | 厂家样册、报价和项目档案 | 执行端上可访问的目录 |
| API | 企业材料库、业务系统或通知接口 | 地址、鉴权、接口说明 |
| MCP | 提供工具的本地或远程服务 | 服务启动方式或地址、认证及工具清单 |
## 添加与使用
1. 在功能栏打开“数据源”，选择对应类型并添加。
2. 填写准确名称和用途说明，例如“演示酒店资料，只用于查询”。
3. 配置连接并检查状态；API 和 MCP 先做低影响的查询测试。
4. 在会话中选择需要的数据源，并在任务里说明要读取什么。
5. 检查工具结果是否来自指定源，而非依赖模型记忆。
## 本地目录的边界
添加目录不等于把整个目录上传云端。通过在线模型分析时，实际送入模型的内容会使用该连接。远程读取必须依赖目标电脑上有效的路径。
## 连接失败时
检查地址、启动命令、网络、凭据和工具权限；网页可能没有桌面原生目录入口。不要把鉴权密钥、含令牌的 URL 或私有样册放进公开反馈。
## 预期结果
能通过选定数据源读取一个已知条目，并辨认来源。数据源连接成功，不表示它获得了所有工作区或全部接口的权限。