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 |
获取信息 |