Skip to content

Atlassian

Atlassian MCP 服务器将你的 ADK 智能体连接到 Atlassian生态系统,弥合 Jira 中的项目跟踪和 Confluence 中的知识管理之间的差距。此集成使你的智能体能够管理问题、搜索和更新文档页面,并使用自然语言简化协作工作流。

使用场景

  • 统一知识搜索:同时搜索 Jira 问题和 Confluence 页面,以查找项目规范、决策或历史上下文。
  • 自动化问题管理:创建、编辑和转换 Jira 问题,或向现有工单添加评论。
  • 文档助手:直接从你的智能体检索页面内容、生成草稿或向 Confluence 文档添加内联评论。

前置条件

  • 注册 Atlassian 账户
  • 一个具有 Jira 和/或 Confluence 的 Atlassian Cloud 站点

与智能体一起使用

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="atlassian_agent",
    instruction="帮助用户处理 Atlassian 产品中的数据",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "mcp-remote",
                        "https://mcp.atlassian.com/v1/sse",
                    ]
                ),
                timeout=30,
            ),
        )
    ],
)

注意

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

可用工具

工具 描述
atlassianUserInfo 获取用户信息
getAccessibleAtlassianResources 获取可访问的 Atlassian 资源信息
getJiraIssue 获取 Jira 问题信息
editJiraIssue 编辑 Jira 问题
createJiraIssue 创建新的 Jira 问题
getTransitionsForJiraIssue 获取 Jira 问题的转换
transitionJiraIssue 转换 Jira 问题
lookupJiraAccountId 查找 Jira 账户 ID
searchJiraIssuesUsingJql 使用 JQL 搜索 Jira 问题
addCommentToJiraIssue 向 Jira 问题添加评论
getJiraIssueRemoteIssueLinks 获取 Jira 问题的远程问题链接
getVisibleJiraProjects 获取可见的 Jira 项目
getJiraProjectIssueTypesMetadata 获取 Jira 项目的问题类型元数据
getJiraIssueTypeMetaWithFields 获取 Jira 问题的问题类型元数据和字段
getConfluenceSpaces 获取 Confluence 空间信息
getConfluencePage 获取 Confluence 页面信息
getPagesInConfluenceSpace 获取 Confluence 空间中页面的信息
getConfluencePageFooterComments 获取 Confluence 页面中页脚评论的信息
getConfluencePageInlineComments 获取 Confluence 页面中内联评论的信息
getConfluencePageDescendants 获取 Confluence 页面后代的信息
createConfluencePage 创建新的 Confluence 页面
updateConfluencePage 更新现有的 Confluence 页面
createConfluenceFooterComment 在 Confluence 页面中创建页脚评论
createConfluenceInlineComment 在 Confluence 页面中创建内联评论
searchConfluenceUsingCql 使用 CQL 搜索 Confluence
search 搜索信息
fetch 获取信息

额外资源