Skip to content

Conversation

@BekahHW
Copy link
Collaborator

@BekahHW BekahHW commented Oct 23, 2025

Overview

closes CON-4258

This PR adds a comprehensive cookbook for using the Atlassian Rovo MCP with Continue, covering Jira, Confluence, and Compass workflows.

What's Included

📚 New Guide: Atlassian MCP Continue Cookbook

Location: docs/guides/atlassian-mcp-continue-cookbook.mdx

Key Features:

  • Multi-Product Coverage: Complete workflows for Jira, Confluence, and Compass
  • Dual Setup Paths: Quick start via Continue Hub and manual configuration
  • OAuth 2.1 Documentation: Explains secure authentication flow
  • 20+ Practical Examples: Real-world workflows for common tasks
  • Two Execution Modes: Interactive TUI and headless automation
  • GitHub Actions Integration: Example automation workflows
  • Comprehensive Troubleshooting: OAuth, permissions, rate limiting, beta limitations
  • Admin Guidance: Installation, access management, and security

Workflow Examples Include:

Jira Workflows:

  • Search and filter issues (bugs, assignments, sprints)
  • Create and update issues with natural language
  • Bulk issue creation from meeting notes
  • Sprint planning and workload analysis

Confluence Workflows:

  • Search and summarize documentation
  • Create and update pages
  • Discover available spaces

Compass Workflows:

  • Query service dependencies
  • Create and manage components
  • Bulk import from CSV/JSON

Combined Workflows:

  • Link Jira issues to Confluence pages
  • Generate release notes across products
  • Service documentation lookup

GitHub Actions Examples:

  • Weekly sprint summaries posted to Confluence
  • PR documentation sync checks

Documentation Style

Follows the established pattern from the GitHub MCP cookbook with:

  • Clear prerequisites and setup instructions
  • Side-by-side TUI and headless mode examples
  • Troubleshooting accordion sections
  • Admin considerations callouts
  • Next steps and additional resources

Testing

  • Verified Markdown syntax
  • Followed existing documentation structure
  • Included all required frontmatter
  • Referenced official Atlassian MCP documentation

References


Generated with Continue

Co-Authored-By: Continue [email protected]


Summary by cubic

Add a new guide for using the Atlassian Rovo MCP with Continue across Jira, Confluence, and Compass.
Includes quick start and manual setup, OAuth details, TUI/headless prompts, GitHub Actions examples, troubleshooting, and admin guidance.

- Comprehensive guide for using Atlassian Rovo MCP with Continue
- Covers Jira, Confluence, and Compass workflows
- Includes natural language examples for TUI and headless modes
- Provides GitHub Actions automation examples
- Documents OAuth setup, troubleshooting, and admin considerations

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
@BekahHW BekahHW requested a review from a team as a code owner October 23, 2025 14:34
@BekahHW BekahHW requested review from RomneyDa and removed request for a team October 23, 2025 14:34
@dosubot dosubot bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Oct 23, 2025
@github-actions
Copy link

⚠️ PR Title Format

Your PR title doesn't follow the conventional commit format, but this won't block your PR from being merged. We recommend using this format for better project organization.

Expected Format:

<type>[optional scope]: <description>

Examples:

  • feat: add changelog generation support
  • fix: resolve login redirect issue
  • docs: update README with new instructions
  • chore: update dependencies

Valid Types:

feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

This helps with:

  • 📝 Automatic changelog generation
  • 🚀 Automated semantic versioning
  • 📊 Better project history tracking

This is a non-blocking warning - your PR can still be merged without fixing this.

@github-actions
Copy link

github-actions bot commented Oct 23, 2025

✅ Review Complete

Code Review Summary

⚠️ Continue API authentication failed. Please check your CONTINUE_API_KEY.


@BekahHW BekahHW changed the title Add Atlassian MCP Continue Cookbook docs: Add Atlassian MCP Continue Cookbook Oct 23, 2025
- Added to Cookbooks section in docs.json
- Added to MCP Integration Cookbooks in guides/overview.mdx
- Positioned after GitHub MCP cookbook for logical flow

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

- Changed quick start to use continuedev/atlassian-continuous-ai-confluence-agent
- Updated all headless mode examples to use --agent flag instead of --config/-p
- Simplified first command to show direct agent invocation
- Updated GitHub Actions examples to use the agent URL
- Removed --auto flag as it's implicit with direct command format

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
Major changes:
- Split Quick Start into two tabs: Jira Agent and Confluence Agent
- Added Agent Quick Reference table for easy comparison
- Updated all Jira workflow examples to use the Jira agent
- Kept all Confluence workflow examples with the Confluence agent
- Updated Compass workflows to use Jira agent (component-focused)
- Added guidance notes for cross-product workflows
- Included shell alias tips for both agents
- Updated GitHub Actions examples to use appropriate agents

All workflow examples now use the correct specialized agent:
- Jira Agent: continuedev/atlassian-continuous-ai-jira-agent
- Confluence Agent: continuedev/atlassian-continuous-ai-confluence-agent

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
- Updated cross-product workflows note to include custom agent option
- Added link to Atlassian MCP on Continue Hub
- Clarifies that users can create their own agents with the MCP

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
Major improvements:
- Changed from Cards to AccordionGroups for better scanability
- Removed dual TUI/headless examples - now showing single command format
- Added Info callouts explaining headless mode: add -p flag and --auto
- Emphasized OAuth authentication requirement before headless mode
- Simplified all examples to show direct command format
- Added inline comments in combined workflows to clarify agent choice
- Reduced redundancy and improved readability

The accordion format is more compact and easier to scan through multiple examples.

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
- Removed entire GitHub Actions automation section
- Removed example workflows (sprint summary and doc sync)
- Updated What You've Built section to remove automation reference
- Updated Next Steps to remove GitHub Actions setup step
- Simplified focus to interactive and headless CLI usage

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
@github-actions
Copy link

github-actions bot commented Oct 23, 2025

✅ Review Complete

Code Review Summary

⚠️ Continue API authentication failed. Please check your CONTINUE_API_KEY.


Updated the Two Specialized Agents callout to emphasize:
- These are ready-to-use agents to help users get started fast
- Pre-configured with optimized prompts, rules, and Atlassian MCP
- Users don't have to use them, but they provide the best experience
- Users can create their own custom agents instead

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 3 files

Copy link
Collaborator

@bdougie bdougie left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is really clever! jira-ai "your prompt"

@github-project-automation github-project-automation bot moved this from Todo to In Progress in Issues and PRs Oct 24, 2025
@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Oct 24, 2025
@BekahHW BekahHW merged commit f638f8b into main Oct 27, 2025
57 of 59 checks passed
@github-project-automation github-project-automation bot moved this from In Progress to Done in Issues and PRs Oct 27, 2025
@BekahHW BekahHW deleted the docs/atlassian-cookbook branch October 27, 2025 14:16
@github-actions github-actions bot locked and limited conversation to collaborators Oct 27, 2025
@sestinj
Copy link
Contributor

sestinj commented Oct 29, 2025

🎉 This PR is included in version 1.31.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@sestinj
Copy link
Contributor

sestinj commented Oct 29, 2025

🎉 This PR is included in version 1.4.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@sestinj
Copy link
Contributor

sestinj commented Oct 29, 2025

🎉 This PR is included in version 1.28.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

lgtm This PR has been approved by a maintainer released size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

4 participants