Back to Details

linear-automation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Linear Automation via Rube MCP

通过Rube MCP实现Linear自动化

Automate Linear operations through Composio's Linear toolkit via Rube MCP.
Toolkit docs: composio.dev/toolkits/linear
通过Composio的Linear工具包，借助Rube MCP自动化Linear操作。
工具包文档：composio.dev/toolkits/linear

Prerequisites

前提条件

  • Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
  • Active Linear connection via 
    RUBE_MANAGE_CONNECTIONS
    with toolkit 
    linear
  • Always call 
    RUBE_SEARCH_TOOLS
    first to get current tool schemas
  • 必须已连接Rube MCP（可使用RUBE_SEARCH_TOOLS）
  • 通过
    RUBE_MANAGE_CONNECTIONS
    激活Linear连接，工具包为
    linear
  • 请始终先调用
    RUBE_SEARCH_TOOLS
    以获取最新的工具模式

Setup

设置步骤

Get Rube MCP: Add 
https://rube.app/mcp
as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
  1. Verify Rube MCP is available by confirming 
    RUBE_SEARCH_TOOLS
    responds
  2. Call 
    RUBE_MANAGE_CONNECTIONS
    with toolkit 
    linear
  3. If connection is not ACTIVE, follow the returned auth link to complete Linear OAuth
  4. Confirm connection status shows ACTIVE before running any workflows
获取Rube MCP：在客户端配置中添加
https://rube.app/mcp
作为MCP服务器。无需API密钥 — 只需添加端点即可使用。
  1. 确认
    RUBE_SEARCH_TOOLS
    有响应，以此验证Rube MCP可用
  2. 调用
    RUBE_MANAGE_CONNECTIONS
    并指定工具包为
    linear
  3. 如果连接未处于ACTIVE状态，请按照返回的授权链接完成Linear OAuth验证
  4. 在运行任何工作流之前，确认连接状态显示为ACTIVE

Core Workflows

核心工作流

1. Manage Issues

1. 管理议题

When to use: User wants to create, search, update, or list Linear issues
Tool sequence:
  1. LINEAR_GET_ALL_LINEAR_TEAMS
    - Get team IDs [Prerequisite]
  2. LINEAR_LIST_LINEAR_STATES
    - Get workflow states for a team [Prerequisite]
  3. LINEAR_CREATE_LINEAR_ISSUE
    - Create a new issue [Optional]
  4. LINEAR_SEARCH_ISSUES
    / 
    LINEAR_LIST_LINEAR_ISSUES
    - Find issues [Optional]
  5. LINEAR_GET_LINEAR_ISSUE
    - Get issue details [Optional]
  6. LINEAR_UPDATE_ISSUE
    - Update issue properties [Optional]
Key parameters:
  • team_id
    : Team ID (required for creation)
  • title
    : Issue title
  • description
    : Issue description (Markdown supported)
  • state_id
    : Workflow state ID
  • assignee_id
    : Assignee user ID
  • priority
    : 0 (none), 1 (urgent), 2 (high), 3 (medium), 4 (low)
  • label_ids
    : Array of label IDs
Pitfalls:
  • Team ID is required when creating issues; use GET_ALL_LINEAR_TEAMS first
  • State IDs are team-specific; use LIST_LINEAR_STATES with the correct team
  • Priority uses integer values 0-4, not string names
适用场景：用户需要创建、搜索、更新或列出Linear议题
工具序列：
  1. LINEAR_GET_ALL_LINEAR_TEAMS
    - 获取团队ID [前提步骤]
  2. LINEAR_LIST_LINEAR_STATES
    - 获取团队的工作流状态 [前提步骤]
  3. LINEAR_CREATE_LINEAR_ISSUE
    - 创建新议题 [可选]
  4. LINEAR_SEARCH_ISSUES
    / 
    LINEAR_LIST_LINEAR_ISSUES
    - 查找议题 [可选]
  5. LINEAR_GET_LINEAR_ISSUE
    - 获取议题详情 [可选]
  6. LINEAR_UPDATE_ISSUE
    - 更新议题属性 [可选]
关键参数：
  • team_id
    ：团队ID（创建议题时必填）
  • title
    ：议题标题
  • description
    ：议题描述（支持Markdown）
  • state_id
    ：工作流状态ID
  • assignee_id
    ：经办人用户ID
  • priority
    ：0（无优先级）、1（紧急）、2（高）、3（中）、4（低）
  • label_ids
    ：标签ID数组
注意事项：
  • 创建议题时必须提供团队ID；请先调用GET_ALL_LINEAR_TEAMS获取
  • 状态ID是团队专属的；请使用对应团队ID调用LIST_LINEAR_STATES
  • 优先级使用整数值0-4，而非字符串名称

2. Manage Projects

2. 管理项目

When to use: User wants to create or update Linear projects
Tool sequence:
  1. LINEAR_LIST_LINEAR_PROJECTS
    - List existing projects [Optional]
  2. LINEAR_CREATE_LINEAR_PROJECT
    - Create a new project [Optional]
  3. LINEAR_UPDATE_LINEAR_PROJECT
    - Update project details [Optional]
Key parameters:
  • name
    : Project name
  • description
    : Project description
  • team_ids
    : Array of team IDs associated with the project
  • state
    : Project state (e.g., 'planned', 'started', 'completed')
Pitfalls:
  • Projects span teams; they can be associated with multiple teams
适用场景：用户需要创建或更新Linear项目
工具序列：
  1. LINEAR_LIST_LINEAR_PROJECTS
    - 列出现有项目 [可选]
  2. LINEAR_CREATE_LINEAR_PROJECT
    - 创建新项目 [可选]
  3. LINEAR_UPDATE_LINEAR_PROJECT
    - 更新项目详情 [可选]
关键参数：
  • name
    ：项目名称
  • description
    ：项目描述
  • team_ids
    ：与项目关联的团队ID数组
  • state
    ：项目状态（例如：'planned'、'started'、'completed'）
注意事项：
  • 项目可跨团队；可关联多个团队

3. Manage Cycles

3. 管理周期

When to use: User wants to work with Linear cycles (sprints)
Tool sequence:
  1. LINEAR_GET_ALL_LINEAR_TEAMS
    - Get team ID [Prerequisite]
  2. LINEAR_GET_CYCLES_BY_TEAM_ID
    / 
    LINEAR_LIST_LINEAR_CYCLES
    - List cycles [Required]
Key parameters:
  • team_id
    : Team ID for cycle operations
  • number
    : Cycle number
Pitfalls:
  • Cycles are team-specific; always scope by team_id
适用场景：用户需要处理Linear周期（迭代）
工具序列：
  1. LINEAR_GET_ALL_LINEAR_TEAMS
    - 获取团队ID [前提步骤]
  2. LINEAR_GET_CYCLES_BY_TEAM_ID
    / 
    LINEAR_LIST_LINEAR_CYCLES
    - 列出周期 [必填]
关键参数：
  • team_id
    ：周期操作对应的团队ID
  • number
    ：周期编号
注意事项：
  • 周期是团队专属的；请始终通过team_id限定范围

4. Manage Labels and Comments

4. 管理标签与评论

When to use: User wants to create labels or comment on issues
Tool sequence:
  1. LINEAR_CREATE_LINEAR_LABEL
    - Create a new label [Optional]
  2. LINEAR_CREATE_LINEAR_COMMENT
    - Comment on an issue [Optional]
  3. LINEAR_UPDATE_LINEAR_COMMENT
    - Edit a comment [Optional]
Key parameters:
  • name
    : Label name
  • color
    : Label color (hex)
  • issue_id
    : Issue ID for comments
  • body
    : Comment body (Markdown)
Pitfalls:
  • Labels can be team-scoped or workspace-scoped
  • Comment body supports Markdown formatting
适用场景：用户需要创建标签或在议题下添加评论
工具序列：
  1. LINEAR_CREATE_LINEAR_LABEL
    - 创建新标签 [可选]
  2. LINEAR_CREATE_LINEAR_COMMENT
    - 在议题下添加评论 [可选]
  3. LINEAR_UPDATE_LINEAR_COMMENT
    - 编辑评论 [可选]
关键参数：
  • name
    ：标签名称
  • color
    ：标签颜色（十六进制）
  • issue_id
    ：评论对应的议题ID
  • body
    ：评论内容（支持Markdown）
注意事项：
  • 标签可限定为团队范围或工作区范围
  • 评论内容支持Markdown格式

5. Custom GraphQL Queries

5. 自定义GraphQL查询

When to use: User needs advanced queries not covered by standard tools
Tool sequence:
  1. LINEAR_RUN_QUERY_OR_MUTATION
    - Execute custom GraphQL [Required]
Key parameters:
  • query
    : GraphQL query or mutation string
  • variables
    : Variables for the query
Pitfalls:
  • Requires knowledge of Linear's GraphQL schema
  • Rate limits apply to GraphQL queries
适用场景：用户需要标准工具未覆盖的高级查询
工具序列：
  1. LINEAR_RUN_QUERY_OR_MUTATION
    - 执行自定义GraphQL [必填]
关键参数：
  • query
    ：GraphQL查询或变更字符串
  • variables
    ：查询变量
注意事项：
  • 需要了解Linear的GraphQL模式
  • GraphQL查询受速率限制约束

Common Patterns

常见模式

ID Resolution

ID解析

Team name -> Team ID:
1. Call LINEAR_GET_ALL_LINEAR_TEAMS
2. Find team by name in response
3. Extract id field
State name -> State ID:
1. Call LINEAR_LIST_LINEAR_STATES with team_id
2. Find state by name
3. Extract id field
团队名称 -> 团队ID：
1. 调用LINEAR_GET_ALL_LINEAR_TEAMS
2. 在响应中按名称查找团队
3. 提取id字段
状态名称 -> 状态ID：
1. 使用team_id调用LINEAR_LIST_LINEAR_STATES
2. 按名称查找状态
3. 提取id字段

Pagination

分页

  • Linear tools return paginated results
  • Check for pagination cursors in responses
  • Pass cursor to next request for additional pages
  • Linear工具返回分页结果
  • 检查响应中的分页游标
  • 将游标传递给下一次请求以获取更多页面

Known Pitfalls

已知注意事项

Team Scoping:
  • Issues, states, and cycles are team-specific
  • Always resolve team_id before creating issues
Priority Values:
  • 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low
  • Use integer values, not string names
团队范围限定：
  • 议题、状态和周期是团队专属的
  • 创建议题前请务必解析team_id
优先级值：
  • 0 = 无优先级，1 = 紧急，2 = 高，3 = 中，4 = 低
  • 使用整数值，而非字符串名称

Quick Reference

快速参考

TaskTool SlugKey Params
List teamsLINEAR_GET_ALL_LINEAR_TEAMS(none)
Create issueLINEAR_CREATE_LINEAR_ISSUEteam_id, title, description
Search issuesLINEAR_SEARCH_ISSUESquery
List issuesLINEAR_LIST_LINEAR_ISSUESteam_id, filters
Get issueLINEAR_GET_LINEAR_ISSUEissue_id
Update issueLINEAR_UPDATE_ISSUEissue_id, fields
List statesLINEAR_LIST_LINEAR_STATESteam_id
List projectsLINEAR_LIST_LINEAR_PROJECTS(none)
Create projectLINEAR_CREATE_LINEAR_PROJECTname, team_ids
Update projectLINEAR_UPDATE_LINEAR_PROJECTproject_id, fields
List cyclesLINEAR_LIST_LINEAR_CYCLESteam_id
Get cyclesLINEAR_GET_CYCLES_BY_TEAM_IDteam_id
Create labelLINEAR_CREATE_LINEAR_LABELname, color
Create commentLINEAR_CREATE_LINEAR_COMMENTissue_id, body
Update commentLINEAR_UPDATE_LINEAR_COMMENTcomment_id, body
List usersLINEAR_LIST_LINEAR_USERS(none)
Current userLINEAR_GET_CURRENT_USER(none)
Run GraphQLLINEAR_RUN_QUERY_OR_MUTATIONquery, variables
Powered by Composio
任务工具标识关键参数
列出团队LINEAR_GET_ALL_LINEAR_TEAMS(无)
创建议题LINEAR_CREATE_LINEAR_ISSUEteam_id, title, description
搜索议题LINEAR_SEARCH_ISSUESquery
列出议题LINEAR_LIST_LINEAR_ISSUESteam_id, filters
获取议题详情LINEAR_GET_LINEAR_ISSUEissue_id
更新议题LINEAR_UPDATE_ISSUEissue_id, fields
列出状态LINEAR_LIST_LINEAR_STATESteam_id
列出项目LINEAR_LIST_LINEAR_PROJECTS(无)
创建项目LINEAR_CREATE_LINEAR_PROJECTname, team_ids
更新项目LINEAR_UPDATE_LINEAR_PROJECTproject_id, fields
列出周期LINEAR_LIST_LINEAR_CYCLESteam_id
获取周期LINEAR_GET_CYCLES_BY_TEAM_IDteam_id
创建标签LINEAR_CREATE_LINEAR_LABELname, color
创建评论LINEAR_CREATE_LINEAR_COMMENTissue_id, body
更新评论LINEAR_UPDATE_LINEAR_COMMENTcomment_id, body
列出用户LINEAR_LIST_LINEAR_USERS(无)
获取当前用户LINEAR_GET_CURRENT_USER(无)
运行GraphQLLINEAR_RUN_QUERY_OR_MUTATIONquery, variables
由 Composio 提供支持