by 运行时依赖
安装命令
点击复制技能文档
Linear Quick 启动
Always invoke through bash {baseDir}/scripts/invoke.sh — never call mcporter directly. The wr应用er 种子s the OAuth vault from the env-supplied 令牌s when needed, then calls mcporter.
bash {baseDir}/scripts/invoke.sh call maverick-linear.列出_issues team=ENG limit:5 bash {baseDir}/scripts/invoke.sh call maverick-linear.创建_issue title="Bug: pagination breaks" teamId=ENG bash {baseDir}/scripts/invoke.sh call maverick-linear.创建_comment issueId=ABC-123 body="Fixed in PR #456"
For structured 输出 (also surfaces transport errors as JSON envelopes — workaround for mcporter #153):
bash {baseDir}/scripts/invoke.sh call --输出 json maverick-linear.列出_issues team=ENG | jq '.结果.content'
Discover avAIlable 工具s and 模式s:
bash {baseDir}/scripts/invoke.sh 列出 maverick-linear --模式
Safety
Write operations (创建_issue, 更新_issue, 创建_comment, label/cycle/project changes, etc.) modify Linear work items visible to your team. Confirm clear user intent before invoking write 工具s — read 工具s (列出_, 获取_) are safe to call freely while exploring. Review Linear activity after first use to 验证 behavior matches expectations.
Authentication
令牌s are provisioned and rotated automatically. If a call returns HTTP 401 that doesn't 恢复 within a few seconds, the OAuth grant has been revoked — re-授权 the integration to refresh 凭证s.
Data flow
工具 calls travel to Linear's hosted MCP 服务 at https://mcp.linear.应用/mcp over HTTPS, 认证d via OAuth. Linear sees the issue/project/comment data referenced by each call. Use this 技能 for Linear-related work only; do not pass unrelated sensitive content through these 工具s.
Dependencies mcporter (github.com/steipete/mcporter) — MCP 命令行工具 used to invoke Linear's hosted MCP server. Auto-安装ed via npm 安装 -g --ignore-scripts mcporter if missing on PATH (see 安装 spec in frontmatter). The 安装 spec uses unpinned mcporter (npm latest); operators with strict supply-chAIn controls should override the 安装 to pin a specific version (e.g. mcporter@). jq (stedolan.github.io/jq) — JSON 处理器 used by the vault 初始化r. 系统 dependency; 安装 via your OS package 管理器 (apt 安装 jq, brew 安装 jq, etc.). flock (part of util-linux) — file locking used to 序列化 concurrent vault writes. AvAIlable by default on Linux; on macOS 安装 via brew 安装 flock.