> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-atlassian.soomiles.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Workflows

> Practical recipes for common Jira and Confluence tasks with MCP Atlassian

This guide provides step-by-step workflows for common tasks using MCP Atlassian tools.

## Jira Workflows

### Triage New Issues

1. **Find untriaged issues:**

```json theme={null}
jira_search: {"jql": "project = PROJ AND status = 'Open' AND assignee IS EMPTY ORDER BY created DESC", "limit": 20}
```

2. **Review each issue** to understand the problem:

```json theme={null}
jira_get_issue: {"issue_key": "PROJ-123", "comment_limit": 5}
```

3. **Assign and prioritize:**

```json theme={null}
jira_update_issue: {"issue_key": "PROJ-123", "additional_fields": "{\"assignee\": {\"accountId\": \"user-id\"}, \"priority\": {\"name\": \"High\"}}"}
```

4. **Add a triage comment:**

```json theme={null}
jira_add_comment: {"issue_key": "PROJ-123", "body": "Triaged: High priority, assigned to backend team."}
```

### Sprint Planning

1. **Get the board and active sprint:**

```json theme={null}
jira_get_agile_boards: {"project_key": "PROJ", "board_type": "scrum"}
```

```json theme={null}
jira_get_sprints_from_board: {"board_id": "42", "state": "active,future"}
```

2. **Review current sprint progress:**

```json theme={null}
jira_get_sprint_issues: {"sprint_id": "100", "fields": "summary,status,story_points,assignee"}
```

3. **Find backlog items for next sprint:**

```json theme={null}
jira_search: {"jql": "project = PROJ AND sprint IS EMPTY AND status = 'Open' ORDER BY priority DESC, created ASC", "limit": 30}
```

### Bulk Issue Creation

Create multiple related issues at once:

```json theme={null}
jira_batch_create_issues: {
  "project_key": "PROJ",
  "issues": [
    {"issue_type": "Task", "summary": "Set up CI pipeline", "description": "Configure GitHub Actions"},
    {"issue_type": "Task", "summary": "Write unit tests", "description": "Add tests for core module"},
    {"issue_type": "Task", "summary": "Update documentation", "description": "Document new API endpoints"}
  ]
}
```

### Track Issue Changes

Monitor what changed across multiple issues:

```json theme={null}
jira_batch_get_changelogs: {"issue_keys": ["PROJ-1", "PROJ-2", "PROJ-3"]}
```

<Note>Changelog tracking is only available on Jira Cloud.</Note>

## Confluence Workflows

### Create Documentation Structure

1. **Create a parent page:**

```json theme={null}
confluence_create_page: {"space_key": "DEV", "title": "Project Documentation", "content": "## Overview\n\nThis space contains all project docs."}
```

2. **Create child pages:**

```json theme={null}
confluence_create_page: {"space_key": "DEV", "title": "API Reference", "content": "## API Endpoints\n\n...", "parent_id": "12345678"}
```

3. **Add labels for organization:**

```json theme={null}
confluence_add_label: {"page_id": "12345678", "label": "api-docs"}
```

### Content Migration

1. **Search for pages to migrate:**

```json theme={null}
confluence_search: {"query": "space = OLD_SPACE AND label = 'migrate' ORDER BY title ASC"}
```

2. **Read each page's content:**

```json theme={null}
confluence_get_page: {"page_id": "12345678", "include_metadata": true}
```

3. **Create in new space:**

```json theme={null}
confluence_create_page: {"space_key": "NEW_SPACE", "title": "Migrated Page", "content": "...migrated content..."}
```

### Identify Stale Content

Find pages that haven't been updated recently:

```json theme={null}
confluence_search: {"query": "space = DEV AND type = page AND lastModified < '2024-01-01' ORDER BY lastModified ASC", "limit": 50}
```

Check page view analytics:

```json theme={null}
confluence_get_page_views: {"page_id": "12345678"}
```

## Cross-Product Workflows

### Link Jira Issues to Confluence Pages

1. **Create a Confluence page with project context:**

```json theme={null}
confluence_create_page: {"space_key": "DEV", "title": "Sprint 42 Retrospective", "content": "## Sprint 42\n\nSee PROJ-100 through PROJ-120 for completed work."}
```

2. **Add a remote link from Jira to Confluence:**

```json theme={null}
jira_create_remote_issue_link: {"issue_key": "PROJ-100", "url": "https://your-instance.atlassian.net/wiki/spaces/DEV/pages/12345678", "title": "Sprint 42 Retro"}
```