# 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

```bash
# 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

```bash
# 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`:

```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

```bash
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

```bash
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:
```env
JIRA_SSL_VERIFY=false
CONFLUENCE_SSL_VERIFY=false
```

### Connection test fails

```bash
# 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:
```bash
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`:
```env
JIRA_PROJECTS_FILTER=PROJ1,PROJ2,PROJ3
CONFLUENCE_SPACES_FILTER=SPACE1,SPACE2,SPACE3
```

### Enable Verbose Logging

In `.env`:
```env
MCP_VERBOSE=true
MCP_VERY_VERBOSE=true  # Debug level
```

### Read-Only Mode (Testing)

In `.env`:
```env
READ_ONLY_MODE=true
```

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

### Custom Toolsets

In `.env`:
```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