Elevance MCP Atlassian — автономный пакет

Сервер Model Context Protocol для интеграции Jira и Confluence с AI-ассистентами.

Что это предоставляет

Всего 72 инструмента:

• 48 инструментов Jira (поиск, создание, обновление, переходы, комментарии и т. д.)

• 24 инструмента Confluence (поиск, страницы, комментарии, вложения и т. д.)

Related MCP server: Jira Cloud MCP Server

Быстрая настройка (5 минут)

1. Получите свой персональный токен доступа (PAT)

Jira и Confluence:

1. Войдите на https://jira.elevancehealth.com

2. Нажмите на иконку профиля → Профиль

3. Перейдите в раздел «Personal Access Tokens»

4. Нажмите «Create Token»

   • Имя: MCP Atlassian Integration

   • Срок действия: 1 год

5. СКОПИРУЙТЕ ТОКЕН (показывается только один раз!)

2. Настройте окружение

# Copy template
copy .env.template .env

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

Замените YOUR_JIRA_PAT_TOKEN_HERE и YOUR_CONFLUENCE_PAT_TOKEN_HERE на ваш фактический токен.

3. Установите зависимости

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

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

4. Настройте вашу IDE

Для Claude Desktop:

Отредактируйте %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"
      }
    }
  }
}

Для Windsurf:

Добавьте в настройки MCP или используйте подход с файлом .env (рекомендуется).

Для Cursor:

Добавьте в конфигурацию MCP в настройках, формат аналогичен Claude Desktop.

5. Проверьте подключение

python validate_setup.py

Вы должны увидеть все проверки, проходящие с символами ✅.

6. Начните использовать!

Перезапустите вашу IDE и спросите вашего AI-ассистента:

• «Найди мои назначенные задачи Jira»

• «Найди в Confluence документацию по онбордингу»

• «Создай баг в проекте XYZ»

• «Обнови статус PROJ-123 на In Progress»

• «Покажи задачи в текущем спринте»

• «Получи содержимое страницы из пространства Confluence DEV»

Доступные инструменты

Инструменты Jira (48)

Поиск и обнаружение:

• jira_search — поиск задач с помощью JQL

• jira_search_fields — поиск определений настраиваемых полей

• jira_get_all_projects — список доступных проектов

• jira_get_project_issues — получение всех задач в проекте

Управление задачами:

• jira_get_issue — получение деталей задачи

• jira_create_issue — создание новой задачи

• jira_update_issue — обновление существующей задачи

• jira_delete_issue — удаление задачи

• jira_batch_create_issues — создание нескольких задач

Статусы и рабочие процессы:

• jira_transition_issue — изменение статуса задачи

• jira_get_transitions — получение доступных переходов

Комментарии:

• jira_add_comment — добавление комментария к задаче

• jira_edit_comment — редактирование существующего комментария

Связи:

• jira_create_issue_link — связывание двух задач

• jira_remove_issue_link — удаление связи

• jira_create_remote_issue_link — создание веб-ссылки

• jira_link_to_epic — привязка задачи к эпику

• jira_get_link_types — получение доступных типов связей

Вложения:

• jira_download_attachments — скачивание вложений задачи

• jira_get_issue_images — получение изображений как встроенного содержимого

Наблюдатели:

• jira_add_watcher — добавление наблюдателя к задаче

• jira_remove_watcher — удаление наблюдателя

• jira_get_issue_watchers — список наблюдателей

Учет времени:

• jira_add_worklog — запись работы по задаче

• jira_get_worklog — получение записей журнала работ

Agile/Спринты:

• jira_get_agile_boards — список досок

• jira_get_board_issues — получение задач на доске

• jira_get_sprints_from_board — список спринтов

• jira_get_sprint_issues — получение задач в спринте

• jira_create_sprint — создание нового спринта

• jira_update_sprint — обновление спринта

• jira_add_issues_to_sprint — добавление задач в спринт

Версии:

• jira_get_project_versions — список версий

• jira_create_version — создание новой версии

• jira_batch_create_versions — создание нескольких версий

Компоненты:

• jira_get_project_components — список компонентов проекта

Аналитика:

• jira_get_issue_dates — получение информации о датах

• jira_get_issue_sla — расчет метрик SLA

• jira_batch_get_changelogs — получение истории изменений

Информация о разработке:

• jira_get_issue_development_info — получение PR, коммитов, веток

• jira_get_issues_development_info — пакетная информация о разработке

Дополнительно:

• jira_get_user_profile — получение информации о пользователе

• jira_get_field_options — получение параметров настраиваемых полей

• jira_get_issue_proforma_forms — получение форм ProForma

• jira_get_proforma_form_details — получение деталей формы

• jira_update_proforma_form_answers — обновление ответов формы

Service Desk (только Server/DC):

• jira_get_service_desk_for_project — получение сервисного деска

• jira_get_service_desk_queues — список очередей

• jira_get_queue_issues — получение задач в очереди

Инструменты Confluence (24)

Поиск:

• confluence_search — поиск контента с помощью CQL

• confluence_search_user — поиск пользователей

Страницы:

• confluence_get_page — получение содержимого страницы

• confluence_create_page — создание новой страницы

• confluence_update_page — обновление страницы

• confluence_delete_page — удаление страницы

• confluence_move_page — перемещение страницы

• confluence_get_page_children — получение дочерних страниц

• confluence_get_page_history — получение версии страницы

• confluence_get_page_diff — сравнение версий

Комментарии:

• confluence_add_comment — добавление комментария

• confluence_reply_to_comment — ответ на комментарий

• confluence_get_comments — получение комментариев страницы

Вложения:

• confluence_get_attachments — список вложений

• confluence_upload_attachment — загрузка файла

• confluence_upload_attachments — загрузка нескольких файлов

• confluence_download_attachment — скачивание файла

• confluence_download_content_attachments — скачивание всех вложений

• confluence_delete_attachment — удаление вложения

Изображения:

• confluence_get_page_images — получение изображений как встроенного содержимого

Метки:

• confluence_get_labels — получение меток контента

• confluence_add_label — добавление метки

Аналитика:

• confluence_get_page_views — получение статистики просмотров

Устранение неполадок

Ошибка «Module not found»

pip install -e .

«Authentication failed»

• Убедитесь, что токен PAT действителен и не истек

• Проверьте, что токен не был отозван

• Убедитесь в правильности URL (https://jira.elevancehealth.com)

• Попробуйте перегенерировать токен

Ошибки SSL-сертификатов

Добавьте в файл .env:

JIRA_SSL_VERIFY=false
CONFLUENCE_SSL_VERIFY=false

Сбой проверки подключения

# 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» при запуске проверки

Убедитесь, что вы находитесь в правильном каталоге:

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

Инструменты не отображаются в IDE

1. Проверьте, что в конфигурации IDE указаны правильные пути

2. Полностью перезапустите IDE

3. Проверьте журналы IDE на наличие ошибок подключения MCP

4. Убедитесь, что TOOLSETS=all указано в .env или конфигурации IDE

Рекомендации по безопасности

• ✅ Храните файл .env в тайне

• ✅ Никогда не передавайте токены PAT

• ✅ Меняйте токены каждые 6–12 месяцев

• ✅ Не коммитьте .env в систему контроля версий

• ✅ Используйте понятные имена токенов для отслеживания

• ✅ Отзывайте токены, когда они больше не нужны

Расширенная конфигурация

Фильтрация по конкретным проектам

В .env:

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

Включение подробного журналирования

В .env:

MCP_VERBOSE=true
MCP_VERY_VERBOSE=true  # Debug level

Режим только для чтения (тестирование)

В .env:

READ_ONLY_MODE=true

Это предотвращает любые операции записи (создание, обновление, удаление).

Пользовательские наборы инструментов

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

Системные требования

• Python: 3.10 или выше

• Операционная система: Windows, macOS или Linux

• Сеть: доступ к jira.elevancehealth.com

• IDE: Claude Desktop, Cursor или Windsurf с поддержкой MCP

Содержимое пакета

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

Поддержка

По вопросам или проблемам обращайтесь:

• Разработчик: Mohamed Wasim

• Электронная почта: Mohamed.Wasim@carelon.com

Следующие шаги

1. ✅ Завершите настройку, используя шаги выше

2. ✅ Запустите проверку: python validate_setup.py

3. ✅ Настройте вашу IDE

4. ✅ Перезапустите IDE

5. ✅ Начните использовать AI-ассистента с Jira/Confluence

Дополнительные ресурсы

• SETUP-GUIDE.md — подробное пошаговое руководство с описаниями скриншотов

• Оригинальная документация — https://mcp-atlassian.soomiles.com

Лицензия

Лицензия MIT — внутреннее использование для Elevance Health/Carelon

Версия: 1.0
Последнее обновление: март 2026
Поддерживается: Carelon Global Solutions