Z Tag
管理组织服务与凭证配置

Linear

获取 Linear personal API key。

适用于组织 Owner / Admin;成员的个人连接器同样适用

在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 Linear,使用 推荐配置。

获取与填写凭证

  1. 在 Linear 个人设置的 Security & access 中创建 Personal API key。
  2. 按需要选择权限与可访问的团队。
  3. 将 Key 原样填入 API Key;推荐配置会把它直接放进 Authorization 请求头,不添加 Bearer 前缀。

官方说明:Linear API 入门。

服务地址

推荐配置固定使用 https://api.linear.app,GraphQL API 在 /graphql;其他地址改用 自定义。

请求头

推荐配置固定使用 Authorization 请求头,只需填写值。切换到 自定义 后,在 自定义请求头 中填写名称和值:名称可以从提示的常见名称里选择,也可以自己输入。替换凭证时只需重新填写值,请求头名称保持不变。

验证

保存后请 ZAI 用 GraphQL 查询一次当前用户({ viewer { id name } }),确认凭证可用;Key 没有目标团队的访问权限时,查询该团队的数据会失败。其余排查见验证与排错。

本页目录