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.)

Related MCP server: Jira Cloud MCP Server

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