a2atlassian

yoselabs
a2atlassian — MCP-сервер для подключения AI-агентов к Jira и Confluence. Он решает проблему громоздких настроек: не требует Docker, конфигурация проектов хранится в одном JSON-файле. Вы даёте агенту доступ к задачам и документации без лишних разрешений — по умолчанию включён режим только для чтения. Сервер ориентирован на разработчиков и тимлидов, которые хотят управлять задачами и базами знаний через ИИ-ассистента. Инструменты подгружаются динамически, а вывод данных упаковывается в TSV. Это сокращает расход токенов до 60% по сравнению с обычным JSON. Ошибки в JQL автоматически исправляются, а неверные поля получают подсказки. Подключения настраиваются командой --register, секреты подставляются из переменных окружения.
Ai-mlJira
Открыть на GitHub

Установка

uvx a2atlassian

Характеристики

Общее

  • СтатусСообщество
  • Разработчикyoselabs

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Быстрая привязка проектов через команду --register — агент сразу работает с нужными разделами.
  • Поиск задач в Jira по JQL-запросам — синтаксис автокорректируется, на неверные поля приходят подсказки.
  • Управление спринтами и досками: просмотр, создание, перемещение задач между статусами.
  • Полный CRUD для страниц Confluence: поиск, чтение, создание, обновление (для записи доступна только работа с метаданными).
  • Работа с комментариями, наблюдателями и временными затратами (worklogs) в задачах Jira.
  • Просмотр и изменение статусов задач — переходы по статусам с автоматической проверкой прав.
  • Компактный вывод списков в формате TSV — экономит до 60% токенов по сравнению с JSON.
  • Динамическая загрузка инструментов (deferred tools): агент использует только нужные функции, не перегружая контекст.
  • Изоляция проектов через флаг --scope: агент видит только разрешённые проекты.

Как подключить

Сервер устанавливается как обычная Python-утилита. Не требует Docker.

1. Установите a2atlassian: pip install a2atlassian или uv tool install a2atlassian.

2. Добавьте в конфигурацию MCP-клиента (например, Claude Desktop) следующую запись:

{ "mcpServers": { "a2atlassian": { "command": "uvx", "args": ["a2atlassian"], "env": { "ATLASSIAN_URL": "https://your-domain.atlassian.net", "ATLASSIAN_USER": "your-email@example.com", "ATLASSIAN_TOKEN": "your-api-token" } } } }

Для продакшена используйте переменные окружения в формате ${VAR}.

3. Перезапустите клиент (Claude Desktop, Cursor и др.).

Примеры запросов

  • «Покажи все задачи из спринта "Mobile Release 5.0", отсортированные по приоритету.»
  • «Найди в Confluence страницу "API Architecture" и добавь раздел "Error Handling".»
  • «Создай задачу Bug в проекте SUPPORT с описанием ошибки 500.»
  • «Добавь мой email в наблюдатели задачи PROJ-123.»
  • «Перенеси задачу DEV-456 в статус "In Progress" и запиши 2 часа в worklog.»

Технические детали

  • Язык: Python
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Claude Code, Cursor, VS Code и другие MCP-хосты с поддержкой deferred tools.

Поделиться