连接器
连接远程 MCP 服务器，让审查和任务能够查证仅凭代码看不出的信息：某个功能的使用情况、日志内容、表中的数据，或某个库的文档。 付费套餐包含连接器。
添加连接器
只有 GitHub 组织所有者或个人账号的所有者才能管理连接器。工作区设置 → 成员中会将他们标记为 GitHub 所有者或账号所有者。
使用免费套餐时（包括付费套餐结束后），审查和任务不会使用已保存的连接器，你只能删除它们。
- 打开工作区设置 → 连接器，选择添加连接器。
- 输入名称、服务器的 HTTPS 端点及其所需的请求头，然后选择加载工具。
- 选择要允许的工具、适用的仓库，以及连接器的使用范围。
- 选择保存连接器。此后发起的审查和任务即可使用它。
| 字段 | 填写内容 |
|---|---|
| 名称 | 连接器提供的内容，例如“生产环境分析数据”。 |
| HTTPS 端点 | 服务器的 Streamable HTTP 地址，例如 https://mcp.your-service.com/mcp。 |
| 请求头 | 服务器所需的凭据，例如 Authorization: Bearer <token>。值会加密存储，且不会再次显示。 |
| 给 HeyDeer 的说明 | 可选：连接器提供哪些内容，以及何时有用。 |
编辑连接器时，请求头的值留空即可保留已保存的值。如果更改了端点，需要重新输入所有值。
端点和请求头要求
- 端点不能包含查询字符串、
#片段、用户名或密码，也不能使用 443 以外的端口。 - 端点必须使用公共域名，不能是 IP 地址，也不能是以
.local、.internal、.test、.invalid、.example或localhost结尾的名称。 - 每个连接器最多可设置 10 个请求头，每个值最多 8,192 个可打印 ASCII 字符。
- 每个工作区最多可添加 50 个连接器。
工具
只读工具列出服务器标记为只读的工具。其他所有工具，包括服务器未标记的工具，都归入其他工具。首次加载工具时，只允许只读工具。
| 运行类型 | 可调用的工具 |
|---|---|
| 审查和 Autopilot | 已允许的只读工具 |
| “用 HeyDeer 修复”和 @heydeer 提及 | 所有已允许的工具，无论是只读还是其他 |
智能体只能调用已允许的工具，并自行判断何时需要调用。如果服务器的工具有变化，请选择重新加载工具。
连接器的使用范围
连接器可以应用于所有仓库，或仅应用于你选择的仓库。涉及多个仓库的任务会获得其中任一仓库的连接器。
默认情况下，连接器只在私有仓库中、且变更来自拥有写权限的人时使用。出现以下情况时，审查或任务不会使用它：
- 仓库是公开的，或任务可以更改某个公开仓库；
- PR 来自 fork；
- PR 的作者没有该仓库的写权限。
只有当连接器的数据可以公开给任何人（例如公开文档）时，才选择也包括公开仓库和 fork。审查或任务页面会显示哪些连接器未被使用及原因。
连接器调用
审查或任务页面会列出每次连接器调用：连接器、工具、调用时间、耗时以及是否失败。HeyDeer 不会保留发送或返回的内容。
工具调用及其返回的文本都属于工作的一部分，因此会计入积分消耗。如果审查在调用连接器后失败，其积分不会退回。参见积分如何计费。
隐私与信任
智能体永远看不到请求头的值：HeyDeer 的沙箱会在智能体的请求发出时加上它们。
请求可能包含代码和任务上下文，服务器的运营方会按其自身政策处理这些内容。即使是只读工具也可能返回私有数据，因此请只连接你信任的服务，使用权限不超出所需的凭据（例如只读数据库角色），并只允许你需要的工具。参见安全。
如果 HeyDeer 无法加载连接器的工具，参见故障排除。