MCP Atlassian Server

MCP Atlassian Server (от phuc-nt)

Введение

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.

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

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

Подробные инструкции по установке и настройке см. в нашем руководстве по установке для помощников 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 :

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

Подробную документацию по всем ресурсам и инструментам см. в разделе Справочник по ресурсам и инструментам.

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

Примеры использования

Попробуйте задать Клайну следующие вопросы после установки:

1. Создание и управление задачами
   • «Создать новую проблему в проекте DEMO об ошибках входа»
   • «Найти все задачи, назначенные мне в текущем спринте»
   • «Перевести задачу DEMO-43 в статус «Выполнено»»
2. Краткое описание проекта
   • «Обобщите все вопросы в проекте DEMO»
   • «Кому поручены задачи в проекте DEMO?»
   • «Список неназначенных задач в текущем спринте»
3. Документация с Confluence
   • «Создайте страницу Confluence под названием «Заметки о встрече»»
   • «Обновите страницу Confluence «Документация API» новыми примерами и метками»
   • «Добавьте метку «документация» на страницу об архитектуре»
   • «Удалить метку «черновик» со страницы «Заметки о собрании»»
   • «Добавьте комментарий на страницу Confluence о документации API»
4. Анализ и отчетность
   • «Сравните количество завершенных задач между текущим и предыдущим спринтом»
   • «У кого больше всего задач в статусе «Сделать»?»

Эти запросы лучше всего работают в среде Cline, которая была тщательно протестирована с этим сервером MCP.

Заметки об использовании

1. Простой JQL : при поиске проблем используйте простой JQL без пробелов и специальных символов (например, project=DEMO вместо project = DEMO AND key = DEMO-43 ).
2. Создать страницу Confluence : при создании страницы Confluence используйте простой HTML-контент и не указывайте parentId, чтобы избежать ошибок.
3. Обновление страницы Confluence : при обновлении страницы всегда включайте текущий номер версии, чтобы избежать конфликтов. Вы также можете обновлять метки (добавлять/удалять) и должны использовать допустимый формат хранения для контента.
4. Создать задачу : при создании новых задач указывайте только минимально необходимые поля (projectKey, summary) для достижения наилучшего результата.
5. Права доступа : убедитесь, что настроенная учетная запись Atlassian имеет доступ к проектам и пространствам, с которыми вы хотите взаимодействовать.

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

• Ваш API-токен наследует все разрешения пользователя, который его создал.
• Никогда не передавайте свой токен ненадежным лицам.
• Будьте осторожны, когда просите LLM проанализировать файлы конфигурации, содержащие ваш токен.
• Подробные инструкции по безопасности см. на сайте llms-install.md.

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

• Внесите свой вклад, открыв запросы на включение внесенных изменений или проблемы на GitHub.
• Присоединяйтесь к сообществу MCP/Cline для получения дополнительной поддержки.

MCP Atlassian Server (от phuc-nt) готов к установке в один клик из Cline Marketplace!
Подробные инструкции смотрите в llms-install.md

Хотя сервер использует открытый стандарт MCP, он в первую очередь разработан и протестирован для пользователей Cline.