首页 专区 Skill 文章 专题 AI工具 学习 编程手册

PHP MySQL jquery HTML CSS
首页 > Skill > 知识管理

Linear

Polar Sponsor
爱发电 赞助
.NET 9.0
立即下载

通过托管OAuth实现Linear API集成，使用GraphQL查询和管理问题、项目、团队、周期及标签。适用于需要创建、更新或查询Linear问题、搜索任务、管理项目或跟踪工作等场景；其他第三方应用请使用api-gateway技能。

使用管理 OAuth 认证访问线性 API

功能概述

使用管理 OAuth 认证访问线性 API是一项面向实际任务的技能，主要用于使用 GraphQL.；QQQQQQQQQQQQQQQQQQQQQQQQQQQQLTHLAGE :CLI: .；

核心要点

  • Python: . .；
  • Base URL. 所有请求。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

使用与执行

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Linear

通过受管 OAuth 认证访问 Linear API。使用 GraphQL 查询和管理 issue、项目（projects）、团队（teams）、迭代周期（cycles）、标签（labels）及评论（comments）。

快速开始

CLI：

maton linear issue list -c ABC -L 10

maton api '/linear/graphql'

Python：

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'query': '{ viewer { id name email } }'}).encode()
req = urllib.request.Request('https://api.maton.ai/linear/graphql', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

基础 URL

https://api.maton.ai/linear/graphql

所有请求均以 POST 方式发送至 GraphQL 端点。Maton 将请求代理至 api.linear.app，并自动注入您的 OAuth Token。

安装

NPM：

npm install -g @maton/cli

Homebrew：

brew install maton-ai/cli/maton

认证

CLI：

maton login                          # 在浏览器中打开以获取 API 密钥
maton login --interactive            # 跳过浏览器，直接粘贴 API 密钥
maton whoami                         # 显示当前认证状态

手动配置：

  1. 在 maton.ai 登录或注册账户
  2. 访问 maton.ai/settings
  3. 复制您的 API 密钥
  4. 将 API 密钥设为环境变量 MATON_API_KEY：
export MATON_API_KEY="YOUR_API_KEY"

连接管理

您可在 https://api.maton.ai 管理 Linear 的 OAuth 连接。

列出连接

CLI：

maton connection list linear --status ACTIVE

maton api -X GET /connections -f app=linear -f status=ACTIVE

Python：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=linear&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建连接

CLI：

maton connection create linear

maton api /connections -f app=linear

Python：

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'linear'}).encode()
req = urllib.request.Request('https://api.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

获取连接详情

CLI：

maton connection view {connection_id}

maton api /connections/{connection_id}

Python：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应示例：

{
  "connection": {
    "connection_id": "{connection_id}",
    "status": "ACTIVE",
    "creation_time": "2026-02-04T23:03:22.676001Z",
    "last_updated_time": "2026-02-04T23:03:51.239577Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "linear",
    "metadata": {}
  }
}

在浏览器中打开返回的 url 以完成 OAuth 授权流程。

删除连接

CLI：

maton connection delete {connection_id}

maton api -X DELETE /connections/{connection_id}

Python：

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

指定连接

若您拥有多个 Linear 连接，请显式指定要使用的连接：

CLI：

maton linear issue list -c ABC --connection {connection_id}

maton api /linear/graphql --connection {connection_id}

Python：

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'query': '{ viewer { id name } }'}).encode()
req = urllib.request.Request('https://api.maton.ai/linear/graphql', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
req.add_header('Maton-Connection', '{connection_id}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

若存在多个连接，请始终明确指定连接 ID，以确保请求路由到目标 Linear 账户。

安全与权限

  • 访问范围限定于已连接 Linear 账户内的 issues、projects、teams、cycles 和 comments。
  • 所有写操作均需用户显式授权。 在执行任何创建（create）、更新（update）或删除（delete）调用前，必须向用户确认目标资源及其预期影响。

API 参考

Linear 使用 GraphQL API。所有操作均以 POST 请求形式发送，请求体为 JSON 格式，且必须包含 query 字段。

Viewer（当前用户）

POST /linear/graphql
Content-Type: application/json

{"query": "{ viewer { id name email } }"}

示例：

maton linear whoami

组织（Organization）

POST /linear/graphql
Content-Type: application/json

{"query": "{ organization { id name urlKey } }"}

示例：

maton linear org view

团队（Teams）

列出团队

POST /linear/graphql
Content-Type: application/json

{"query": "{ teams { nodes { id name key } } }"}

示例：

maton linear team list

获取单个团队

POST /linear/graphql
Content-Type: application/json

{"query": "{ team(id: \"ABC\") { id name key issues { nodes { id identifier title } } } }"}

示例：

maton linear team view ABC

Issues

列出 Issues

POST /linear/graphql
Content-Type: application/json

{"query": "{ issues(first: 10, filter: { team: { key: { eq: \"ABC\" } } }) { nodes { id identifier title state { name } priority createdAt } pageInfo { hasNextPage endCursor } } }"}

示例：

maton linear issue list -c ABC -L 10

通过 ID 或 Identifier 获取 Issue

POST /linear/graphql
Content-Type: application/json

{"query": "{ issue(id: \"ABC-123\") { id identifier title description state { name } priority assignee { name } team { key name } createdAt updatedAt } }"}

示例：

maton linear issue view ABC-123

过滤 Issues

按工作流状态类型（state type）过滤：

POST /linear/graphql
Content-Type: application/json

{"query": "{ issues(first: 10, filter: { state: { type: { eq: \"started\" } } }) { nodes { id identifier title state { name type } } } }"}

示例：

maton linear issue list --state started -L 10

按标题（title）过滤：

POST /linear/graphql
Content-Type: application/json

{"query": "{ issues(first: 10, filter: { title: { containsIgnoreCase: \"bug\" } }) { nodes { id identifier title } } }"}

示例：

maton linear issue list --title bug -L 10

搜索 Issues

POST /linear/graphql
Content-Type: application/json

{"query": "{ searchIssues(first: 10, term: \"shopify\") { nodes { id identifier title } } }"}

示例：

maton linear issue search shopify -L 10

创建 Issue

POST /linear/graphql
Content-Type: application/json

{"query": "mutation { issueCreate(input: { teamId: \"TEAM_ID\", title: \"New issue title\" }) { success issue { id identifier title state { name } } } }"}

示例：

maton linear issue create --team-id TEAM_ID -t 'New issue title'

更新 Issue

POST /linear/graphql
Content-Type: application/json

{"query": "mutation { issueUpdate(id: \"ABC-123\", input: { title: \"Updated title\", priority: 2 }) { success issue { id identifier title priority } } }"}

示例：

maton linear issue update ABC-123 -t 'Updated title' --priority 2

Projects（项目）

列出 Projects

POST /linear/graphql
Content-Type: application/json

{"query": "{ projects(first: 10) { nodes { id name state createdAt } } }"}

示例：

maton linear project list

Cycles（迭代周期）

列出 Cycles

POST /linear/graphql
Content-Type: application/json

{"query": "{ cycles(first: 10) { nodes { id name number startsAt endsAt } } }"}

示例：

maton linear cycle list

Labels（标签）

列出 Labels

POST /linear/graphql
Content-Type: application/json

{"query": "{ issueLabels(first: 20) { nodes { id name color } } }"}

示例：

maton linear label list

Workflow States（工作流状态）

POST /linear/graphql
Content-Type: application/json

{"query": "{ workflowStates(first: 20) { nodes { id name type team { key } } } }"}

示例：

maton linear state list

Users（用户）

POST /linear/graphql
Content-Type: application/json

{"query": "{ users(first: 20) { nodes { id name email active } } }"}

示例：

maton linear user list

Comments（评论）

列出 Comments

POST /linear/graphql
Content-Type: application/json

{"query": "{ issue(id: \"ABC-123\") { comments(first: 10) { nodes { id body createdAt user { name } } } } }"}

示例：

maton linear comment list --issue ABC-123 -L 10

创建 Comment

POST /linear/graphql
Content-Type: application/json

{"query": "mutation { commentCreate(input: { issueId: \"ABC-123\", body: \"Looking into this\" }) { success comment { id body } } }"}

示例：

maton linear comment create --issue ABC-123 -b 'Looking into this'

分页

Linear 使用 Relay 风格的基于游标的分页机制。CLI 支持通过 --paginate 参数自动处理分页。

示例：

maton linear issue list -c ABC --paginate

代码示例

CLI

# 列出某团队的所有 issues
maton linear issue list -c ABC -L 10

# 查看指定 issue
maton linear issue view ABC-123

# 创建新 issue
maton linear issue create --team-id TEAM_ID -t 'Fix login'

# 添加评论
maton linear comment create --issue ABC-123 -b 'Looking into this'

JavaScript

const response = await fetch('https://api.maton.ai/linear/graphql', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.MATON_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: `{ issues(first: 10) { nodes { id identifier title state { name } } } }`
  })
});
const data = await response.json();

Python

import os
import requests

response = requests.post(
    'https://api.maton.ai/linear/graphql',
    headers={
        'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}',
        'Content-Type': 'application/json'
    },
    json={
        'query': '{ issues(first: 10) { nodes { id identifier title state { name } } } }'
    }
)
data = response.json()

注意事项

  • Linear 仅提供 GraphQL API（无 REST API）
  • Issue 标识符（如 ABC-123）可直接用于 id 参数，替代 UUID
  • 优先级（Priority）取值含义：0 = 无优先级，1 = 紧急，2 = 高，3 = 中，4 = 低
  • 工作流状态类型（Workflow state types）：backlog、unstarted、started、completed、canceled
  • GraphQL Schema 支持内省（introspection），地址为 https://api.linear.app/graphql
  • 使用 searchIssues(term: "...") 对 issues 执行全文检索
  • 部分变更操作（mutation）（如删除、创建 labels/projects）可能需要额外的 OAuth 权限范围（scopes）。若您收到 scope 错误，请联系 Maton 支持团队（support@maton.ai），说明所需的具体操作/API 及使用场景

错误处理

状态码 含义
400 缺失 Linear 连接，或 GraphQL 校验失败
401 Maton API 密钥无效或未提供
403 当前 OAuth 权限范围不足以执行该操作
429 请求频率超限（Rate limited）
4xx/5xx Linear API 返回的透传错误

GraphQL 错误统一返回在 errors 数组中：

{
  "errors": [
    {
      "message": "Invalid scope: `write` required",
      "extensions": {
        "type": "forbidden",
        "code": "FORBIDDEN",
        "statusCode": 403
      }
    }
  ]
}

故障排查：API 密钥问题

CLI：

  1. 检查当前认证状态：
maton whoami
  1. 通过列出连接验证 API 密钥有效性：
maton connection list

手动方式：

  1. 确认 MATON_API_KEY 环境变量已正确设置：
echo $MATON_API_KEY
  1. 通过列出连接验证 API 密钥有效性：
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

故障排查：应用名称无效

  1. 请确保请求路径以 linear 开头。例如：
  • 正确：https://api.maton.ai/linear/graphql
  • 错误：https://api.maton.ai/graphql

相关资源

  • Linear API 概览
  • Linear GraphQL 入门指南
  • Linear GraphQL Schema（Apollo Studio）
  • Linear API 与 Webhooks 文档
  • Maton CLI 手册
  • Maton 社区
  • Maton 技术支持

作者最新文章

JavaScript 中实现方法链式调用与无括号 getter 的统一接口

Go 中指针接收器方法无法初始化外部 nil 指针的原因与解决方案

PHP中安全实现数学表达式解析与计算（不使用eval）

如何使用 ArchUnit 限制非限定符类被 Qualifier 元注解标记

Kafka 消息级 Offset 管理：精准提交、避免重复与丢失的工程实践

热门AI工具

更多
音述AI

音述AI

Hot PixTV

PixTV

Hot AionClaw

AionClaw

Hot Laper

Laper

Hot VibeKnow

VibeKnow

Hot DeepSeek

DeepSeek

 咔片AIPPT

咔片AIPPT

Hot 豆包大模型

豆包大模型

相关专题

更多
Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。

2026.10.22

0

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。

2026.10.22

0

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。

2026.10.22

0

15

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。

2026.10.22

0

10

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。

2026.10.22

0

25

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。

2026.10.22

0

15

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。

2026.10.22

0

15

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。

2026.10.22

0

12

剧云人物设定与关系管理教程
剧云人物设定与关系管理教程

本专题介绍剧云人物设定与关系管理，讲解角色小传、性格职业、人物目标、背景资料和关系网络的创建及维护方法。

2026.10.22

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

相关下载

更多
MDPHP(麦迪php框架系统)1.1
PHP 多国语言框架2.0
ujframe简单快速PHP开发框架1.0
php轻量型框架1.0
MyQEE开源PHP多项目及模块化开发框架3.0 RC2
php开源学习型框架CMVC1.2.0
PHP框架Kohana3.3.1

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134万人学习

PHP实战天龙八部之仿爱奇艺电影网站
PHP实战天龙八部之仿爱奇艺电影网站

共49课时 | 82.5万人学习

最新文章

更多
英伟达开源机器人数据引擎 Flora:标注成本较 GPT-6Astra 降至125倍
Gartner 调研：44% 的 CEO 说不清 AI 到底赚没赚钱
Reddit 开源社区 r/opensource 封杀 AI 项目，开发者另起炉灶
三星电子宣布依托AI将新型半导体材料研发周期由5年缩短至2年
中国 AI 包揽全球调用榜前五，周调用量连续 26 周超美
字节跳动回应:Seed核心负责人周畅未离职
vibeknow生成的视频旁白不合适怎么办 在vibeknow调整文稿和配音后重新生成
Agent Space多个任务的结果怎么集中整理 借助Agent Space在同一空间接续处理
超级麦吉怎么让任务在关电脑后继续运行 交给超级麦吉云端执行并在手机查看进度
Laper怎么和团队一起修改同一份剧本 通过Laper协同编辑并统一场景内容