运行时依赖
安装命令
点击复制技能文档
Linear 如何使用此技能 此技能是对Linear的托管MCP服务器的薄层传递。实时服务器是工具存在、名称、参数和每个服务器指令的真实来源。始终通过bash {baseDir}/scripts/invoke.sh调用——永远不要直接调用mcporter。包装器在需要时从环境提供的令牌中初始化OAuth密钥库,然后调用mcporter。
步骤1 — 发现实时工具目录和Linear的使用说明。始终先运行此命令;不要依赖于工具名称的记忆: bash {baseDir}/scripts/invoke.sh list maverick-linear --schema 输出包括Linear的说明字段(请阅读它,例如,指定如何格式化markdown内容)和每个工具参数的JSON Schema。将其视为本次会话的权威参考。
步骤2 — 使用形式.调用目录中的任何工具,其中是maverick-linear(本地注册密钥,而不是Linear的公布名称): bash {baseDir}/scripts/invoke.sh call maverick-linear. = ... 添加--output json以获取结构化输出(也将传输错误作为JSON封装显示): bash {baseDir}/scripts/invoke.sh call --output json maverick-linear. ...
值得了解的约定 这些约定适用于大多数工具,但不是契约—— --schema才是。将它们用作默认值;当工具的schema与之冲突时,相信工具的schema。
Upsert模式。许多写入工具接受一个可选的id:存在 → 更新;不存在 → 创建。所需字段在两种情况下有所不同;工具的--schema描述中会指出这一点。
Linear的使用说明。从--schema输出中阅读说明字段,然后格式化任何文本内容参数。Linear在此发布指导(例如,关于markdown格式化)适用于每个适用的工具。
Linear ID灵活性。参数被记录为接受ID时,Linear通常也接受人类可读的标识符(问题标识符、项目别名、团队名称)。每个参数的schema描述是权威的。
安全 Linear MCP工具根据名称前缀清晰地分为读取工具(list_, get_, search_, extract_)和写入/删除工具(save_, delete_, create_*)。读取工具在探索时可以自由调用。写入/删除工具会修改用户团队可见的工作空间数据——在调用它们之前,请确认用户的明确意图。
身份验证 凭据通过必需的环境变量可供代理运行时使用。包装器在每次调用之前根据需要初始化mcporter的密钥库。然后,mcporter从密钥库中读取令牌,将其与每个请求一起发送,并在过期时刷新它们。如果调用返回HTTP 401且无法在几秒钟内恢复,则OAuth授权已被吊销——重新授权集成。
数据流 工具调用通过HTTPS发送到Linear的托管MCP服务https://mcp.linear.app/mcp,通过OAuth进行身份验证。Linear可以看到每个调用引用的问题/项目/评论数据。仅将此技能用于与Linear相关的工作;不要通过这些工具传递无关的敏感内容。