mcp

# MCP 参考 通过 MCP 进行 Atlassian Jira 操作的完整参考。 ## MCP 工具参考 ### 搜索操作 #### `mcp__atlassian__searchJiraIssuesUsingJql` 使用 JQL (Jira 查询语言) 搜索 Jira。 **参数：** - `jql` (必需): JQL 查询字符串 - `maxResults`: 最大结果数 (默认: 50) - `startAt`: 分页偏移量 - `fields`: 要返回的字段（逗号分隔） **示例：** mcp__atlassian__searchJiraIssuesUsingJql(jql: "project = PROJ AND status = 'In Progress'") ### 问题操作 #### `mcp__atlassian__getJiraIssue` 按键获取完整问题详情。 **参数：** - `issueKey` (必需): 问题键 (例如 "PROJ-123") - `expand`: 附加数据 (changelog, transitions, renderedFields) **示例：** mcp__atlassian__getJiraIssue(issueKey: "PROJ-123") #### `mcp__atlassian__createJiraIssue` 创建新问题。 **参数：** - `projectKey` (必需): 目标项目 - `issueType` (必需): 问题类型 (Story, Bug, Task, Epic 等) - `summary` (必需): 问题标题 - `description`: 详细描述 - `assignee`: 账户 ID (先使用 lookupJiraAccountId) - `priority`: 优先级名称 (Highest, High, Medium, Low, Lowest) - `labels`: 标签数组 - `components`: 组件名称数组 - 根据需要添加自定义字段 **示例：** mcp__atlassian__createJiraIssue( projectKey: "PROJ", issueType: "Story", summary: "Implement user authentication", description: "Add OAuth2 authentication flow...", labels: ["backend", "security"] ) #### `mcp__atlassian__editJiraIssue` 更新现有问题。 **参数：** - `issueKey` (必需): 要更新的问题 - 任何要更新的字段 (summary, description, assignee 等) **示例：** mcp__atlassian__editJiraIssue( issueKey: "PROJ-123", description: "Updated description with more details..." ) ### 状态转换操作 #### `mcp__atlassian__getTransitionsForJiraIssue` 获取问题的可用状态转换。 **参数：** - `issueKey` (必需): 问题键 **返回：** 包含 ID 和名称的可用转换列表。 #### `mcp__atlassian__transitionJiraIssue` 更改问题状态。 **参数：** - `issueKey` (必需): 问题键 - `transitionId` (必需): 来自 getTransitions 的转换 ID - `comment`: 转换的可选评论 **工作流：** 1. 获取转换：`getTransitionsForJiraIssue("PROJ-123")` 2. 从结果中找到所需的转换 ID 3. 执行：`transitionJiraIssue(issueKey: "PROJ-123", transitionId: "