MCP Atlassian Server (от phuc-nt)

Что нового в версии 2.1.1 🚀

• Проведен рефакторинг всей кодовой базы для стандартизации структуры ресурсов/инструментов, полностью удален ресурс контента-метаданных и объединены метаданные с ресурсом страницы.

• Новое руководство для разработчиков: теперь любой желающий может легко расширять и поддерживать кодовую базу.

• Гарантированная совместимость с новейшим MCP SDK, улучшенная безопасность, масштабируемость и удобство обслуживания.

• Обновлен docs/introduction/resources-and-tools.md для удаления всех ссылок на метаданные контента.

👉 Подробности смотрите в полном списке изменений .

Related MCP server: Atlassian Confluence MCP Server

Что нового в версии 2.0.1 🎉

MCP Atlassian Server v2.0.1 предлагает значительное расширение функций и возможностей!

• Обновленные API : теперь используются новейшие API Atlassian (Jira API v3, Confluence API v2)

• Расширенные функции : количество функций увеличено с 21 до 48, включая расширенные возможности Jira и Confluence.

• Улучшенное управление доской и спринтом : полная поддержка рабочих процессов Agile/Scrum

• Расширенные функции Confluence : управление версиями страниц, обработка вложений и управление комментариями.

• Улучшенная регистрация ресурсов : исправлены проблемы с дублированием регистрации ресурсов для более стабильной работы.

• Обновление документации : новая комплексная серия документации, объясняющая архитектуру MCP, разработку ресурсов/инструментов.

Подробную информацию обо всех изменениях, улучшениях и исправлениях см. в СПИСКЕ ИЗМЕНЕНИЙ .

Введение

MCP Atlassian Server (от phuc-nt) — это сервер Model Context Protocol (MCP), который подключает агентов ИИ, таких как Cline, Claude Desktop или Cursor, к Atlassian Jira и Confluence, позволяя им запрашивать данные и выполнять действия через стандартизированный интерфейс.

Примечание: этот сервер в первую очередь разработан и оптимизирован для использования с Cline, хотя он соответствует стандарту MCP и может работать с другими MCP-совместимыми клиентами.

• Основные характеристики:

  • Подключите агентов ИИ к Atlassian Jira и Confluence

  • Поддержка как ресурсов (только для чтения), так и инструментов (действий/мутаций)

  • Простая интеграция с Cline через MCP Marketplace

  • Локальный дизайн для сред личного развития

  • Оптимизированная интеграция с помощником Cline AI

Почему этот проект

Как разработчик, работающий ежедневно с Jira и Confluence, я обнаружил, что трачу много времени на навигацию по этим инструментам. Хотя они и мощные, я жаждал более простого способа взаимодействия с ними без постоянного переключения контекста во время углубленной работы.

Появление агентов ИИ и протокола контекста модели (MCP) предоставило прекрасную возможность. Я сразу увидел потенциал для подключения Jira и Confluence (с планами для Slack, GitHub, Calendar и т. д.) к моим рабочим процессам ИИ.

Этот проект начинался как обучающее путешествие по MCP и агентам ИИ, но я надеюсь, что он превратится в нечто по-настоящему полезное для отдельных лиц и организаций, которые ежедневно взаимодействуют с инструментами Atlassian.

Архитектура системы

graph TD
    AI[Cline AI Assistant] <--> MCP[MCP Atlassian Server]
    MCP <--> JiraAPI[Jira API]
    MCP <--> ConfAPI[Confluence API]
    
    subgraph "MCP Server"
        Resources[Resources - Read Only] 
        Tools[Tools - Actions]
    end
    
    Resources --> JiraRes[Jira Resources<br/>issues, projects, users]
    Resources --> ConfRes[Confluence Resources<br/>spaces, pages]
    Tools --> JiraTools[Jira Tools<br/>create, update, transition]
    Tools --> ConfTools[Confluence Tools<br/>create page, comment]

Установка и настройка

Подробные инструкции по установке и настройке см. в нашем руководстве по установке для помощников AI . Это руководство специально отформатировано для помощников AI/LLM, таких как Клайн, чтобы читать и автоматически настраивать MCP Atlassian Server.

Примечание для пользователей Cline : руководство по установке (llms-install.md) оптимизировано для понимания и выполнения Cline AI. Вы можете просто попросить Cline "Установить MCP Atlassian Server (by phuc-nt)", и он сможет проанализировать инструкции и помочь вам настроить все пошагово.

В руководство включено:

• Предварительные условия и системные требования

• Пошаговая настройка для сред Node.js

• Настройка помощника Cline AI для подключения к Atlassian

• Получение и настройка токенов API Atlassian

• Рекомендации по безопасности и передовой опыт

Установка через Smithery

Чтобы автоматически установить Atlassian Integration Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @phuc-nt/mcp-atlassian-server --client claude

Обзор функций

MCP Atlassian Server позволяет помощникам на базе искусственного интеллекта (таким как Cline, Claude Desktop, Cursor...) получать доступ к Jira и Confluence и управлять ими с помощью полного набора функций, сгруппированных для ясности:

Джира

• Управление проблемами

  • Просмотр, поиск и фильтрация проблем

  • Создание, обновление, перенос и назначение задач

  • Добавляйте задачи в бэклог или спринт, ранжируйте задачи

• Управление проектом

  • Просмотреть список проектов, сведения о проекте и роли в проекте

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

  • Просмотр досок, конфигурации досок, проблем и спринтов на досках

  • Создание, запуск и закрытие спринтов

• Управление фильтрами

  • Просмотр, создание, обновление и удаление фильтров

• Панель управления и управление гаджетами

  • Просмотр панелей управления и гаджетов

  • Создание и обновление панелей мониторинга

  • Добавить или удалить гаджеты на панелях управления

• Управление пользователями

  • Просмотр сведений о пользователе, назначаемых пользователях и пользователях по ролям проекта

Слияние

• Управление пространством

  • Просмотр списка пространств, сведений о пространстве и страниц в пространстве

• Управление страницами

  • Просмотр, поиск и получение сведений о страницах, дочерних страницах, предках, вложениях и истории версий

  • Создание, обновление, переименование и удаление страниц

• Управление комментариями

  • Просмотр, добавление, обновление и удаление комментариев на страницах

Полное техническое описание всех функций, ресурсов и инструментов см. по адресу: docs/introduction/resources-and-tools.md

Запрос потока

sequenceDiagram
    participant User
    participant Cline as Cline AI
    participant MCP as MCP Server
    participant Atlassian as Atlassian API
    
    User->>Cline: "Find all my assigned issues"
    Cline->>MCP: Request jira://issues
    MCP->>Atlassian: API Request with Auth
    Atlassian->>MCP: JSON Response
    MCP->>Cline: Formatted MCP Resource
    Cline->>User: "I found these issues..."
    
    User->>Cline: "Create new issue about login bug"
    Cline->>MCP: Call createIssue Tool
    MCP->>Atlassian: POST /rest/api/3/issue
    Atlassian->>MCP: Created Issue Data
    MCP->>Cline: Success Response
    Cline->>User: "Created issue DEMO-123"

Примечание по безопасности

• Ваш API-токен наследует все разрешения пользователя, который его создал.

• Никогда не передавайте свой токен ненадежным лицам.

• Будьте осторожны, когда просите LLM проанализировать файлы конфигурации, содержащие ваш токен.

• Подробные инструкции по безопасности см. на сайте llms-install.md.

Внести свой вклад и поддержать

• Внесите свой вклад, открыв запросы на включение внесенных изменений или проблемы на GitHub.

• Присоединяйтесь к сообществу MCP/Cline для получения дополнительной поддержки.