Skip to content

Linear

Linear MCP 服务器将你的 ADK 智能体连接到 Linear,一个专为规划和构建产品而设计的工具。此集成使你的智能体能够管理问题、跟踪项目周期，并使用自然语言自动化开发工作流。

使用场景

  • 简化问题管理：使用自然语言创建、更新和组织问题。让你的智能体处理记录错误、分配任务和更新状态。

  • 跟踪项目和周期：即时了解你团队的进展。查询活跃周期的状态、检查项目里程碑并检索截止日期。

  • 上下文搜索和总结：快速跟进长讨论线程或查找特定项目规范。你的智能体可以搜索文档并总结复杂问题。

前置条件

与智能体一起使用

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

root_agent = Agent(
    model="gemini-2.5-pro",
    name="linear_agent",
    instruction="帮助用户在 Linear 中管理问题、项目和周期",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "mcp-remote",
                        "https://mcp.linear.app/mcp",
                    ]
                ),
                timeout=30,
            ),
        )
    ],
)

注意

当你第一次运行此智能体时,浏览器窗口将自动打开以通过 OAuth 请求访问权限。或者,你可以使用控制台中打印的授权 URL。你必须批准此请求 以允许智能体访问你的 Linear 数据。

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

LINEAR_API_KEY = "YOUR_LINEAR_API_KEY"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="linear_agent",
    instruction="帮助用户在 Linear 中管理问题、项目和周期",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url="https://mcp.linear.app/mcp",
                headers={
                    "Authorization": f"Bearer {LINEAR_API_KEY}",
                },
            ),
        )
    ],
)

注意

此代码示例使用 API 密钥进行身份验证。要使用基于浏览器的 OAuth 身份验证流程,请删除 headers参数并运行智能体。

可用工具

工具 描述
list_comments 列出问题的评论
create_comment 在问题上创建评论
list_cycles 列出项目中的周期
get_document 获取文档
list_documents 列出文档
get_issue 获取问题
list_issues 列出问题
create_issue 创建问题
update_issue 更新问题
list_issue_statuses 列出问题状态
get_issue_status 获取问题状态
list_issue_labels 列出问题标签
create_issue_label 创建问题标签
list_projects 列出项目
get_project 获取项目
create_project 创建项目
update_project 更新项目
list_project_labels 列出项目标签
list_teams 列出团队
get_team 获取团队
list_users 列出用户
get_user 获取用户
search_documentation 搜索文档

额外资源