Atlassian Attachments

Atlassian Attachments

alyioxMIT
Atlassian Attachments — это MCP-сервер, который скачивает файлы, прикреплённые к задачам Jira Cloud и страницам Confluence Cloud. Официальный MCP-сервер Atlassian не умеет сохранять вложения на диск — только искать задачи и управлять контентом. Этот сервер закрывает этот пробел. Сервер рассчитан на разработчиков и инженеров, которые автоматизируют работу с Atlassian через AI-ассистентов. Вам больше не нужно вручную переходить по ссылкам — достаточно дать ассистенту ID вложения, и он скачает файл в указанную папку. Для работы потребуется Python 3.13 или свежее, аккаунт Atlassian Cloud и API токен с правом read:jira-work.
Cloud-devopsJira
Открыть на GitHub

Установка

uvx mcp-atlassian-attachments

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

Общее

  • СтатусСообщество
  • Разработчикalyiox
  • ЛицензияMIT

Технологии

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

Описание

Возможности

  • Скачивает вложение Jira Cloud по его уникальному ID
  • Сохраняет файл в указанную выходную директорию
  • Работает через официальное Atlassian REST API
  • Поддерживает scoped API токены с минимальными правами для безопасности
  • Настраивается через переменные окружения или конфигурационный файл ~/.config/mcp-atlassian-attachments/config.json
  • Запускается одной командой uvx mcp-atlassian-attachments без клонирования репозитория
  • Использует транспорт stdio, совместим со всеми MCP-клиентами (Claude Desktop, MCP Inspector и др.)
  • Распространяется по лицензии MIT, полностью бесплатен
  • Дополняет официальный Atlassian MCP, добавляя возможность скачивания файлов

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

  • 1. Убедитесь, что установлен Python версии 3.13 или новее.
  • 2. Создайте API токен Atlassian. Перейдите на страницу создания токенов. Рекомендуется создать scoped токен с правом read:jira-work — это минимальные права для работы с вложениями. Можно использовать и классический токен для полного доступа.
  • 3. Скопируйте сгенерированный токен. Он понадобится на следующем шаге.
  • 4. Установите сервер через uvx mcp-atlassian-attachments. Если uvx не установлен, сначала установите uv (менеджер пакетов Python).
  • 5. Настройте переменные окружения для сервера:

export ATLASSIAN_SITE_URL="https://yourorg.atlassian.net"
export ATLASSIAN_EMAIL="your.email@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

  • 6. Добавьте сервер в конфигурацию Claude Desktop. Отредактируйте файл claude_desktop_config.json:

{
"mcpServers": {
"atlassian-attachments": {
"command": "uvx",
"args": ["mcp-atlassian-attachments"],
"env": {
"ATLASSIAN_SITE_URL": "https://yourorg.atlassian.net",
"ATLASSIAN_EMAIL": "your.email@example.com",
"ATLASSIAN_API_TOKEN": "your-api-token"
}
}
}
}

  • 7. Перезапустите Claude Desktop. Теперь ассистент может скачивать вложения.

Альтернативно, можно создать конфигурационный файл ~/.config/mcp-atlassian-attachments/config.json с теми же полями. Переменные окружения имеют приоритет, если заданы.

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

  • «Скачай вложение Jira с ID 12345 в папку ./attachments»
  • «Сохрани вложение Confluence с ID 67890 в директорию /tmp/downloads»

Ассистент использует инструмент download_jira_attachment, передаёт ID вложения и путь для сохранения. Файл будет загружен на локальный диск.

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

  • Язык разработки: Python
  • Транспортный протокол: stdio (стандартный ввод-вывод)
  • Лицензия: MIT — сервер бесплатен для любого использования
  • Совместимые клиенты: Claude Desktop, MCP Inspector, любой MCP-клиент
  • Зависимости: Python 3.13+, аккаунт Atlassian Cloud, API токен с правом read:jira-work
  • Установка: через uvx mcp-atlassian-attachments (npm пакет не требуется)

Поделиться