管理组织服务与凭证配置
Linear
获取 Linear personal API key。
适用于组织 Owner / Admin;成员的个人连接器同样适用
在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 Linear,使用 推荐配置。
获取与填写凭证
- 在 Linear 个人设置的 Security & access 中创建 Personal API key。
- 按需要选择权限与可访问的团队。
- 将 Key 原样填入 API Key;推荐配置会把它直接放进
Authorization请求头,不添加 Bearer 前缀。
官方说明:Linear API 入门。
服务地址
推荐配置固定使用 https://api.linear.app,GraphQL API 在 /graphql;其他地址改用 自定义。
请求头
推荐配置固定使用 Authorization 请求头,只需填写值。切换到 自定义 后,在 自定义请求头 中填写名称和值:名称可以从提示的常见名称里选择,也可以自己输入。替换凭证时只需重新填写值,请求头名称保持不变。
验证
保存后请 ZAI 用 GraphQL 查询一次当前用户({ viewer { id name } }),确认凭证可用;Key 没有目标团队的访问权限时,查询该团队的数据会失败。其余排查见验证与排错。