Elevance MCP Atlassian - Standalone Package

Model Context Protocol server for Jira and Confluence integration with AI assistants.

What This Provides

72 Tools Total:

• 48 Jira tools (search, create, update, transitions, comments, etc.)
• 24 Confluence tools (search, pages, comments, attachments, etc.)

Quick Setup (5 Minutes)

1. Get Your Personal Access Token (PAT)

Jira & Confluence:

1. Login to https://jira.elevancehealth.com
2. Click Profile Icon → Profile
3. Navigate to "Personal Access Tokens"
4. Click "Create Token"
   • Name: MCP Atlassian Integration
   • Expiry: 1 year
5. COPY THE TOKEN (shown only once!)

2. Configure Environment

# Copy template
copy .env.template .env

# Edit .env and paste your PAT tokens
notepad .env

Replace YOUR_JIRA_PAT_TOKEN_HERE and YOUR_CONFLUENCE_PAT_TOKEN_HERE with your actual token.

3. Install Dependencies

# Option A: Using pip
pip install -r requirements.txt

# Option B: Install as package
pip install -e .

4. Configure Your IDE

For Claude Desktop:

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "elevance-atlassian": {
      "command": "python",
      "args": ["-m", "mcp_atlassian"],
      "cwd": "C:\\path\\to\\elevance-mcp-atlassian-standalone",
      "env": {
        "JIRA_URL": "https://jira.elevancehealth.com",
        "JIRA_PERSONAL_TOKEN": "YOUR_PAT_HERE",
        "CONFLUENCE_URL": "https://confluence.elevancehealth.com/",
        "CONFLUENCE_PERSONAL_TOKEN": "YOUR_PAT_HERE"
      }
    }
  }
}

For Windsurf:

Add to your MCP settings or use the .env file approach (recommended).

For Cursor:

Add to MCP configuration in settings, similar format as Claude Desktop.

5. Test Connection

python validate_setup.py

You should see all checks passing with ✅ symbols.

6. Start Using!

Restart your IDE and ask your AI assistant:

• "Find my assigned Jira issues"
• "Search Confluence for onboarding docs"
• "Create a bug in project XYZ"
• "Update PROJ-123 status to In Progress"
• "Show me issues in the current sprint"
• "Get page content from Confluence space DEV"

Available Tools

Jira Tools (48)

Search & Discovery:

• jira_search - Search issues with JQL
• jira_search_fields - Find custom field definitions
• jira_get_all_projects - List accessible projects
• jira_get_project_issues - Get all issues in project

Issue Management:

• jira_get_issue - Get issue details
• jira_create_issue - Create new issue
• jira_update_issue - Update existing issue
• jira_delete_issue - Delete issue
• jira_batch_create_issues - Create multiple issues

Status & Workflow:

• jira_transition_issue - Change issue status
• jira_get_transitions - Get available transitions

Comments:

• jira_add_comment - Add comment to issue
• jira_edit_comment - Edit existing comment

Links:

• jira_create_issue_link - Link two issues
• jira_remove_issue_link - Remove link
• jira_create_remote_issue_link - Create web link
• jira_link_to_epic - Link issue to epic
• jira_get_link_types - Get available link types

Attachments:

• jira_download_attachments - Download issue attachments
• jira_get_issue_images - Get images as inline content

Watchers:

• jira_add_watcher - Add watcher to issue
• jira_remove_watcher - Remove watcher
• jira_get_issue_watchers - List watchers

Time Tracking:

• jira_add_worklog - Log work on issue
• jira_get_worklog - Get worklog entries

Agile/Sprints:

• jira_get_agile_boards - List boards
• jira_get_board_issues - Get issues on board
• jira_get_sprints_from_board - List sprints
• jira_get_sprint_issues - Get issues in sprint
• jira_create_sprint - Create new sprint
• jira_update_sprint - Update sprint
• jira_add_issues_to_sprint - Add issues to sprint

Versions:

• jira_get_project_versions - List versions
• jira_create_version - Create new version
• jira_batch_create_versions - Create multiple versions

Components:

• jira_get_project_components - List project components

Analytics:

• jira_get_issue_dates - Get date information
• jira_get_issue_sla - Calculate SLA metrics
• jira_batch_get_changelogs - Get change history

Development Info:

• jira_get_issue_development_info - Get PRs, commits, branches
• jira_get_issues_development_info - Batch development info

Advanced:

• jira_get_user_profile - Get user information
• jira_get_field_options - Get custom field options
• jira_get_issue_proforma_forms - Get ProForma forms
• jira_get_proforma_form_details - Get form details
• jira_update_proforma_form_answers - Update form answers

Service Desk (Server/DC only):

• jira_get_service_desk_for_project - Get service desk
• jira_get_service_desk_queues - List queues
• jira_get_queue_issues - Get issues in queue

Confluence Tools (24)

Search:

• confluence_search - Search content with CQL
• confluence_search_user - Search users

Pages:

• confluence_get_page - Get page content
• confluence_create_page - Create new page
• confluence_update_page - Update page
• confluence_delete_page - Delete page
• confluence_move_page - Move page
• confluence_get_page_children - Get child pages
• confluence_get_page_history - Get page version
• confluence_get_page_diff - Compare versions

Comments:

• confluence_add_comment - Add comment
• confluence_reply_to_comment - Reply to comment
• confluence_get_comments - Get page comments

Attachments:

• confluence_get_attachments - List attachments
• confluence_upload_attachment - Upload file
• confluence_upload_attachments - Upload multiple files
• confluence_download_attachment - Download file
• confluence_download_content_attachments - Download all attachments
• confluence_delete_attachment - Delete attachment

Images:

• confluence_get_page_images - Get images as inline content

Labels:

• confluence_get_labels - Get content labels
• confluence_add_label - Add label

Analytics:

• confluence_get_page_views - Get view statistics

Troubleshooting

"Module not found" error

pip install -e .

"Authentication failed"

• Verify PAT token is valid and not expired
• Check token hasn't been revoked
• Ensure correct URL (https://jira.elevancehealth.com)
• Try regenerating the token

SSL Certificate errors

Add to .env file:

JIRA_SSL_VERIFY=false
CONFLUENCE_SSL_VERIFY=false

Connection test fails

# Test if Python can import the module
python -c "import mcp_atlassian; print('OK')"

# Check MCP version
python -m mcp_atlassian --version

"No such file or directory" when running validation

Make sure you're in the correct directory:

cd C:\path\to\elevance-mcp-atlassian-standalone
python validate_setup.py

Tools not appearing in IDE

1. Verify IDE configuration has correct paths
2. Restart IDE completely
3. Check IDE logs for MCP connection errors
4. Ensure TOOLSETS=all in .env or IDE config

Security Best Practices

• ✅ Keep your .env file private
• ✅ Never share PAT tokens
• ✅ Rotate tokens every 6-12 months
• ✅ Don't commit .env to version control
• ✅ Use strong token names for tracking
• ✅ Revoke tokens when no longer needed

Advanced Configuration

Filter to Specific Projects

In .env:

JIRA_PROJECTS_FILTER=PROJ1,PROJ2,PROJ3
CONFLUENCE_SPACES_FILTER=SPACE1,SPACE2,SPACE3

Enable Verbose Logging

In .env:

MCP_VERBOSE=true
MCP_VERY_VERBOSE=true  # Debug level

Read-Only Mode (Testing)

In .env:

READ_ONLY_MODE=true

This prevents any write operations (create, update, delete).

Custom Toolsets

In .env:

# Only core tools
TOOLSETS=default

# Specific toolsets
TOOLSETS=default,jira_agile,jira_analytics

# Specific tools only
ENABLED_TOOLS=jira_search,jira_get_issue,confluence_search

System Requirements

• Python: 3.10 or higher
• Operating System: Windows, macOS, or Linux
• Network: Access to jira.elevancehealth.com
• IDE: Claude Desktop, Cursor, or Windsurf with MCP support

Package Contents

elevance-mcp-atlassian-standalone/
├── src/mcp_atlassian/       # Complete MCP implementation
│   ├── jira/                # 48 Jira tools
│   ├── confluence/          # 24 Confluence tools
│   ├── models/              # Data models
│   ├── servers/             # MCP server logic
│   └── utils/               # Utilities
├── .env.template            # Configuration template
├── requirements.txt         # Python dependencies
├── pyproject.toml          # Package metadata
├── validate_setup.py       # Setup validation script
├── README.md               # This file
├── SETUP-GUIDE.md          # Detailed setup instructions
└── LICENSE                 # MIT License

Support

For issues or questions, contact:

• Developer: Mohamed Wasim
• Email: Mohamed.Wasim@carelon.com

Next Steps

1. ✅ Complete setup using steps above
2. ✅ Run validation: python validate_setup.py
3. ✅ Configure your IDE
4. ✅ Restart IDE
5. ✅ Start using AI assistant with Jira/Confluence

Additional Resources

• SETUP-GUIDE.md - Detailed step-by-step guide with screenshots descriptions
• Original Documentation - https://mcp-atlassian.soomiles.com

License

MIT License - Internal use for Elevance Health/Carelon

---

Version: 1.0
Last Updated: March 2026
Maintained by: Carelon Global Solutions