Добавить сервер
sooperset/mcp-atlassian
  1. Каталог MCP
  2. sooperset/mcp-atlassian

sooperset/mcp-atlassian

от sooperset
Ищет задачи в Jira, создаёт и обновляет тикеты, редактирует страницы Confluence. Поддерживает Cloud и Data Center.
GithubPyPiСайт сервера

MCP Atlassian

PyPI Version PyPI - Downloads PePy - Total Downloads Run Tests License Docs

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). Supports both Cloud and Server/Data Center deployments.

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

Confluence Demo

Quick Start

1. Get Your API Token

Go to https://id.atlassian.com/manage-profile/security/api-tokens and create a token.

For Server/Data Center, use a Personal Access Token instead. See Authentication.

2. Configure Your IDE

Add to your Claude Desktop or Cursor MCP configuration:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Часто задаваемые вопросы

Инструменты были проиндексированы:
confluence_add_comment

Добавляет комментарий на страницу Confluence. Аргументы: ctx: Контекст FastMCP. page_id: ID страницы, на которую нужно добавить комментарий. body: Содержимое комментария в формате Markdown. Возвращает: Строку JSON, представляющую созданный комментарий. Исключения: ValueError: Если включён режим только для чтения или клиент Confluence недоступен.

Комментировать

Параметры
  • bodystringобязательный

    Содержимое комментария в формате Markdown

  • page_idstringобязательный

    Идентификатор страницы, на которую нужно добавить комментарий.

confluence_add_inline_comment

Добавляет встроенный комментарий, привязанный к выделенному тексту на странице. Аргументы: ctx: Контекст FastMCP. page_id: ID страницы, к которой нужно добавить встроенный комментарий. body: Содержимое комментария в формате Markdown. text_selection: Точный текст на странице, к которому привязывается комментарий. text_selection_match_count: Общее количество вхождений выбранного текста на странице. text_selection_match_index: Индекс вхождения (начиная с нуля), к которому привязываться. Возвращает: Строку JSON, представляющую созданный встроенный комментарий. Вызывает: ValueError: Если включён режим «только для чтения» или клиент Confluence недоступен.

Добавить встроенный комментарий

Параметры
  • bodystringобязательный

    Содержимое комментария в формате Markdown

  • page_idstringобязательный

    Идентификатор страницы, к которой добавляется инлайн-комментарий.

  • text_selectionstringобязательный

    Точный текст на странице, к которому привязывается встроенный комментарий. Должен совпадать с текстом, присутствующим в содержимом страницы.

  • text_selection_match_countinteger

    Общее количество вхождений выбранного текста на странице. По умолчанию 1.

  • text_selection_match_indexinteger

    Индекс с отсчетом от нуля, определяющий, какое вхождение текста использовать в качестве якоря. По умолчанию 0 (первое вхождение).

confluence_add_label

Добавить метку к содержимому Confluence (страницы, записи блогов или вложения). Полезно для: - Категоризации вложений (например, 'screenshot', 'diagram', 'legal-doc') - Отслеживания статуса (например, 'approved', 'needs-review', 'archived') - Фильтрации содержимого по теме или версии Аргументы: ctx: контекст FastMCP. page_id: идентификатор содержимого (страницы или вложения). name: имя добавляемой метки. Возвращает: Строку JSON, представляющую обновлённый список объектов меток. Исключения: ValueError: если включён режим только для чтения или клиент Confluence недоступен.

Добавить метку

Параметры
  • namestringобязательный

    Название метки для добавления (строчными буквами, без пробелов). Примеры: 'draft', 'reviewed', 'confidential', 'v1.0'. Метки помогают упорядочивать и классифицировать контент.

  • page_idstringобязательный

    Преобразует идентификатор контента Confluence в метку. Для страниц и блогов: числовой идентификатор (например, '123456789'). Для вложений: идентификатор с префиксом 'att' (например, 'att123456789'). Используйте get_attachments для поиска идентификаторов вложений.

confluence_check_content_permissionsтолько чтение

Проверяет, может ли пользователь или группа выполнить операцию над конкретным контентом. Обёртка для POST /wiki/rest/api/content/{id}/permission/check. Примечание: Этот инструмент доступен только для Confluence Cloud. Экземпляры Server/Data Center используют другие API разрешений. Возвращает JSON-объект с булевым полем 'hasPermission', указывающим, есть ли у субъекта запрошенное разрешение на контент.

Проверить разрешения контента

Параметры
  • content_idstringобязательный

    Идентификатор содержимого Confluence (страница, запись в блоге, комментарий или вложение). Пример: '123456789'

  • operationstringобязательный

    Проверяемая операция. Типичные значения: 'read', 'update', 'delete', 'export', 'purge', 'administer', 'create_or_delete_from_view'.

  • subject_typestring

    Определяет тип субъекта: 'user' или 'group'. По умолчанию - 'user'.

  • user_identifierstringобязательный

    Идентификатор учётной записи пользователя (для subject_type='user') или идентификатор группы (для subject_type='group'). Пример идентификатора пользователя: '5b10a2844c20165700ede21g'

confluence_copy_page

Копирует страницу Confluence в новое место. В Confluence Cloud используется встроенный endpoint копирования. В Server/Data Center тело страницы загружается, и новая страница создается вручную (вложения по пути Server/DC не копируются). Аргументы: ctx: Контекст FastMCP. source_page_id: ID копируемой страницы. destination_space_key: Ключ пространства для новой страницы. new_title: Заголовок новой скопированной страницы. destination_parent_id: Необязательный ID родительской страницы в целевом пространстве. copy_attachments: Копировать ли вложения (только для Cloud). Возвращает: Строку JSON с данными новой страницы. Вызывает: ValueError: Если клиент Confluence не настроен или недоступен.

Скопировать страницу

Параметры
  • copy_attachmentsboolean

    (Необязательно) Определяет, нужно ли копировать вложения на новую страницу. По умолчанию true. Поддерживается только в Confluence Cloud.

  • destination_parent_idstring

    (Необязательно) Идентификатор родительской страницы в целевом пространстве. Если не указан, страница создается в корне пространства.

  • destination_space_keystringобязательный

    Ключ пространства для новой страницы (например, «DEV», «TEAM»)

  • new_titlestringобязательный

    Заголовок новой скопированной страницы

  • source_page_idstringобязательный

    Идентификатор страницы для копирования.

confluence_create_page

Создаёт новую страницу Confluence. Аргументы: ctx: Контекст FastMCP. space_key: Ключ пространства. title: Заголовок страницы. content: Содержимое страницы (формат зависит от content_format). Взаимоисключающий с content_file; должен быть указан ровно один из них. content_file: Путь к файлу для чтения тела страницы (UTF-8). Полезен для содержимого, слишком большого для передачи в виде аргумента инструмента. parent_id: ID родительской страницы (необязательно). content_format: Формат содержимого ('markdown', 'wiki', 'storage' или 'xhtml'). enable_heading_anchors: Включить ли якоря для заголовков (только markdown). include_content: Включить ли содержимое страницы в ответ. emoji: Эмодзи для заголовка страницы (иконка, отображаемая в навигации). page_width: Ширина макета страницы ('full-width' или 'default'). table_layout: Предустановка ширины таблицы ('full-width', 'wide', 'default'). Возвращает: Строку JSON, представляющую созданный объект страницы. Вызывает: ValueError: Если включён режим только для чтения, недоступен клиент Confluence или неверный content_format.

Создать страницу

Параметры
  • contentstring

    Содержимое страницы. Формат зависит от параметра content_format. Формат может быть Markdown (по умолчанию), вики-разметкой, storage-форматом или XHTML storage-форматом. Нужно передать либо 'content', либо 'content_file', но не оба сразу.

  • content_filestring

    (Необязательно) Абсолютный или относительный путь в файловой системе, из которого считывается содержимое страницы (UTF-8). Используйте его вместо 'content', когда содержимое слишком велико для удобной передачи в качестве аргумента инструмента. Несовместим с 'content'.

  • content_formatstring

    (Необязательно) Формат параметра content. Варианты: 'markdown' (по умолчанию), 'wiki', 'storage' или 'xhtml'. Используйте 'xhtml' при передаче формата хранения Confluence XHTML (то же, что и 'storage'). Формат 'wiki' использует синтаксис вики-разметки Confluence.

  • emojistring

    (Необязательно) Эмодзи заголовка страницы (значок, отображаемый в навигации). Можно использовать любой символ эмодзи, например '📝', '🚀', '📚'. Установите null/None, чтобы удалить.

  • enable_heading_anchorsboolean

    (Необязательно) Включает ли автоматическую генерацию якорей заголовков. Применяется только когда content_format имеет значение 'markdown'.

  • include_contentboolean

    (Необязательно) Определяет, включать ли содержимое страницы в ответ. По умолчанию false, поскольку вызывающая сторона уже имеет содержимое на момент создания.

  • page_widthstring

    (Необязательно) Ширина макета страницы. Варианты: 'full-width', 'default'. По умолчанию равно null (значение по умолчанию Confluence).

  • parent_idstring

    (Необязательно) идентификатор родительской страницы. Если указан, эта страница будет создана как дочерняя для указанной страницы.

  • space_keystringобязательный

    Ключ пространства, в котором нужно создать страницу (обычно короткий код заглавными буквами, например 'DEV', 'TEAM' или 'DOC')

  • subtypestring

    Необязательный подтип страницы Confluence. Используйте 'live' для создания Confluence Live Doc. Поддерживается только для Confluence Cloud.

  • table_layoutstring

    Необязательный пресет ширины таблицы, применяемый ко всем таблицам Markdown. Варианты: 'full-width' (1800 px), 'wide' (960 px), 'default' (760 px). Применяется только когда content_format имеет значение 'markdown'.

  • titlestringобязательный

    Заголовок страницы

confluence_create_page_from_template

Создаёт новую Cloud-страницу, предварительно заполненную содержимым шаблона. Эта операция доступна только для Confluence Cloud. Извлекает указанный шаблон и создаёт страницу с его содержимым в формате storage-format. Страницу можно отредактировать впоследствии с помощью confluence_update_page.

Создает страницу из шаблона

Параметры
  • parent_idstring

    Необязательный идентификатор родительской страницы.

  • space_keystringобязательный

    Ключ пространства, в котором нужно создать страницу.

  • template_idstringобязательный

    Идентификатор шаблона, используемого в качестве тела страницы.

  • titlestringобязательный

    Заголовок для новой страницы.

confluence_delete_attachment

Навсегда удалить вложение из Confluence. Предупреждение: Это действие нельзя отменить! Вложение и ВСЕ его версии будут навсегда удалены. Используйте этот инструмент, чтобы: - Удалить устаревшие или некорректные вложения - Очистить дублирующиеся файлы - Удалить конфиденциальную информацию, случайно загруженную Рекомендации: - Проверьте ID вложения перед удалением с помощью get_attachments - Сначала скачайте вложение для резервной копии - Согласуйте с владельцами контента перед удалением общих вложений Аргументы: ctx: контекст FastMCP. attachment_id: ID удаляемого вложения. Возвращает: Строку JSON с подтверждением удаления и ID вложения.

Удалить вложение

Параметры
  • attachment_idstringобязательный

    Идентификатор вложения для удаления. Идентификаторы вложений можно найти с помощью инструмента get_attachments. Пример: 'att123456789'. Предупреждение: Это действие безвозвратно удаляет вложение и все его версии.

confluence_delete_page

Удаляет существующую страницу Confluence. Аргументы: ctx: Контекст FastMCP. page_id: ID страницы для удаления. Возвращает: Строку JSON с результатом — успех или ошибка. Вызывает: ValueError: Если клиент Confluence не настроен или недоступен.

Удалить страницу

Параметры
  • page_idstringобязательный

    Идентификатор страницы для удаления

confluence_download_attachmentтолько чтение

Загружает вложение из Confluence как встроенный ресурс. Возвращает содержимое вложения в виде встроенного ресурса с base64-кодировкой, чтобы оно было доступно по протоколу MCP без необходимости доступа к файловой системе на сервере. Файлы размером более 50 МБ не загружаются встроенно — вместо этого возвращается описательное сообщение об ошибке. Аргументы: ctx: Контекст FastMCP. attachment_id: Идентификатор вложения. Возвращает: EmbeddedResource с base64-кодированным содержимым или TextContent с сообщением об ошибке или превышении размера.

Скачать вложение

Параметры
  • attachment_idstringобязательный

    ID вложения для загрузки (например, 'att123456789'). Найдите ID вложений с помощью инструмента get_attachments. Пример: get_attachments(content_id) → используйте полученный ID здесь.

confluence_download_content_attachmentsтолько чтение

Загружает все вложения для элемента Confluence как встроенные ресурсы. Возвращает содержимое вложений в виде строк в кодировке base64, чтобы они были доступны через протокол MCP без обращения к файловой системе на сервере. Файлы размером больше 50 МБ пропускаются — в сводке появляется запись об ошибке. Аргументы: ctx: Контекст FastMCP. content_id: ID элемента. Возвращает: Список, содержащий текстовую сводку и по одному EmbeddedResource на каждое успешно загруженное вложение.

Скачать все вложения контента

Параметры
  • content_idstringобязательный

    Идентификатор контента Confluence (страницы или записи в блоге), из которого нужно скачать вложения. Пример: '123456789'

confluence_get_attachmentsтолько чтение

Выводит список всех вложений для элемента Confluence (страницы или записи в блоге). Возвращает метаданные о вложениях: - ID вложения, название и тип файла - Размер файла и URL для скачивания - Даты создания / изменения - Информацию о версии Важно: Confluence API возвращает application/octet-stream в качестве медиатипа для большинства бинарных файлов (PNG, JPG, PDF) вместо конкретных типов вроде image/png. Для фильтрации по типу файла надёжнее использовать параметр filename (например, filename='*.png' — если поддерживается сопоставление по шаблону, или точное имя файла). Пригодится, чтобы: - Узнать, какие файлы прикреплены к странице - Получить ID вложений для операций скачивания - Проверить, существует ли конкретный файл - Вывести список изображений или документов для обработки Аргументы: ctx: контекст FastMCP. content_id: ID элемента. start: начальный индекс для пагинации. limit: максимальное количество результатов (1–100). filename: опциональный фильтр по точному имени файла. media_type: опциональный фильтр по MIME-типу (учитывайте: большинство бинарников возвращают application/octet-stream). Возвращает: JSON-строку со списком вложений и метаданными.

Получить вложения контента

Параметры
  • content_idstringобязательный

    ID контента Confluence (страницы или записи в блоге), для которого нужно вывести список вложений. Пример: '123456789'

  • filenamestring

    (Необязательно) Фильтрует результаты, оставляя только вложения, соответствующие этому имени файла. Только точное совпадение. Пример: 'report.pdf'

  • limitinteger

    (Необязательно) Максимальное количество вложений, возвращаемых за один запрос (1-100). Используйте пагинацию (start/limit) для больших списков вложений. По умолчанию: 50

  • media_typestring

    (Необязательно) Фильтр по MIME-типу. Примечание: API Confluence возвращает 'application/octet-stream' для большинства бинарных файлов (PNG, JPG, PDF) вместо конкретных MIME-типов, таких как 'image/png'. Для более надёжной фильтрации используйте параметр 'filename'. Примеры: 'application/octet-stream' (бинарные файлы), 'application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' (для .docx)

  • startinteger

    (Необязательно) Начальный индекс для пагинации. Используйте 0 для первой страницы. Чтобы получить следующую страницу, добавьте значение 'limit' к 'start'. По умолчанию: 0

confluence_get_commentsтолько чтение

Получает комментарии для конкретной страницы Confluence. Args: ctx: Контекст FastMCP. page_id: ID страницы Confluence. Returns: Строка JSON, представляющая список объектов комментариев.

Получить комментарии

Параметры
confluence_get_inline_commentsтолько чтение

Получает все инлайн-комментарии для страницы Confluence. Args: ctx: Контекст FastMCP. page_id: ID страницы, для которой нужно получить инлайн-комментарии. Returns: JSON-строка со списком инлайн-комментариев. Raises: ValueError: Если клиент Confluence недоступен.

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

Параметры
  • page_idstringобязательный

    Идентификатор страницы, из которой нужно получить инлайн-комментарии.

confluence_get_labelsтолько чтение

Получить метки для контента Confluence (страницы, записи в блогах или вложения). Аргументы: ctx: контекст FastMCP. page_id: ID контента Confluence (страницы или вложения). Возвращает: строку JSON, представляющую список объектов меток.

Получить метки

Параметры
  • page_idstringобязательный

    Идентификатор контента Confluence (страница, запись в блоге или вложение). Для страниц: числовой идентификатор из URL (например, '123456789'). Для вложений: идентификатор с префиксом 'att' (например, 'att123456789'). Работает с любым типом контента Confluence, поддерживающим метки.

confluence_get_pageтолько чтение

Возвращает содержимое указанной страницы Confluence по её ID, или по заголовку и ключу раздела. Аргументы: ctx: Контекст FastMCP. page_id: ID страницы Confluence, полный URL страницы или короткая ссылка. Если передан, 'title' и 'space_key' игнорируются. title: Точный заголовок страницы. Должен использоваться с 'space_key'. space_key: Ключ раздела. Должен использоваться с 'title'. include_metadata: Включать ли метаданные страницы. convert_to_markdown: Преобразовать содержимое в Markdown (true) или оставить сырой HTML (false). Возвращает: Строку JSON с содержимым страницы и/или метаданными, или ошибку, если страница не найдена или параметры некорректны.

Получить страницу

Параметры
  • convert_to_markdownboolean

    Преобразовывать ли страницу в Markdown (true) или сохранять её в исходном формате HTML (false). Исходный HTML может показывать макросы (например, даты), невидимые в Markdown, но ОСТОРОЖНО: использование HTML значительно увеличивает расход токенов в ответах ИИ.

  • include_metadataboolean

    Включать ли метаданные страницы, такие как дата создания, дата последнего обновления, версия и метки.

  • page_idstring

    Идентификатор страницы Confluence, полный URL страницы или короткая ссылка. Например: '123456789', 'https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title' или 'https://example.atlassian.net/wiki/x/N4CIO'. Укажите это ИЛИ оба параметра 'title' и 'space_key'. Если передан page_id, параметры title и space_key будут проигнорированы.

  • space_keystring

    Ключ пространства Confluence, где находится страница (например, 'DEV', 'TEAM'). Обязателен при использовании 'title'.

  • titlestring

    Точное название страницы Confluence. Используйте его вместе с 'space_key', если 'page_id' неизвестен.

confluence_get_page_childrenтолько чтение

Получает дочерние страницы и папки указанной страницы Confluence. Аргументы: ctx: Контекст FastMCP. parent_id: ID родительской страницы. expand: Поля для раскрытия. limit: Максимальное количество дочерних элементов. include_content: Включать ли содержимое страницы. convert_to_markdown: Преобразовывать содержимое в Markdown, если include_content=true. start: Начальный индекс для постраничного вывода. include_folders: Включать ли дочерние папки (по умолчанию True). Возвращает: JSON-строка, представляющая список объектов дочерних страниц и папок.

Получить дочерние страницы

Параметры
  • convert_to_markdownboolean

    Определяет, преобразовывать ли содержимое страницы в Markdown (true) или оставлять его в необработанном HTML-формате (false). Имеет значение только если include_content равно true.

  • expandstring

    Поля, которые нужно развернуть в ответе (например, 'version', 'body.storage')

  • include_contentboolean

    Следует ли включать содержимое страницы в ответ

  • include_foldersboolean

    Включать ли вложенные папки в дополнение к вложенным страницам.

  • limitinteger

    Максимальное количество возвращаемых дочерних элементов (1-50)

  • parent_idstringобязательный

    Идентификатор родительской страницы, дочерние элементы которой вы хотите получить.

  • startinteger

    Начальный индекс для пагинации (с нуля)

confluence_get_page_diffтолько чтение

Получить унифицированный diff между двумя версиями страницы Confluence. Аргументы: ctx: Контекст FastMCP. page_id: ID страницы Confluence. from_version: Номер исходной версии. to_version: Номер целевой версии. Возвращает: JSON-строку с информацией о странице и унифицированным diff.

Получить разницу версий страницы

Параметры
  • from_versionintegerобязательный

    Номер версии источника

  • page_idstringобязательный

    Идентификатор страницы Confluence (числовой идентификатор, его можно найти в URL страницы). Например, в 'https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title' идентификатор страницы - '123456789'.

  • to_versionintegerобязательный

    Целевой номер версии

confluence_get_page_historyтолько чтение

Получить историческую версию конкретной страницы Confluence. Аргументы: ctx: Контекст FastMCP. page_id: ID страницы Confluence. version: Номер версии, которую нужно получить. convert_to_markdown: Преобразовывать содержимое в markdown (true) или оставлять сырой HTML (false). Возвращает: Строку JSON с содержимым страницы на указанной версии.

Get Page History

Параметры
  • convert_to_markdownboolean

    Преобразовывать ли страницу в Markdown (true) или сохранять её в исходном формате HTML (false). Исходный HTML может показывать макросы (например, даты), невидимые в Markdown, но ОСТОРОЖНО: использование HTML значительно увеличивает расход токенов в ответах ИИ.

  • page_idstringобязательный

    Идентификатор страницы Confluence (числовой идентификатор, его можно найти в URL страницы). Например, в 'https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title' идентификатор страницы - '123456789'.

  • versionintegerобязательный

    Номер версии страницы, которую нужно получить.

confluence_get_page_imagesтолько чтение

Получить все изображения, прикреплённые к странице Confluence, как встроенный контент изображений. Фильтрует вложения, оставляя только изображения (PNG, JPEG, GIF, WebP, SVG, BMP), и возвращает их как ImageContent в кодировке base64 — клиенты могут отображать их напрямую. Вложения, не являющиеся изображениями, исключаются. Файлы с неоднозначными MIME-типами (application/octet-stream) определяются по расширению имени файла как запасной вариант. Изображения размером более 50 МБ пропускаются с записью об ошибке в сводке. Args: ctx: Контекст FastMCP. content_id: Идентификатор контента. Returns: Список с текстовой сводкой, за которой следует один ImageContent на каждое успешно загруженное изображение.

Получить изображения страницы

Параметры
  • content_idstringобязательный

    Идентификатор страницы Confluence или записи в блоге, из которой нужно получить изображения. Пример: '123456789'

confluence_get_page_restrictionsтолько чтение

Получает ограничения на просмотр и редактирование страницы Confluence. Возвращает текущие списки ограничений для операций чтения (просмотра) и обновления (редактирования). Пустой список означает, что страница не ограничена для этой операции. Параметры: ctx: Контекст FastMCP. page_id: ID страницы. Результат: Строка JSON со списками ограничений read и update, каждый содержит users (account IDs) и groups (group names). Исключения: ValueError: Если клиент Confluence не настроен или недоступен.

Получить ограничения страницы

Параметры
  • page_idstringобязательный

    ID страницы.

confluence_get_page_templateтолько чтение

Получает шаблон страницы Cloud по ID, включая его тело в формате хранения.

Получает шаблон страницы.

Параметры
  • template_idstringобязательный

    Идентификатор шаблона для получения.

confluence_get_page_viewsтолько чтение

Получить статистику просмотров страницы Confluence. Примечание: этот инструмент доступен только для Confluence Cloud. Серверные экземпляры и Data Center не поддерживают Analytics API. Аргументы: ctx: контекст FastMCP. page_id: идентификатор страницы Confluence. include_title: нужно ли включать заголовок страницы в ответ. Возвращает: строку JSON со статистикой просмотров страницы, включая общее количество просмотров и дату последнего просмотра.

Получить просмотры страниц

Параметры
  • include_titleboolean

    Нужно ли получать и включать заголовок страницы.

  • page_idstringобязательный

    Идентификатор страницы Confluence (числовой идентификатор, его можно найти в URL страницы). Например, в 'https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title' идентификатор страницы - '123456789'.

confluence_get_space_page_treeтолько чтение

Получает иерархию страниц пространства Confluence в виде плоского списка. Возвращает страницы с атрибутами parent_id и depth для эффективной обработки токенов. Фильтруйте по depth, чтобы сосредоточиться на нужных разделах, или ищите страницы по названию. Гораздо эффективнее, чем рисовать полные ASCII-деревья. Используйте этот инструмент, чтобы понять структуру пространства перед созданием или перемещением страниц. Аргументы: ctx: Контекст FastMCP. space_key: Идентификатор ключа пространства. limit: Максимальное количество страниц для загрузки (начинайте со 100 для более быстрого результата). Возвращает: JSON с полями space_key, total_pages и массивом pages, содержащим {id, title, parent_id, position, depth} для каждой страницы. Корневые страницы имеют parent_id: null и depth: 0.

Получает структуру страниц пространства (Space Page Tree).

Параметры
  • limitinteger

    Максимум страниц для загрузки

  • space_keystringобязательный

    Клавиша пробела.

confluence_get_space_permissionsтолько чтение

Выводит все назначения прав доступа для пространства Confluence. Обёртка над GET /wiki/api/v2/spaces/{id}/permissions. Важно: этот инструмент работает только в Confluence Cloud. В версиях Server и Data Center используются другие API для прав доступа. Возвращает JSON-объект со списком 'results', содержащим объекты назначений прав. Каждая запись включает субъект (пользователя или группу), разрешённую операцию и цель. Используйте этот инструмент, чтобы проверить, у кого есть доступ к пространству.

Получить разрешения пространства

Параметры
  • cursorstring

    Необязательный курсор пагинации из предыдущего ответа.

  • limitinteger

    Максимальное количество возвращаемых записей о разрешениях. По умолчанию равно 25.

  • space_idstringобязательный

    Числовой идентификатор пространства Confluence. Это внутренний идентификатор пространства, а не его ключ. Пример: '98304'. Идентификатор пространства можно найти через Confluence REST API (GET /wiki/api/v2/spaces) или по URL пространства.

confluence_list_page_templatesтолько чтение

Получает список шаблонов содержимого страниц Confluence. Эта операция доступна только для Confluence Cloud. Возвращает метаданные шаблона (ID, имя, описание, тип) без полного содержимого. Используйте confluence_get_page_template для получения содержимого шаблона.

Список шаблонов страниц

Параметры
  • limitinteger

    Максимальное количество шаблонов для возврата.

  • space_keystring

    Необязательный space key для вывода списка шаблонов, определённых в этом пространстве. Если не указан, возвращаются глобальные шаблоны.

confluence_move_page

Перемещает страницу Confluence к новому родителю или в другое пространство. Аргументы: ctx: Контекст FastMCP. page_id: ID перемещаемой страницы. target_parent_id: ID целевой родительской страницы. target_space_key: Ключ целевого пространства для перемещения между пространствами. position: Позиция относительно целевого объекта ('append', 'above' или 'below'). Возвращает: Строку JSON с объектом перемещённой страницы. Вызывает: ValueError: Если не указаны ни target_parent_id, ни target_space_key, или если клиент Confluence не настроен.

Переместить страницу

Параметры
  • page_idstringобязательный

    ID страницы для перемещения

  • positionstring

    Позиция: 'append' (по умолчанию, переместить как дочерний элемент цели), 'above' (переместить перед целью как родственный элемент) или 'below' (переместить после цели как родственный элемент).

  • target_parent_idstring

    Идентификатор целевой родительской страницы. Если опущен, а указан target_space_key, перемещает в корень пространства.

  • target_space_keystring

    Ключ целевого пространства для перемещений между пространствами.

confluence_reply_to_comment

Отвечает в существующую ветку комментариев на странице Confluence. Аргументы: ctx: Контекст FastMCP. comment_id: ID родительского комментария, на который нужно ответить. body: Текст ответа в формате Markdown. Возвращает: Строку JSON с созданным ответным комментарием. Исключения: ValueError: Если включён режим только для чтения или клиент Confluence недоступен.

Ответить на комментарий

Параметры
  • bodystringобязательный

    Содержимое ответа в формате Markdown

  • comment_idstringобязательный

    Идентификатор родительского комментария, на который нужно ответить.

confluence_searchтолько чтение

Ищет содержимое Confluence по простым запросам или CQL. Аргументы: ctx: Контекст FastMCP. query: Поисковый запрос — обычный текст или строка CQL. limit: Максимальное количество результатов (1-50). spaces_filter: Список ключей пространств через запятую для фильтрации. Возвращает: Строку JSON со списком упрощённых объектов страниц Confluence.

Поиск контента

Параметры
  • limitinteger

    Максимальное количество результатов

  • querystringобязательный

    Поисковый запрос: либо простой текст (например, 'project documentation'), либо строка запроса CQL. Простые запросы по умолчанию используют 'siteSearch', как и поиск в WebUI, и автоматически переключаются на 'text', если 'siteSearch' не поддерживается. Примеры CQL: - Базовый поиск: 'type=page AND space=DEV' - Поиск по личному пространству: 'space="~username"' (примечание: ключи личных пространств, начинающиеся с , нужно заключать в кавычки) - Поиск по заголовку: 'title"Meeting Notes"' - Поиск через siteSearch: 'siteSearch ~ "important concept"' - Поиск по тексту: 'text ~ "important concept"' - Недавний контент: 'created >= "2023-01-01"' - Контент с определённой меткой: 'label=documentation' - Недавно изменённый контент: 'lastModified > startOfMonth("-1M")' - Контент, изменённый в этом году: 'creator = currentUser() AND lastModified > startOfYear()' - Контент, в который вы недавно вносили изменения: 'contributor = currentUser() AND lastModified > startOfWeek()' - Контент, который отслеживает пользователь: 'watcher = "user@domain.com" AND type = page' - Точная фраза в контенте: 'text ~ ""Urgent Review Required"" AND label = "pending-approval"' - Подстановочные символы в заголовке: 'title ~ "Minutes*" AND (space = "HR" OR space = "Marketing")' Примечание: специальные идентификаторы в CQL нужно правильно заключать в кавычки: ключи личных пространств (например, "~username"), зарезервированные слова, числовые идентификаторы и идентификаторы со специальными символами.

  • spaces_filterstring

    (Необязательно) Список ключей пространств через запятую для фильтрации результатов. Переопределяет переменную окружения CONFLUENCE_SPACES_FILTER, если она задана. Используйте пустую строку, чтобы отключить фильтрацию.

confluence_search_userтолько чтение

Ищет пользователей Confluence с помощью CQL (Cloud) или API участников группы (Server/DC). Аргументы: ctx: Контекст FastMCP. query: Строка поиска - запрос CQL для поиска пользователей. limit: Максимальное количество результатов (1-50). group_name: Группа для поиска на Server/DC. Возвращает: JSON-строку со списком упрощённых объектов результатов поиска пользователей Confluence.

Поиск пользователя

Параметры
  • group_namestring

    Группа для поиска на инстансах Server/DC (по умолчанию: 'confluence-users'). Игнорируется на Cloud.

  • limitinteger

    Максимальное количество результатов

  • querystringобязательный

    Поисковый запрос - строка запроса CQL для поиска пользователей. Примеры CQL: - Базовый поиск пользователя по полному имени: 'user.fullname ~ "First Last"' Примечание: специальные идентификаторы требуют правильного заключения в кавычки в CQL: ключи личных пространств (например, "~username"), зарезервированные слова, числовые идентификаторы и идентификаторы со специальными символами.

confluence_set_page_restrictions

Устанавливает ограничения на просмотр и редактирование страницы Confluence. Заменяет все существующие ограничения переданными списками. Если опустить все параметры (или передать пустые списки), удаляются все ограничения. Аргументы: ctx: Контекст FastMCP. page_id: ID страницы, на которую накладываются ограничения. read_users: ID учётных записей / имена пользователей, которым разрешён просмотр страницы. read_groups: Имена групп, которым разрешён просмотр страницы. edit_users: ID учётных записей / имена пользователей, которым разрешено редактирование страницы. edit_groups: Имена групп, которым разрешено редактирование страницы. Возвращает: Строку JSON с обновлёнными списками ограничений. Исключения: ValueError: Если клиент Confluence не настроен или недоступен.

Установить ограничения страницы

Параметры
  • edit_groupsstring[]

    (Необязательно) Названия групп, которым разрешено редактировать страницу.

  • edit_usersstring[]

    (Необязательно) Идентификаторы аккаунтов (Cloud) или имена пользователей (Server/DC), которым разрешено редактировать страницу.

  • page_idstringобязательный

    Идентификатор страницы, которую нужно ограничить.

  • read_groupsstring[]

    (Необязательно) Имена групп, которым разрешено просматривать страницу.

  • read_usersstring[]

    (Необязательно) Идентификаторы учетных записей (Cloud) или имена пользователей (Server/DC), которым разрешено просматривать страницу. Пустой список = без ограничений.

confluence_update_page

Обновляет существующую страницу Confluence. Аргументы: ctx: Контекст FastMCP. page_id: ID обновляемой страницы. title: Новый заголовок страницы. content: Новое содержимое страницы (формат зависит от content_format). Взаимоисключающ с content_file; нужно указать ровно один из них. content_file: Путь к файлу на диске для чтения нового тела страницы (UTF-8). Удобен для тел, слишком больших для передачи как inline-аргумента инструмента. is_minor_edit: Является ли это правкой без значительных изменений. version_comment: Необязательный комментарий для этой версии. parent_id: Необязательный новый ID родительской страницы. content_format: Формат содержимого ('markdown', 'wiki', 'storage' или 'xhtml'). enable_heading_anchors: Включать ли якоря для заголовков (только для markdown). include_content: Включать ли содержимое страницы в ответ. emoji: Необязательный эмодзи для заголовка страницы (иконка, отображаемая в навигации). page_width: Необязательная ширина макета страницы ('full-width' или 'default'). table_layout: Необязательный предустановленный предел ширины таблиц ('full-width', 'wide', 'default'). Возвращает: Строку JSON, представляющую обновлённый объект страницы. Исключения: ValueError: Если клиент Confluence не настроен, недоступен или передан неверный content_format.

Обновить страницу

Параметры
  • contentstring

    Получает и запрашивает актуальную документацию и примеры кода из Context7 для любой программной библиотеки или фреймворка. Сначала необходимо вызвать инструмент 'Resolve Context7 Library ID', чтобы получить точный идентификатор библиотеки, совместимый с Context7 и необходимый для использования этого инструмента, ЗА ИСКЛЮЧЕНИЕМ случаев, когда пользователь явно указывает идентификатор библиотеки в формате '/org/project' или '/org/project/version' в своём запросе. Не вызывайте этот инструмент более 3 раз для одного вопроса.

  • content_filestring

    (Необязательно) Абсолютный или относительный путь в файловой системе для чтения тела новой страницы (UTF-8). Используйте его вместо 'content', когда тело слишком велико, чтобы удобно передавать его как аргумент инструмента. Взаимоисключающий с 'content'.

  • content_formatstring

    (Необязательно) Формат параметра content. Варианты: 'markdown' (по умолчанию), 'wiki', 'storage' или 'xhtml'. Используйте 'xhtml' при передаче формата хранения Confluence XHTML (то же, что и 'storage'). Формат 'wiki' использует синтаксис вики-разметки Confluence.

  • emojistring

    (Необязательно) Эмодзи заголовка страницы (значок, отображаемый в навигации). Можно использовать любой символ эмодзи, например '📝', '🚀', '📚'. Установите null/None, чтобы удалить.

  • enable_heading_anchorsboolean

    (Необязательно) Включает ли автоматическую генерацию якорей заголовков. Применяется только когда content_format имеет значение 'markdown'.

  • include_contentboolean

    (Необязательно) Определяет, включать ли содержимое страницы в ответ. По умолчанию false, так как вызывающие уже имеют содержимое на момент обновления.

  • is_minor_editboolean

    Является ли это незначительной правкой

  • page_idstringобязательный

    Идентификатор страницы для обновления.

  • page_widthstring

    (Необязательно) Ширина макета страницы. Варианты: 'full-width', 'default'. По умолчанию null (сохранить существующее).

  • parent_idstring

    Необязательно: новый ID родительской страницы.

  • table_layoutstring

    Необязательный пресет ширины таблицы, применяемый ко всем таблицам Markdown. Варианты: 'full-width' (1800 px), 'wide' (960 px), 'default' (760 px). Применяется только когда content_format имеет значение 'markdown'.

  • titlestringобязательный

    Новое название страницы

  • version_commentstring

    Необязательный комментарий для этой версии.

confluence_update_page_section

Обновляет один раздел страницы Confluence, не затрагивая остальные. Заменяет только содержимое под указанным заголовком, оставляя все остальные разделы, макросы, макеты и Confluence-специфичные элементы полностью нетронутыми. Это предотвращает потерю данных, которая происходит при загрузке всей страницы в Markdown, редактировании и повторной загрузке. Args: ctx: Контекст FastMCP. page_id: ID обновляемой страницы. heading_text: Точный текст заголовка, определяющий заменяемый раздел. new_content: Новое содержимое раздела (заголовок не включается). content_format: Формат new_content ('markdown' или 'storage'). is_minor_edit: Флаг, указывающий, является ли правка минорной. version_comment: Опциональный комментарий к версии. Returns: Строка JSON с метаданными обновлённой страницы. Raises: ValueError: Если клиент Confluence не настроен, заголовок не найден или content_format недействителен.

Обновить раздел страницы

Параметры
  • content_formatstring

    (Необязательно) Формат параметра new_content. Варианты: 'markdown' (по умолчанию) или 'storage' (сырой XML-формат Confluence storage). Используйте 'storage', чтобы вставлять макросы или элементы, которые нельзя выразить в markdown.

  • heading_textstringобязательный

    Точный текст заголовка, с которого начинается раздел для замены. Сопоставление чувствительно к регистру. Если вы не уверены, используйте confluence_get_page с параметром convert_to_markdown=false, чтобы проверить точный текст заголовка.

  • is_minor_editboolean

    Является ли это незначительной правкой

  • new_contentstringобязательный

    Заменяющий контент для тела раздела. НЕ включайте сам заголовок: только тело под ним. Формат управляется параметром content_format.

  • page_idstringобязательный

    Идентификатор страницы для обновления.

  • version_commentstring

    Необязательный комментарий для этой версии.

confluence_upload_attachment

Загружает вложение в контент Confluence (страницу или запись блога). Передайте файл либо как путь, доступный для чтения сервером (file_path), либо как содержимое в base64 (content_base64 вместе с filename). Формат base64 предназначен для удалённых или контейнеризированных серверов, которые не могут читать файлы по путям на хосте. Должен быть указан ровно один из двух вариантов. Если вложение уже существует (такое же имя файла), создаётся новая версия. Это полезно для: - Прикрепления документов, изображений или файлов к странице - Обновления существующих вложений новыми версиями - Добавления вспомогательных материалов к документации Аргументы: ctx: Контекст FastMCP. content_id: ID контента, к которому прикрепить вложение. file_path: Путь к файлу для загрузки (доступен для чтения сервером). content_base64: Содержимое файла в base64 (загрузка без файловой системы). filename: Имя файла вложения, обязательно вместе с content_base64. comment: Необязательный комментарий к вложению. minor_edit: Является ли это правка мелкой (без уведомлений). Возвращает: Строку JSON с подтверждением загрузки и метаданными вложения.

Загрузить вложение

Параметры
  • commentstring

    (Необязательно) Комментарий, описывающий это вложение или версию. Виден в истории вложений. Пример: «Обновленные показатели за Q4 2024»

  • content_base64string

    Необязательный параметр: содержимое файла в кодировке Base64 для прямой загрузки, без чтения с диска сервером. Используйте его, когда сервер не имеет доступа к путям файлов на хосте (например, удалённый или контейнеризированный MCP-сервер). Требуется указать 'filename'. Передайте либо 'file_path', либо 'content_base64', но не оба одновременно.

  • content_idstringобязательный

    Идентификатор содержимого Confluence (страницы или записи в блоге), к которому нужно прикрепить файл. Идентификаторы страниц можно найти в URL страницы или с помощью инструментов поиска/получения страниц. Пример: '123456789'

  • filenamestring

    (Необязательно) Имя файла вложения, включая расширение (например, 'report.pdf'). Обязательно при использовании 'content_base64'; оно определяет заголовок вложения и тип файла. Игнорируется при использовании 'file_path'.

  • file_pathstring

    Полный путь к загружаемому файлу. Может быть абсолютным (например, '/home/user/document.pdf' или 'C:\Users\name\file.docx') или относительным к текущей рабочей директории (например, './uploads/document.pdf'). Если файл с таким именем уже существует, будет создана новая версия. Требуется, чтобы сервер мог прочитать путь; для удалённых или контейнерных серверов используйте 'content_base64'. Укажите либо 'file_path', либо 'content_base64', но не оба сразу.

  • minor_editboolean

    (Необязательно) Является ли это мелким редактированием. Если true, наблюдатели не уведомляются. По умолчанию false.

confluence_upload_attachments

Загружает несколько вложений в Confluence за одну операцию. Эффективнее, чем вызывать upload_attachment несколько раз. Если файлы с такими же именами уже существуют, новые версии создаются автоматически. Пригодится для: - Массовой загрузки документации (диаграммы, скриншоты и т.п.) - Добавления нескольких связанных файлов на страницу за раз - Пакетного обновления существующих вложений новыми версиями Аргументы: ctx: Контекст FastMCP. content_id: ID контента, к которому прикрепляются файлы. file_paths: Список путей к загружаемым файлам. comment: Необязательный комментарий к вложениям. minor_edit: Является ли это правкой без изменений содержания. Возвращает: Строку JSON с результатами загрузки каждого файла.

Загрузить несколько вложений

Параметры
  • commentstring

    (Необязательно) Комментарий для всех загруженных вложений. Виден в истории версий. Пример: «Q4 2024 пакетная загрузка»

  • content_idstringобязательный
  • file_pathsstringобязательный

    Список путей к файлам через запятую для загрузки. Можно указывать абсолютные или относительные пути. Примеры: './file1.pdf,./file2.png' или 'C:\docs\report.docx,D:\image.jpg'. Все файлы загружаются с одинаковыми настройками comment/minor_edit.

  • minor_editboolean

    (Необязательно) Является ли это мелким редактированием. Если true, наблюдатели не уведомляются. По умолчанию false.

jira_add_comment

Добавляет комментарий к задаче Jira. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. body: Текст комментария в Markdown. visibility: (Необязательно) Видимость комментария в виде JSON-строки. public: (Необязательно) Для задач JSM. True - видимый клиенту, False - только для внутреннего использования/агента. Использует ServiceDesk API. Возвращает: JSON-строку, представляющую объект добавленного комментария. Вызывает: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Добавить комментарий

Параметры
  • bodystringобязательный

    Текст комментария в формате Markdown

  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

  • publicboolean

    (Необязательно) Только для задач JSM/Service Desk. Установите true для комментария, видимого клиенту, false для внутреннего комментария, доступного только агенту. Отправляется через ServiceDesk API в виде необработанной строки; Jira Cloud отображает её на стороне сервера и сохраняет ADF (markdown, как замечено, отображается на Cloud, без клиентских гарантий преобразования markdown в ADF, которые есть в обычном пути комментариев). Нельзя комбинировать с visibility. Если проект задачи указан в JIRA_INTERNAL_ONLY_PROJECTS, принимается только public=false: public=true или пропуск этого поля отклоняется.

  • visibilitystring

    (Необязательно) Видимость комментария в виде JSON-строки (например, '{"type":"group","value":"jira-users"}')

jira_add_issues_to_sprint

Добавляет задачи в спринт Jira. Аргументы: ctx: Контекст FastMCP. sprint_id: ID спринта. issue_keys: Ключи задач через запятую. Возвращает: JSON-строку с сообщением об успехе. Вызывает: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Добавить задачи в спринт

Параметры
  • issue_keysstringобязательный

    Ключи задач, разделенные запятыми (например, 'PROJ-1,PROJ-2')

  • sprint_idstringобязательный

    ID спринта для добавления задач

jira_add_watcher

Добавляет пользователя в качестве наблюдателя к задаче Jira. Args: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. user_identifier: Account ID (Cloud) или username (Server/DC). Returns: Строка JSON с подтверждением успеха. Raises: ValueError: Если клиент Jira не настроен или недоступен.

Добавить наблюдателя задачи

Параметры
  • issue_keystringобязательный

    Ключ задачи JIRA (например, PROJ-123)

  • user_identifierstringобязательный

    Пользователь для добавления в наблюдатели. Для Jira Cloud используйте account ID. Для Jira Server/DC используйте имя пользователя.

jira_add_worklog

Добавляет запись о работе в задачу Jira. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. time_spent: Затраченное время в формате Jira. comment: Необязательный комментарий в Markdown. started: Необязательное время начала в формате ISO. original_estimate: Необязательная новая первоначальная оценка. remaining_estimate: Необязательная новая оставшаяся оценка. Возвращает: Строку JSON с добавленным объектом записи о работе. Вызывает: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Добавить лог работы

Параметры
  • commentstring
  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

  • original_estimatestring

    (Необязательно) Новое значение для первоначальной оценки

  • remaining_estimatestring

    (Необязательно) Новое значение для оставшейся оценки

  • startedstring

    (Необязательно) Время начала в формате ISO. Если не указано, будет использовано текущее время. Пример: '2023-08-01T12:00:00.000+0000'

  • time_spentstringобязательный

    Затраченное время в формате Jira. Примеры: '1h 30m' (1 час 30 минут), '1d' (1 день), '30m' (30 минут), '4h' (4 часа).

jira_assign_issue

Назначает задачу Jira пользователю через выделенную конечную точку назначения. Это надёжнее, чем установка исполнителя через update_issue, который некоторые конфигурации Jira молча игнорируют. Использует PUT /issue/{key}/assignee. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. assignee: Идентификатор пользователя (email, отображаемое имя или account ID) либо строка JSON-объекта из jira_search_assignable_users. Передайте None или пустую строку, чтобы снять назначение. Возвращает: Строку JSON с обновлённым объектом задачи. Исключения: ValueError: Если включён режим только для чтения, клиент Jira недоступен или пользователь не найден.

Назначить задачу

Параметры
  • assigneestring

    Идентификатор пользователя для назначения (email, отображаемое имя или идентификатор аккаунта) или строка JSON-объекта из jira_search_assignable_users. Передайте null или пустую строку, чтобы снять назначение с задачи.

  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

jira_batch_create_issues

Создаёт несколько задач Jira в пакетном режиме. Аргументы: ctx: Контекст FastMCP. issues: Строка с JSON-массивом объектов задач. validate_only: Если true, только проверяет, не создавая. Возвращает: Строку JSON, указывающую на успех и перечисляющую созданные задачи (или результат проверки). Вызывает: ValueError: Если включён режим только для чтения, клиент Jira недоступен или JSON некорректен.

Пакетное создание задач

Параметры
  • issuesstringобязательный

    JSON-массив объектов задач. Каждый объект должен содержать: - project_key (обязательно): ключ проекта (например, 'PROJ') - summary (обязательно): краткое описание/название задачи - issue_type (обязательно): тип задачи (например, 'Task', 'Bug') - description (необязательно): описание задачи в формате Markdown - assignee (необязательно): имя пользователя или email исполнителя - components (необязательно): массив названий компонентов Пример: [ {"project_key": "PROJ", "summary": "Задача 1", "issue_type": "Task"}, {"project_key": "PROJ", "summary": "Задача 2", "issue_type": "Bug", "components": ["Frontend"]} ]

  • validate_onlyboolean

    Если true, только проверяет проблемы, не создавая их.

jira_batch_create_versions

Пакетно создаёт несколько версий в проекте Jira.

Пакетное создание версий

Параметры
  • project_keystringобязательный

    Ключ проекта в Jira (например, 'PROJ', 'ACV2')

  • versionsstringобязательный

    JSON-массив объектов версий. Каждый объект должен содержать: - name (обязательное поле): название версии - startDate (необязательное поле): дата начала (ГГГГ-ММ-ДД) - releaseDate (необязательное поле): дата выпуска (ГГГГ-ММ-ДД) - description (необязательное поле): описание версии Пример: [ {"name": "v1.0", "startDate": "2025-01-01", "releaseDate": "2025-02-01", "description": "Первый выпуск"}, {"name": "v2.0"} ]

jira_batch_get_changelogsтолько чтение

Получить changelogs для нескольких задач Jira (только Cloud). Args: ctx: Контекст FastMCP. issue_ids_or_keys: Список ID или ключей задач. fields: Список полей для фильтрации changelogs. None для всех полей. limit: Максимальное количество changelogs на задачу (-1 для всех). Returns: JSON-строка, представляющая список задач с их changelogs. Raises: NotImplementedError: Если запущено на Jira Server/Data Center. ValueError: Если Jira клиент недоступен.

Пакетное получение журналов изменений

Параметры
  • fieldsstring

    (Необязательно) Список полей через запятую для фильтрации журналов изменений (например, 'status,assignee'). По умолчанию — None для всех полей.

  • issue_ids_or_keysstringобязательный

    Список идентификаторов или ключей задач Jira через запятую (например, 'PROJ-123,PROJ-124')

  • limitinteger

    Максимальное количество журналов изменений, возвращаемых в результате для каждой задачи. По умолчанию -1 означает все журналы изменений. Обратите внимание: это ограничивает только результаты в ответе, функция всё равно будет получать все данные.

jira_create_customer_request

Создаёт запрос клиента в Jira Service Management.

Создаёт запрос клиента

Параметры
  • attachmentsstring

    (Необязательно) Строка JSON-массива файлов для прикрепления к создаваемому запросу. Каждый объект должен содержать 'filename', 'mime_type' и содержимое 'base64' в кодировке base64. Пример: [{"filename": "log.txt", "mime_type": "text/plain", "base64": "aGVsbG8="}]

  • raise_on_behalf_ofstring

    Необязательный идентификатор пользователя Jira для raiseOnBehalfOf. Для Server/DC это обычно имя пользователя или ключ; для Cloud используйте идентификатор, ожидаемый вашим экземпляром JSM.

  • request_field_valuesstringобязательный

    JSON-строка значений полей запроса, сгруппированных по идентификатору поля. Примеры: - Сводка и описание: {"summary": "Access issue", "description": "Cannot log in"} - Многозначное поле: {"customfield_10001": ["alice", "bob"]}

  • request_participantsstring

    (Необязательно) Строка JSON-массива или список участников запроса, разделённый запятыми. Примеры: ["user1","user2"] или "user1,user2"

  • request_type_idstringобязательный

    ID типа запроса (например, '23')

  • service_desk_idstringобязательный

    ID сервисного деска (например, '4')

  • strict_on_behalfboolean

    Если true, немедленно завершитесь ошибкой, когда raiseOnBehalfOf не может быть применён. Если false, повторите попытку без raiseOnBehalfOf и верните предупреждение о запасном варианте.

jira_create_issue

Создаёт новую задачу в Jira с опциональной ссылкой на Epic или родительскую задачу для подзадач. Аргументы: ctx: Контекст FastMCP. project_key: Ключ проекта в Jira. summary: Краткое описание/заголовок задачи. issue_type: Тип задачи (например, 'Task', 'Bug', 'Story', 'Epic', 'Subtask'). assignee: Идентификатор пользователя-исполнителя (строка): email, отображаемое имя или account ID (например, 'user@example.com', 'John Doe', 'accountid:...'). description: Описание задачи в формате Markdown. components: Список имён компонентов через запятую. additional_fields: JSON-строка с дополнительными полями. Возвращает: JSON-строку с информацией о созданной задаче. Вызывает исключения: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Create Issue

Параметры
  • additional_fieldsstring

    (Необязательно) JSON-строка с дополнительными полями для настройки. Примеры: - Задать приоритет: {"priority": {"name": "High"}} - Добавить метки: {"labels": ["frontend", "urgent"]} - Привязать к родительской задаче (для любого типа задачи): {"parent": "PROJ-123"} - Привязать к эпику: {"epicKey": "EPIC-123"} или {"epic_link": "EPIC-123"} - Задать версию исправления: {"fixVersions": [{"id": "10020"}]} - Пользовательские поля: {"customfield_10010": "value"}

  • assigneestring
  • componentsstring

    (Необязательно) Список имён компонентов через запятую для назначения (например, 'Frontend,API')

  • descriptionstring

    Описание задачи в формате Markdown. В Jira Cloud используйте '{expand:Заголовок}...{expand}' для сворачиваемого раздела.

  • issue_typestringобязательный

    Тип задачи (например, 'Task', 'Bug', 'Story', 'Epic', 'Subtask'). Доступные типы зависят от конфигурации вашего проекта. Для подзадач используйте 'Subtask' (не 'Sub-task') и указывайте родительскую задачу в additional_fields.

  • project_keystringобязательный

    Ключ проекта JIRA (например, 'PROJ', 'DEV', 'ACV2'). Это префикс ключей задач в вашем проекте. Никогда не предполагайте, каким он может быть, всегда спрашивайте пользователя.

  • summarystringобязательный

    Краткое описание / заголовок проблемы

jira_create_issue_link

Создаёт связь между двумя задачами Jira. Аргументы: ctx: Контекст FastMCP. link_type: Тип связи (например, 'Blocks'). inward_issue_key: Ключ исходной задачи. outward_issue_key: Ключ целевой задачи. comment: Необязательный текст комментария. comment_visibility: Необязательная JSON-строка для видимости комментария. Возвращает: JSON-строку с указанием успеха или неудачи. Исключения: ValueError: Если отсутствуют обязательные поля, введены неверные данные, включён режим только для чтения или клиент Jira недоступен.

Создать ссылку на Issue

Параметры
  • commentstring

    (Необязательно) Комментарий для добавления к ссылке. Отклоняется, когда связанная задача относится к проекту из списка JIRA_INTERNAL_ONLY_PROJECTS (комментарий к ссылке может быть виден клиенту в JSM и не может быть принудительно внутренним): создайте ссылку без комментария, затем опубликуйте внутреннюю заметку с помощью jira_add_comment(public=false) в соответствующей задаче.

  • comment_visibilitystring

    (Необязательно) Настройки видимости комментария в виде JSON-строки (например, '{"type":"group","value":"jira-users"}')

  • inward_issue_keystringобязательный

    Ключ внутреннего вопроса (например, 'PROJ-123', 'ACV2-642')

  • link_typestringобязательный

    Тип создаваемой ссылки (например, 'Duplicate', 'Blocks', 'Relates to')

  • outward_issue_keystringобязательный

    Ключ внешнего вопроса (например, 'PROJ-456')

jira_create_remote_issue_link

Создаёт внешнюю ссылку на задачу Jira (веб-ссылку или ссылку на Confluence). Этот инструмент позволяет добавлять веб-ссылки и ссылки на Confluence к задачам Jira. Ссылки появятся в разделе "Связи" задачи, по ним можно будет перейти во внешние ресурсы. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи, к которой нужно добавить ссылку. url: URL ссылки (может быть веб-страницей или страницей Confluence). title: Заголовок/название ссылки. summary: Необязательное описание назначения ссылки. relationship: Необязательное описание типа связи. icon_url: Необязательный URL иконки размером 16x16 для ссылки. Возвращает: JSON-строку с результатом (успех или ошибка). Вызывает: ValueError: если отсутствуют обязательные поля, переданы некорректные данные, включён режим только для чтения или клиент Jira недоступен.

Создать внешнюю ссылку на задачу

Параметры
  • icon_urlstring

    (Необязательно) URL-адрес иконки 16x16 для ссылки

  • issue_keystringобязательный

    Ключ задачи, на которую нужно добавить ссылку (например, 'PROJ-123', 'ACV2-642')

  • relationshipstring

    (Необязательно) Описание связи (например, 'causes', 'relates to', 'documentation')

  • summarystring

    (Необязательно) Описание ссылки

  • titlestringобязательный

    Название ссылки (например, 'Documentation Page', 'Confluence Page')

  • urlstringобязательный

    URL для ссылки (например, 'https://example.com/page' или URL страницы Confluence)

jira_create_sprint

Создаёт спринт Jira для доски. Args: ctx: Контекст FastMCP. board_id: Идентификатор доски. name: Название спринта. start_date: Дата начала (в формате ISO). end_date: Дата окончания (в формате ISO). goal: Цель спринта (необязательно). Возвращает: Строка JSON, представляющая созданный объект спринта. Вызывает: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Создать спринт

Параметры
  • board_idstringобязательный

    Идентификатор доски (например, '1000')

  • end_datestringобязательный

    Время окончания спринта (формат ISO 8601)

  • goalstring

    Цель спринта

  • namestringобязательный

    Название спринта (например, 'Sprint 1')

  • start_datestringобязательный

    Время начала спринта (формат ISO 8601)

jira_create_version

Создаёт новую версию исправления в проекте Jira. Аргументы: ctx — контекст FastMCP. project_key — ключ проекта. name — имя версии. start_date — дата начала (необязательно). release_date — дата релиза (необязательно). description — описание (необязательно). Возвращает: строку JSON с созданным объектом версии.

Создать версию

Параметры
  • descriptionstring

    Описание версии

  • namestringобязательный

    Пожалуйста, уточните, какой текст нужно перевести. Вы написали «Name of the version», но не указали, что именно переводить. Если это сам запрос на перевод, то вот перевод: Название версии

  • project_keystringобязательный

    Ключ проекта в Jira (например, 'PROJ', 'ACV2')

  • release_datestring

    Дата выпуска (ГГГГ-ММ-ДД)

  • start_datestring

    Дата начала YYYY-MM-DD

jira_delete_issue

Удаляет существующую задачу Jira. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. Возвращает: Строку JSON, указывающую на успех. Вызывает: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Удалить задачу

Параметры
  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

jira_download_attachmentsтолько чтение

Загружает вложения из задачи Jira. Возвращает содержимое вложений как ресурсы, встроенные в формате base64, чтобы они были доступны через протокол MCP без необходимости доступа к файловой системе на сервере. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. Возвращает: Список, содержащий текстовую сводку и по одному EmbeddedResource на каждое успешно загруженное вложение.

Скачать вложения

Параметры
  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

jira_edit_comment

Редактирует существующий комментарий в задаче Jira. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. comment_id: Идентификатор комментария для редактирования. body: Обновлённый текст комментария в Markdown. visibility: (Опционально) Видимость комментария в виде строки JSON. Возвращает: Строку JSON, представляющую обновлённый объект комментария. Вызывает: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Редактировать комментарий

Параметры
  • bodystringобязательный

    Обновлённый текст комментария в формате Markdown

  • comment_idstringобязательный

    Идентификатор комментария для редактирования

  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

  • visibilitystring

    (Необязательно) Видимость комментария в виде JSON-строки (например, '{"type":"group","value":"jira-users"}')

jira_get_agile_boardsтолько чтение

Получить agile-доски Jira по имени, ключу проекта или типу. Аргументы: ctx: Контекст FastMCP. board_name: Имя доски (нечёткий поиск). project_key: Ключ проекта. board_type: Тип доски ('scrum' или 'kanban'). start_at: Начальный индекс. limit: Максимум результатов. Возвращает: Строка JSON: список объектов досок.

Получить Agile-доски

Параметры
  • board_namestring

    Необязательно. Название доски, поддерживает нечёткий поиск.

  • board_typestring

    (Необязательно) Тип доски Jira (например, 'scrum', 'kanban')

  • limitinteger

    Максимальное количество результатов

  • project_keystring

    (необязательно) Ключ проекта Jira (например, 'PROJ', 'ACV2')

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

jira_get_all_projectsтолько чтение

Возвращает все проекты Jira, доступные текущему пользователю. Аргументы: ctx: Контекст FastMCP. include_archived: Включать ли архивированные проекты. Возвращает: Строку JSON со списком объектов проектов, доступных пользователю. Ключи проектов всегда возвращаются в верхнем регистре. Если настроен JIRA_PROJECTS_FILTER, возвращает только проекты, совпадающие с этими ключами. Исключения: ValueError: Если клиент Jira не настроен или недоступен.

Получить все проекты

Параметры
  • include_archivedboolean

    Включать ли архивированные проекты в результаты

jira_get_board_issuesтолько чтение

Получить все задачи, связанные с конкретной доской, с фильтрацией по JQL. Аргументы: ctx: Контекст FastMCP. board_id: ID доски. jql: Строка запроса JQL для фильтрации задач. fields: Поля для возврата, перечисленные через запятую. start_at: Начальный индекс для пагинации. limit: Максимальное количество результатов. expand: Дополнительные поля для раскрытия (необязательно). Возвращает: Строку JSON с результатами поиска, включая информацию о пагинации.

Получить задачи доски

Параметры
  • board_idstringобязательный

    Идентификатор доски (например, '1001')

  • expandstring

    Необязательные поля для разворачивания в ответе (например, «changelog»).

  • fieldsstring

    Поля, разделённые запятыми, для возврата в результатах. Используйте '*all' для всех полей или укажите отдельные поля, например, 'summary,status,assignee,priority'.

  • jqlstringобязательный

    Строка запроса JQL (Jira Query Language). Примеры: - Найти эпики: "issuetype = Epic AND project = PROJ" - Найти задачи в эпике: "parent = PROJ-123" - Найти по статусу: "status = 'In Progress' AND project = PROJ" - Найти по исполнителю: "assignee = currentUser()" - Найти недавно обновлённые: "updated >= -7d AND project = PROJ" - Найти по метке: "labels = frontend AND project = PROJ" - Найти по приоритету: "priority = High AND project = PROJ"

  • limitinteger

    Максимальное количество результатов

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

jira_get_create_fieldsтолько чтение

Получает поля, доступные для создания задачи определённого типа. Возвращает все поля (обязательные и необязательные) для указанного проекта и типа задачи, включая имена полей, идентификаторы, обязательность и их схему. Используйте jira_get_field_options, когда возвращённому полю нужны его разрешённые значения. Args: ctx: контекст FastMCP. project_key: ключ проекта. issue_type_id: идентификатор типа задачи. Returns: JSON-строку со списком метаданных полей (field_id, name, required, schema).

Get Create Fields

Параметры
  • issue_type_idstringобязательный

    ID типа задачи (из get_project_issue_types). Например: '10002' для задачи.

  • project_keystringобязательный

    Ключ проекта Jira (например, 'PROJ', 'JTEST')

jira_get_cross_project_dependenciesтолько чтение

Находит все ссылки на задачи между проектами для заданного проекта. Сканирует задачи в проекте, извлекает каждую ссылку на задачу, чья цель принадлежит другому проекту, и группирует их по целевому проекту и типу ссылки. Полезен для анализа зависимостей в многопроектных конфигурациях Jira.

Получает межпроектные зависимости

Параметры
  • max_issuesinteger

    Максимальное количество задач для сканирования ссылок (1–500)

  • project_keystringобязательный

    Ключ проекта Jira (например, 'PROJ')

jira_get_field_optionsтолько чтение

Получает допустимые значения опций для пользовательского поля. Возвращает список допустимых параметров для настраиваемых полей типа выбор, множественный выбор, радиокнопка, флажок и каскадный выбор. Cloud: Использует API опций контекста поля. Если context_id не указан, автоматически разрешается до глобального контекста. Server/DC: Использует createmeta для получения allowedValues. Требуются параметры project_key и issue_type. Аргументы: ctx: Контекст FastMCP. field_id: Идентификатор пользовательского поля. context_id: Идентификатор контекста поля (только Cloud, если не указан — авторазрешение). project_key: Ключ проекта (обязательно для Server/DC). issue_type: Имя типа задачи (обязательно для Server/DC). contains: Фильтр подстроки без учёта регистра по значениям опций. return_limit: Ограничение на количество результатов после фильтрации. values_only: Возвращать компактный формат только со строками значений. Возвращает: Строка JSON со списком доступных опций.

Get Field Options

Параметры
  • containsstring

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

  • context_idstring

    Идентификатор контекста поля (только для облака). Если не указан, автоматически определяется глобальный контекст.

  • field_idstringобязательный

    Идентификатор настраиваемого поля (например, 'customfield_10001'). Используйте jira_search_fields, чтобы найти идентификаторы полей.

  • issue_typestring

    Название типа задачи (обязательно для Server/DC). Пример: 'Bug'

  • project_keystring

    Ключ проекта (обязательно для Server/DC). Пример: 'PROJ'

  • return_limitinteger

    Максимальное количество возвращаемых результатов (применяется после фильтрации).

  • values_onlyboolean

    Если значение равно true, возвращаются только строки значений в компактном формате JSON вместо полных объектов параметров.

jira_get_issueтолько чтение

Получает детали конкретной задачи Jira. Включает ссылки на эпики и информацию о связях. Используйте параметр include для подстановки обогащений (remote_links, transitions, watchers, changelog, comments, worklogs) прямо в ответ, чтобы не вызывать отдельные инструменты. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. fields: Поля через запятую. expand: Опциональные поля для разворачивания. comment_limit: Максимальное количество комментариев. properties: Свойства задачи. update_history: Обновлять ли историю просмотров задачи. include: Секции обогащений через запятую для подстановки. Возвращает: JSON-строка с объектом задачи Jira. Исключения: ValueError: Если клиент Jira не настроен.

Получить задачу

Параметры
  • comment_limitinteger

    Максимальное количество комментариев для включения (0 или null, если комментарии не нужны)

  • expandstring

    (Необязательно) Поля для раскрытия. Примеры: 'renderedFields' (для отображаемого содержимого), 'transitions' (для доступных переходов статусов), 'changelog' (для истории).

  • fieldsstring

    (Необязательно) Список полей, разделённых запятыми, для возврата (например, 'summary,status,customfield_10010'). Можно также указать одно поле строкой (например, 'duedate'). Используйте '*all' для всех полей (включая пользовательские), или опустите параметр, чтобы получить только основные поля.

  • includestring

    (Необязательно) Разделы, разделённые запятыми, для встраивания в ответ, чтобы избежать дополнительных вызовов инструментов. Поддерживается: all, remote_links, transitions, watchers, changelog, comments, worklogs

  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

  • propertiesstring

    (Необязательно) Список свойств issue через запятую для возврата

  • update_historyboolean

    Обновлять ли историю просмотров задачи для запрашивающего пользователя

  • use_display_namesboolean

    Когда значение true, ключи пользовательских полей в выводе используют человекочитаемые отображаемые имена (например, 'Story Points') вместо непрозрачных ID (например, 'customfield_10243'). Расширение 'names' добавляется автоматически. Стандартные поля не затрагиваются.

jira_get_issue_datesтолько чтение

Получает информацию о датах и историю переходов статусов для задачи Jira. Возвращает даты (создания, обновления, срок выполнения, дата решения) и опционально историю изменений статусов с учетом времени для анализа workflow. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. include_status_changes: Включать ли историю изменений статусов. include_status_summary: Включать ли агрегированное время по статусам. Возвращает: JSON-строку с датами задачи и опциональными данными отслеживания статусов.

Получить даты задач

Параметры
  • include_status_changesboolean

    Включите историю изменений статуса с временными метками и длительностями.

  • include_status_summaryboolean

    Включи суммарное время, проведённое в каждом статусе.

  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

jira_get_issue_development_infoтолько чтение

Получает информацию о разработке (PR, коммиты, ветки), связанную с задачей Jira. Извлекает информацию из панели разработки, показывающую связанные пул-реквесты, ветки и коммиты из подключенных систем контроля версий, таких как Bitbucket, GitHub или GitLab. Параметры: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. application_type: Необязательный фильтр по типу системы контроля версий. data_type: Необязательный фильтр по типу данных (pullrequest, branch и т.д.). Возвращает: Строку JSON с информацией о разработке, включающую: - pullRequests: Список связанных пул-реквестов с указанием статуса, автора, рецензентов - branches: Список связанных веток - commits: Список связанных коммитов - repositories: Список задействованных репозиториев

Получить информацию о разработке задачи

Параметры
  • application_typestring

    (Необязательно) Фильтр по типу приложения (с учетом регистра). Примеры: 'stash' (Bitbucket Server), 'bitbucket', 'GitHub', 'githube' (GitHub Enterprise Server), 'GitLab'. Если не указано, типы определяются автоматически.

  • data_typestring

    (Необязательно) Фильтр по типу данных. Примеры: 'pullrequest', 'branch', 'repository'

  • issue_keystringобязательный

    Ключ задачи JIRA (например, PROJ-123)

jira_get_issue_imagesтолько чтение

Получает все изображения, прикреплённые к задаче Jira, как встроенное содержимое изображений. Фильтрует вложения, оставляя только изображения (PNG, JPEG, GIF, WebP, SVG, BMP), и возвращает их как base64-закодированные ImageContent, которые клиенты могут отобразить напрямую. Вложения, не являющиеся изображениями, исключаются. Файлы с неоднозначными MIME-типами (application/octet-stream) определяются по расширению имени файла как запасной вариант. Изображения размером более 50 МБ пропускаются с записью об ошибке в сводке. Аргументы: ctx: контекст FastMCP. issue_key: ключ задачи Jira. Возвращает: Список с текстовой сводкой, за которой следует по одному ImageContent на каждое успешно загруженное изображение.

Get Issue Images

Параметры
  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123'). Возвращает вложения с изображениями как встроенный ImageContent для зрения LLM.

jira_get_issue_proforma_formsтолько чтение

Получить все формы ProForma, связанные с задачей Jira. Использует новый REST API Jira Forms. Идентификаторы форм возвращаются в формате UUID. Аргументы: ctx: контекст FastMCP. issue_key: ключ задачи, для которой нужно получить формы. Возврат: Строка JSON, представляющая список форм ProForma, или объект ошибки в случае неудачи.

Get Issue Forms

Параметры
  • issue_keystringобязательный

    Ключ задачи JIRA (например, PROJ-123)

jira_get_issues_development_infoтолько чтение

Получает информацию о разработке для нескольких задач Jira. Пакетно получает информацию панели разработки (PR, коммиты, ветки) для нескольких задач сразу. Args: ctx: контекст FastMCP. issue_keys: список ключей задач Jira. application_type: опциональный фильтр по типу системы контроля версий. data_type: опциональный фильтр по типу данных. Returns: Строка JSON со списком информации о разработке для каждой задачи.

Получить информацию о разработке Issues

Параметры
  • application_typestring

    (Необязательно) Фильтр по типу приложения (с учетом регистра). Примеры: 'stash' (Bitbucket Server), 'bitbucket', 'GitHub', 'githube' (GitHub Enterprise Server), 'GitLab'. Если не указано, типы определяются автоматически.

  • data_typestring

    (Необязательно) Фильтр по типу данных. Примеры: 'pullrequest', 'branch', 'repository'

  • issue_keysstringобязательный

    Список ключей задач Jira, разделённых запятыми (например, 'PROJ-123,PROJ-456')

jira_get_issue_slaтолько чтение

Рассчитывает метрики SLA для задачи Jira. Вычисляет различные временные метрики: время цикла, время выполнения, время в каждом статусе, соблюдение сроков и другое. Рабочие часы можно настроить через переменные окружения: - JIRA_SLA_WORKING_HOURS_ONLY: Включить фильтрацию по рабочим часам (true/false) - JIRA_SLA_WORKING_HOURS_START: Время начала (например, "09:00") - JIRA_SLA_WORKING_HOURS_END: Время окончания (например, "17:00") - JIRA_SLA_WORKING_DAYS: Рабочие дни (например, "1,2,3,4,5" для Пн-Пт) - JIRA_SLA_TIMEZONE: Часовой пояс для расчётов (например, "America/New_York") Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. metrics: Список метрик для расчёта, разделённый запятыми. working_hours_only: Учитывать только рабочие часы. include_raw_dates: Включить в ответ необработанные значения дат. Возвращает: Строку JSON с рассчитанными метриками SLA.

Получить SLA задачи

Параметры
  • include_raw_datesboolean

    Включайте исходные значения дат в ответ.

  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

  • metricsstring

    Список SLA-метрик, разделённый запятыми, для расчёта. Доступно: cycle_time, lead_time, time_in_status, due_date_compliance, resolution_time, first_response_time. По умолчанию используются настроенные метрики или 'cycle_time,time_in_status'.

  • working_hours_onlyboolean

    Расчет учитывает только рабочие часы (исключая выходные и нерабочие). По умолчанию берется значение из переменной окружения JIRA_SLA_WORKING_HOURS_ONLY.

jira_get_issue_watchersтолько чтение

Получает список наблюдателей для задачи Jira. Аргументы: ctx: контекст FastMCP. issue_key: ключ задачи Jira. Возвращает: JSON-строка с количеством наблюдателей и их списком. Исключения: ValueError: если клиент Jira не настроен или недоступен.

Получить наблюдателей задачи

Параметры
  • issue_keystringобязательный

    Ключ задачи JIRA (например, PROJ-123)

jira_get_link_typesтолько чтение

Получить все доступные типы связей задач. Аргументы: ctx: Контекст FastMCP. name_filter: Необязательная подстрока для фильтрации типов связей по имени. Возвращает: Строку JSON со списком объектов типов связей задач.

Получить типы ссылок

Параметры
  • name_filterstring

    (Необязательно) Фильтровать типы ссылок по подстроке имени (без учета регистра)

jira_get_proforma_form_detailsтолько чтение

Получить подробную информацию о конкретной форме ProForma. Использует новый REST API Jira Forms. Возвращает детали формы, включая структуру дизайна ADF. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи, содержащей форму. form_id: UUID-идентификатор формы. Возвращает: Строку JSON, содержащую детали формы ProForma, или объект ошибки в случае неудачи.

Получить детали формы

Параметры
  • form_idstringобязательный

    : Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat.: Get last error in the chat.: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the

  • issue_keystringобязательный

    Ключ задачи JIRA (например, PROJ-123)

jira_get_project_componentsтолько чтение

Получить все компоненты для конкретного проекта Jira.

Получить компоненты проекта

Параметры
  • project_keystringобязательный

    Ключ проекта в Jira (например, 'PROJ', 'ACV2')

jira_get_project_epic_hierarchyтолько чтение

Группирует эпики проекта под их кросс-проектными родительскими задачами. Получает все эпики в проекте, определяет их родительскую задачу через поле parent или входящие связи задач, затем группирует их по родителю. Эпики без обнаруженного родителя отображаются под "Unlinked". Полезно для понимания того, как эпики проекта сводятся к инициативам в другом проекте.

Получает иерархию эпиков проекта.

Параметры
  • max_epicsinteger

    Максимальное количество эпиков для получения (1-500)

  • project_keystringобязательный

    Ключ проекта Jira (например, 'PROJ')

jira_get_project_fieldsтолько чтение

Получает поля, доступные в задачах проекта (схема создания), дедуплицированные по типам задач проекта — т.е. какие поля есть у задач в этом проекте, независимо от того, заполнены ли они. Аргументы: ctx: Контекст FastMCP. project_key: Ключ проекта. Возвращает: Строку JSON со списком полей: каждый {field_id, name, required, schema_type, custom, issue_types}. Пустой список, если полей нет или при ошибке. Исключения: ValueError: Если Jira клиент не настроен или недоступен.

Получить поля проекта

Параметры
  • project_keystringобязательный
jira_get_project_issuesтолько чтение

Получает все задачи для конкретного проекта Jira. Аргументы: ctx: Контекст FastMCP. project_key: Ключ проекта. limit: Максимальное количество результатов. start_at: Начальный индекс для пагинации. Возвращает: Строку JSON с результатами поиска, включая информацию о пагинации.

Получить задачи проекта

Параметры
  • limitinteger

    Максимальное количество результатов

  • project_keystringобязательный

    Ключ проекта в Jira (например, 'PROJ', 'ACV2')

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

jira_get_project_issue_typesтолько чтение

Возвращает список доступных типов задач для проекта Jira. Возвращает список типов задач (Bug, Task, Story, Epic и т.д.), которые можно создать в указанном проекте. Используйте полученные ID типов задач с get_create_fields, чтобы узнать, какие поля обязательны для каждого типа. Аргументы: ctx: Контекст FastMCP. project_key: Ключ проекта. Возвращает: Строка JSON со списком типов задач (id, name, description, subtask).

Получить типы задач проекта

Параметры
  • project_keystringобязательный

    Ключ проекта Jira (например, 'PROJ', 'JTEST')

jira_get_project_versionsтолько чтение

Получить все fix-версии для конкретного проекта Jira.

Получить версии проекта

Параметры
  • project_keystringобязательный

    Ключ проекта в Jira (например, 'PROJ', 'ACV2')

jira_get_queue_issuesтолько чтение

Получает задачи из очереди Jira Service Desk. Только для Server/Data Center. Недоступно в Jira Cloud. Аргументы: ctx: Контекст FastMCP. service_desk_id: ID сервис-деска. queue_id: ID очереди. start_at: Начальный индекс для пагинации. limit: Максимальное количество возвращаемых задач. Возвращает: JSON-строку с метаданными очереди, задачами и метаданными пагинации. Исключения: NotImplementedError: Если подключение к Jira Cloud (только Server/DC).

Получить проблемы очереди

Параметры
  • limitinteger

    Максимальное количество результатов

  • queue_idstringобязательный

    ID очереди (например, '47')

  • service_desk_idstringобязательный

    ID сервисного деска (например, '4')

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

jira_get_request_type_fieldsтолько чтение

Получает определения полей для типа запроса Jira Service Management.

Получает поля типа запроса.

Параметры
  • request_type_idstringобязательный

    ID типа запроса (например, '23')

  • service_desk_idstringобязательный

    ID сервисного деска (например, '4')

jira_get_request_typesтолько чтение

Получает типы запросов для service desk в Jira Service Management.

Получить типы запросов

Параметры
  • limitinteger

    Максимальное количество результатов

  • service_desk_idstringобязательный

    ID сервисного деска (например, '4')

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

jira_get_service_desk_for_projectтолько чтение

Получает Jira Service Desk, связанный с ключом проекта. Только для Server/Data Center. Недоступно на Jira Cloud. Аргументы: ctx: контекст FastMCP. project_key: ключ проекта Jira. Возвращает: Строка JSON с ключом проекта и данными сервис-деска (или null, если не найдено). Исключения: NotImplementedError: если подключение к Jira Cloud (только Server/DC).

Получить сервис-деск для проекта

Параметры
  • project_keystringобязательный

    Ключ проекта Jira (например, 'SUP')

jira_get_service_desk_queuesтолько чтение

Получает очереди для Jira Service Desk. Только для Server/Data Center. Недоступно в Jira Cloud. Аргументы: ctx: Контекст FastMCP. service_desk_id: ID сервис-деска. start_at: Начальный индекс для пагинации. limit: Максимальное количество возвращаемых очередей. Возвращает: JSON-строку со списком очередей и метаданными пагинации. Вызывает: NotImplementedError: Если подключена Jira Cloud (доступно только для Server/DC).

Получить очереди Service Desk

Параметры
  • limitinteger

    Максимальное количество результатов

  • service_desk_idstringобязательный

    ID сервисного деска (например, '4')

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

jira_get_sprint_issuesтолько чтение

Получить задачи Jira из спринта. Аргументы: ctx: Контекст FastMCP. sprint_id: ID спринта. fields: Поля для возврата, разделённые запятыми. start_at: Начальный индекс. limit: Максимальное количество результатов. Возвращает: Строка JSON с результатами поиска, включая информацию о пагинации.

Получить задачи спринта

Параметры
  • fieldsstring

    Поля, разделённые запятыми, для возврата в результатах. Используйте '*all' для всех полей или укажите отдельные поля, например, 'summary,status,assignee,priority'.

  • limitinteger

    Максимальное количество результатов

  • sprint_idstringобязательный

    Идентификатор спринта (например, '10001').

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

jira_get_sprints_from_boardтолько чтение

Получить спринты Jira из доски по состоянию. Аргументы: ctx: Контекст FastMCP. board_id: ID доски. state: Состояние спринта ('active', 'future', 'closed'). Если None, возвращает все спринты. start_at: Начальный индекс. limit: Максимальное количество результатов. Возвращает: Строку JSON, представляющую список объектов спринтов.

Получить спринты с доски

Параметры
  • board_idstringобязательный

    Идентификатор доски (например, '1000')

  • limitinteger

    Максимальное количество результатов

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

  • statestring

    Состояние спринта (например, 'active', 'future', 'closed')

jira_get_transitionsтолько чтение

Получить доступные переходы статусов для задачи Jira. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. Возвращает: Строку JSON, представляющую список доступных переходов.

Получить переходы

Параметры
  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

jira_get_user_profileтолько чтение

Получает информацию о профиле для конкретного пользователя Jira. Аргументы: ctx: контекст FastMCP. user_identifier: идентификатор пользователя (email, username, key или account ID). Возвращает: строку JSON, представляющую объект профиля пользователя Jira, или объект ошибки, если пользователь не найден. Исключения: ValueError: если клиент Jira не настроен или недоступен.

Получить профиль пользователя

Параметры
  • user_identifierstringобязательный

    Идентификатор пользователя (например, адрес электронной почты 'user@example.com', имя пользователя 'johndoe', ID аккаунта 'accountid:...' или ключ для Server/DC).

jira_get_worklogтолько чтение

Получить записи времени (worklog) для задачи Jira. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. Возвращает: Строка JSON, представляющая записи времени.

Получить записи о работе

Параметры
  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

jira_link_to_epic

Привязывает существующую задачу к эпику. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи, которую нужно привязать. epic_key: Ключ эпика, к которому нужно привязать. Возвращает: Строку JSON с обновлённым объектом задачи. Исключения: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Ссылка на Epic

Параметры
  • epic_keystringобязательный

    Ключ эпика для привязки (например, 'PROJ-456')

  • issue_keystringобязательный

    Ключ задачи для связывания (например, «PROJ-123», «ACV2-642»)

jira_move_issue

Перемещает задачу Jira в другой проект (только Jira Cloud). Использует bulk move API Jira Cloud для перемещения между проектами. Задача сохраняет текущий тип задачи и может получить новый ключ в целевом проекте (например, OLDPROJ-123 станет NEWPROJ-456). Перемещение обрабатывается асинхронно на стороне Jira; этот инструмент опрашивает статус, пока не получит подтверждение или не истечёт тайм-аут (30 секунд). Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira для перемещения. target_project_key: Ключ целевого проекта. Возвращает: Строку JSON, представляющую перемещённую задачу с её новым ключом и проектом. Вызывает: ValueError: если режим только для чтения, клиент Jira недоступен или перемещение не удалось. NotImplementedError: если не выполняется на Jira Cloud.

Переместить задачу в проект

Параметры
  • issue_keystringобязательный

    Ключ задачи Jira для перемещения (например, 'PROJ-123')

  • target_project_keystringобязательный

    Ключ целевого проекта (например, 'OTHERPROJ'). Задача сохранит свой текущий тип и может получить новый ключ в целевом проекте.

jira_move_issues_to_backlog

Перемещает задачи в бэклог, удаляя их из любого спринта. Аргументы: ctx: Контекст FastMCP. issue_keys: Ключи задач через запятую. Возвращает: JSON-строку с сообщением об успехе. Вызывает: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Перенести задачи в бэклог

Параметры
  • issue_keysstringобязательный

    Ключи задач, разделенные запятыми (например, 'PROJ-1,PROJ-2')

jira_remove_issue_link

Удаляет связь между двумя задачами Jira. Аргументы: ctx: Контекст FastMCP. link_id: Идентификатор удаляемой связи. Возвращает: Строку JSON, указывающую на успех. Вызывает: ValueError: Если link_id отсутствует, включён режим только для чтения или клиент Jira недоступен.

Удалить связь с задачей

Параметры
  • link_idstringобязательный

    Голос :: Простите, я не в сети.

jira_remove_watcher

Удаляет пользователя из наблюдателей задачи Jira. Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. username: Имя пользователя для удаления (Server/DC). account_id: Идентификатор аккаунта для удаления (Cloud). Возвращает: JSON-строку с подтверждением успеха. Вызывает: ValueError: Если клиент Jira не настроен или недоступен.

Удалить наблюдателя задачи

Параметры
  • account_idstring

    ID аккаунта для удаления (для Jira Cloud).

  • issue_keystringобязательный

    Ключ задачи JIRA (например, PROJ-123)

  • usernamestring

    Имя пользователя для удаления (для Jira Server/DC).

jira_searchтолько чтение

Ищет задачи Jira с помощью JQL (Jira Query Language). Аргументы: ctx: контекст FastMCP. jql: строка запроса JQL. fields: поля для возврата, разделённые запятыми. limit: максимальное количество результатов. start_at: начальный индекс для постраничной навигации. projects_filter: список ключей проектов для фильтрации, разделённый запятыми. expand: дополнительные поля для раскрытия. page_token: токен постраничной навигации из предыдущего результата поиска (только для Cloud). Возвращает: строка JSON с результатами поиска и информацией о постраничной навигации.

Поиск задач

Параметры
  • expandstring

    (Необязательные) поля для разворачивания. Примеры: 'renderedFields', 'transitions', 'changelog'

  • fieldsstring

    (Необязательно) Поля через запятую для возврата в результатах. Используйте '*all' для всех полей или укажите отдельные поля, например 'summary,status,assignee,priority'.

  • jqlstringобязательный

    Строка запроса JQL (Jira Query Language). Примеры: - Найти эпики: "issuetype = Epic AND project = PROJ" - Найти задачи в эпике: "parent = PROJ-123" - Найти по статусу: "status = 'In Progress' AND project = PROJ" - Найти по исполнителю: "assignee = currentUser()" - Найти недавно обновлённые: "updated >= -7d AND project = PROJ" - Найти по метке: "labels = frontend AND project = PROJ" - Найти по приоритету: "priority = High AND project = PROJ"

  • limitinteger

    Максимальное количество результатов

  • page_tokenstring

    (Необязательно) Токен пагинации из предыдущего результата поиска. Только для Cloud — Server/DC использует start_at для пагинации.

  • projects_filterstring

    Необязательный. Список ключей проектов через запятую для фильтрации результатов. Переопределяет переменную окружения JIRA_PROJECTS_FILTER, если она указана.

  • start_atinteger

    Начальный индекс для пагинации (с нуля)

  • use_display_namesboolean

    Когда значение true, ключи пользовательских полей в выводе используют человекочитаемые отображаемые имена (например, 'Story Points') вместо непрозрачных ID (например, 'customfield_10243'). Расширение 'names' добавляется автоматически. Стандартные поля не затрагиваются.

jira_search_assignable_usersтолько чтение

Ищет пользователей Jira, которым можно назначить задачу в указанном проекте или задаче. Используйте этот инструмент, когда есть отображаемое имя / часть имени / фрагмент email и нужен конкретный идентификатор (name / key для Server/DC, accountId для Cloud), чтобы передать его в assignee, reporter, watcher и прочее. Возвращает полный набор результатов, чтобы вызывающий код мог разрешить неоднозначность, когда подходят несколько пользователей — get_user_profile находит только один идентификатор и не предназначен для поиска по имени человека. Обязательно нужно передать ровно один из параметров: project_key или issue_key — базовый API (/user/assignable/search) требует контекст проекта или задачи и работает без глобального разрешения "Browse Users", которого часто не хватает учётным записям ботов в изолированных инстансах DC. Параметры: ctx: Контекст FastMCP. query: Отображаемое имя / имя пользователя / часть email. project_key: Ключ проекта (например, 'DT') для ограничения поиска. issue_key: Ключ задачи (например, 'DT-779') для ограничения поиска. limit: Максимальное количество возвращаемых пользователей. Возвращает: JSON-строка: {"success": true, "count": N, "users": [...]} в случае успеха, или объект ошибки при неудаче.

Поиск назначаемых пользователей

Параметры
  • issue_keystring

    Ключ задачи, чтобы ограничить поиск (например, 'DT-779'). Обязателен, если не указан project_key.

  • limitinteger

    Максимальное количество пользователей для возврата (по умолчанию 20).

  • project_keystring

    Ключ проекта для ограничения области поиска (например, 'DT'). Обязателен, если не указан issue_key.

  • querystringобязательный

    Произвольный текст для поиска пользователей Jira по: отображаемому имени, имени пользователя или части email (например, 'Smith', 'jane.doe', 'doe@example.com'). Поиск на стороне сервера не учитывает регистр и поддерживает частичное совпадение.

jira_search_fieldsтолько чтение

Ищет поля Jira по ключевому слову с нечётким соответствием. Аргументы: ctx: Контекст FastMCP. keyword: Ключевое слово для нечёткого поиска. limit: Максимальное количество результатов. refresh: Флаг принудительного обновления списка полей. Возвращает: Строка JSON, представляющая список соответствующих определений полей.

Поля поиска

Параметры
  • keywordstring

    Ключевое слово для нечёткого поиска. Если оставить пустым, перечисляет первые 'limit' доступных полей в порядке по умолчанию.

  • limitinteger

    Максимальное количество результатов

  • refreshboolean

    Нужно ли принудительно обновлять список полей

jira_search_projectsтолько чтение

Ищет проекты Jira по названию или префиксу ключа. Использует эндпоинт выбора проектов (projects picker), чтобы вернуть ранжированный список подходящих проектов без загрузки всех видимых проектов в экземпляре. Аргументы: ctx: Контекст FastMCP. query: Имя или префикс ключа для поиска. max_results: Максимальное количество возвращаемых результатов. current_project_ids: Идентификаторы проектов через запятую, которые нужно исключить. Возвращает: Строку JSON, содержащую список объектов подходящих проектов. Ключи проектов всегда возвращаются в верхнем регистре. Если настроен фильтр JIRA_PROJECTS_FILTER, возвращаются только проекты, соответствующие этим ключам.

Поиск проектов

Параметры
  • current_project_idsstring

    Список идентификаторов проектов через запятую, которые нужно исключить из результатов.

  • max_resultsinteger

    Максимальное количество результатов для возврата (1-100)

  • querystringобязательный

    Имя или префикс ключа для поиска

jira_transition_issue

Переводит задачу Jira в новый статус. Args: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. transition_id: ID перехода. fields: Необязательная JSON-строка с полями для обновления во время перехода. comment: Необязательный комментарий к переходу в формате Markdown. Returns: JSON-строка, представляющая обновлённый объект задачи. Raises: ValueError: Если отсутствуют обязательные поля, неверный ввод, режим только для чтения или клиент Jira недоступен.

Проблема перехода

Параметры
  • commentstring

    (Необязательно) Комментарий для добавления при переходе в формате Markdown. Он будет виден в истории задачи. Отклонено для проектов из списка JIRA_INTERNAL_ONLY_PROJECTS (комментарий при переходе может быть виден клиенту в JSM и не может быть принудительно внутренним): выполните переход без комментария, затем добавьте внутреннюю заметку с помощью jira_add_comment(public=false).

  • fieldsstring

    (Необязательно) JSON-строка с полями для обновления при переходе. Некоторые переходы требуют установки определенных полей (например, резолюция). Пример: '{"resolution": {"name": "Fixed"}}'

  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

  • transition_idstringобязательный

    ID перехода, который нужно выполнить. Сначала вызовите инструмент jira_get_transitions, чтобы получить доступные ID переходов для задачи. Примеры значений: '11', '21', '31'

jira_update_issue

Обновляет существующую задачу Jira, включая изменение статуса, добавление связей Epic, обновление полей и т.д. Args: ctx: Контекст FastMCP. issue_key: Ключ задачи Jira. fields: JSON-строка полей для обновления. Текстовые поля, например 'description', должны использовать формат Markdown. additional_fields: Необязательная JSON-строка дополнительных полей. components: Список имён компонентов через запятую. attachments: Необязательная JSON-строка массива или список путей к файлам через запятую. Returns: JSON-строка, представляющая обновлённый объект задачи и результаты прикрепления файлов. Raises: ValueError: если режим только для чтения или клиент Jira недоступен, или неверный ввод.

Обновить Issue

Параметры
  • additional_fieldsstring

    (Необязательно) JSON-строка с дополнительными полями для обновления. Используйте её для настраиваемых полей или более сложных обновлений. Ссылка на эпик: {"epicKey": "EPIC-123"} или {"epic_link": "EPIC-123"}.

  • attachmentsstring

    (Необязательно) JSON-массив строк или список путей к файлам через запятую для прикрепления к задаче. Пример: '/path/to/file1.txt,/path/to/file2.txt' или ['/path/to/file1.txt','/path/to/file2.txt']

  • componentsstring

    (Необязательно) Список названий компонентов через запятую (например, 'Frontend,API')

  • fieldsstringобязательный

    JSON-строка полей для обновления. Для 'assignee' укажите строковый идентификатор (email, имя или accountId). Для 'description' укажите текст в формате Markdown; в Jira Cloud используйте '{expand:Title}...{expand}' для сворачиваемого раздела. Пример: '{"assignee": "user@example.com", "summary": "New Summary", "description": "## Updated\nMarkdown text"}'

  • issue_keystringобязательный

    Ключ задачи Jira (например, 'PROJ-123', 'ACV2-642')

  • return_fieldsstring

    (Необязательно) Управляет тем, какие поля обновлённой задачи возвращаются, чтобы уменьшить размер ответа и расход токенов. По умолчанию '*all' (полная задача, которая может быть очень большой). СОВЕТ ПО ЭКОНОМИИ ТОКЕНОВ: после обновления вам обычно НЕ нужна вся задача целиком. Передавайте список через запятую только тех полей, которые вам важны (например, 'summary,duedate'), или одно лёгкое поле, например 'status', для минимального подтверждения - это может сократить ответ на тысячи токенов. Ключ задачи 'key' возвращается всегда, независимо от этого. Если позже понадобятся другие поля, получайте их по мере необходимости с помощью jira_get_issue (он тоже поддерживает фильтрацию полей). Используйте '*all' только тогда, когда вам действительно нужна полная обновлённая задача.

jira_update_proforma_form_answers

Обновляет ответы полей формы с помощью Jira Forms REST API. Это основной способ обновления данных формы. Каждый объект ответа должен содержать идентификатор вопроса, тип ответа и значение. ⚠️ ИЗВЕСТНОЕ ОГРАНИЧЕНИЕ - поля DATETIME: API Jira Forms НЕ сохраняет временную часть в полях DATETIME. Запоминается только дата; время сбрасывается на полночь (00:00:00). Обход для полей DATETIME: Обновляйте соответствующие кастомные поля напрямую через jira_update_issue: 1. Получите ID кастомного поля из описания формы (свойство "jiraField" вопроса) 2. Вызовите jira_update_issue с полями вроде: {"customfield_XXXXX": "2026-01-09T11:50:00-08:00"} Пример: python # Вместо обновления через форму (время теряется): # jira_update_proforma_form_answers(issue_key, form_id, [{"questionId": "91", "type": "DATETIME", "value": "..."}]) # Обновляйте поле напрямую (время сохраняется): jira_update_issue(issue_key, {"customfield_10542": "2026-01-09T11:50:00-08:00"}) Автоматическое преобразование даты и времени: Для полей DATE и DATETIME можно передавать значения как: - ISO 8601 строки (например, "2024-12-17T19:00:00Z", "2024-12-17") - Unix-таймстемпы в миллисекундах (например, 1734465600000) Инструмент сам преобразует ISO 8601 строки в Unix-таймстемпы. Примеры ответов: [ {"questionId": "q1", "type": "TEXT", "value": "Обновлённое описание"}, {"questionId": "q2", "type": "SELECT", "value": "Продукт A"}, {"questionId": "q3", "type": "NUMBER", "value": 42}, {"questionId": "q4", "type": "DATE", "value": "2024-12-17"} ] Распространённые типы ответов: - TEXT: строковые значения - NUMBER: числовые значения - DATE: значения даты (ISO 8601 строка или Unix-таймстемп в мс) - DATETIME: значения даты и времени - ⚠️ ИСПОЛЬЗУЙТЕ ОБХОД ВЫШЕ - SELECT: одиночный выбор из вариантов - MULTI_SELECT: множественный выбор (значение в виде списка) - CHECKBOX: булевы значения Аргументы: ctx: Контекст FastMCP. issue_key: Ключ задачи, содержащей форму. form_id: UUID формы (получить из…

Обновить ответы формы

Параметры
  • answersobject[]обязательный

    Вот список объектов ответов. Каждый ответ должен содержать: questionId (строка), type (TEXT/NUMBER/SELECT и т. д.), value (любое значение). Пример: json [ { "questionId": "q1", "type": "TEXT", "value": "Некоторый текст" }, { "questionId": "q2", "type": "NUMBER", "value": 42 }, { "questionId": "q3", "type": "SELECT", "value": "вариант_б" } ]

  • form_idstringобязательный

    : Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat.: Get last error in the chat.: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the chat. response: Get last error in the

  • issue_keystringобязательный

    Ключ задачи JIRA (например, PROJ-123)

jira_update_sprint

Обновляет спринт Jira. Аргументы: ctx: Контекст FastMCP. sprint_id: ID спринта. name: Новое название (необязательно). state: Новое состояние (future|active|closed) (необязательно). start_date: Новая дата начала (необязательно). end_date: Новая дата окончания (необязательно). goal: Новая цель (необязательно). Возвращает: JSON-строку с обновлённым объектом спринта или сообщением об ошибке. Вызывает: ValueError: Если включён режим только для чтения или клиент Jira недоступен.

Обновить спринт

Параметры
  • end_datestring

    (Необязательно) Новая дата окончания спринта

  • goalstring

    (Необязательно) Новая цель спринта

  • namestring

    (Необязательно) Новое название спринта

  • sprint_idstringобязательный

    Идентификатор спринта (например, '10001').

  • start_datestring

    (Необязательно) Новая дата начала спринта

  • statestring

    (Необязательно) Новое состояние спринта (future|active|closed)

jira_update_version

Обновляет существующую версию в проекте Jira. Изменяются только явно указанные поля; остальные атрибуты версии остаются без изменений. Пригодится, чтобы архивировать/разархивировать версии, переименовывать или сдвигать даты релиза без пересоздания. Аргументы: ctx: Контекст FastMCP. version_id: Числовой ID версии, которую нужно обновить. name: Новое название (необязательно). description: Новое описание (необязательно). start_date: Новая дата старта в формате YYYY-MM-DD (необязательно). release_date: Новая дата релиза в формате YYYY-MM-DD (необязательно). archived: Флаг архивации (необязательно). released: Флаг выпуска (необязательно). Возвращает: JSON-строку с объектом обновлённой версии.

Обновить версию

Параметры
  • archivedboolean

    Устанавливает флаг архивации (true для архивации)

  • descriptionstring

    Новое описание для версии

  • namestring

    Новое название для версии.

  • releasedboolean

    Устанавливает флаг выпуска (true, чтобы пометить как выпущенный)

  • release_datestring

    Новая дата релиза (ГГГГ-ММ-ДД)

  • start_datestring

    Новая дата начала (YYYY-MM-DD)

  • version_idstringобязательный

    Числовой идентификатор версии для обновления (например, «10001»).

0.23.1основная
0.23.0
0.22.1
0.22.0
0.21.1
0.21.0
0.20.1
0.20.0
0.19.0
0.18.1
0.18.0
0.17.0
0.16.1
0.16.0
0.15.0
0.14.3
0.14.2
0.14.1
0.14.0
0.13.1
0.13.0
0.12.0
0.11.12
0.11.11
0.11.10
0.11.9
0.11.8
0.11.7
0.11.6
0.11.5
0.11.4
0.11.3
0.11.2
0.11.2a2
0.11.1
0.11.0
0.10.6
0.10.5
0.10.4
0.10.3
0.10.2
0.10.1
0.10.0
0.9.0
0.8.4
0.8.3
0.8.2
0.8.1
0.8.0
0.7.1
0.7.0
0.6.5
0.6.4
0.6.3
0.6.2
0.6.1
0.6.0
0.5.0
0.4.0
0.3.1
0.3.0
0.2.6
0.2.5
0.2.4
0.2.3
0.2.2
0.2.1
0.2.0
0.1.16
0.1.15
0.1.14
0.1.13
0.1.12
0.1.11
0.1.10
0.1.9
0.1.8
0.1.7
0.1.6
0.1.4
0.1.3
0.1.2
0.1.1

Выберите клиент, чтобы установить sooperset/mcp-atlassian:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "sooperset-mcp-atlassian-cli1hjtrnh": {
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      },
      "args": [
        "mcp-atlassian"
      ],
      "command": "uvx"
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "sooperset-mcp-atlassian-cli1hjtrnh": {
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      },
      "args": [
        "mcp-atlassian"
      ],
      "command": "uvx"
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "sooperset-mcp-atlassian-cli1hjtrnh": {
      "type": "stdio",
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      },
      "args": [
        "mcp-atlassian"
      ],
      "command": "uvx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"sooperset-mcp-atlassian-cli1hjtrnh\",\"type\":\"stdio\",\"env\":{\"JIRA_URL\":\"https://your-company.atlassian.net\",\"JIRA_USERNAME\":\"your.email@company.com\",\"CONFLUENCE_URL\":\"https://your-company.atlassian.net/wiki\",\"JIRA_API_TOKEN\":\"your_api_token\",\"CONFLUENCE_USERNAME\":\"your.email@company.com\",\"CONFLUENCE_API_TOKEN\":\"your_api_token\"},\"args\":[\"mcp-atlassian\"],\"command\":\"uvx\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "sooperset-mcp-atlassian-cli1hjtrnh": {
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      },
      "args": [
        "mcp-atlassian"
      ],
      "command": "uvx"
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add sooperset-mcp-atlassian-cli1hjtrnh --env JIRA_URL=https://your-company.atlassian.net --env JIRA_USERNAME=your.email@company.com --env CONFLUENCE_URL=https://your-company.atlassian.net/wiki --env JIRA_API_TOKEN=your_api_token --env CONFLUENCE_USERNAME=your.email@company.com --env CONFLUENCE_API_TOKEN=your_api_token -- uvx mcp-atlassian

Либо через JSON-конфиг:

claude mcp add-json sooperset-mcp-atlassian-cli1hjtrnh "{\"env\":{\"JIRA_URL\":\"https://your-company.atlassian.net\",\"JIRA_USERNAME\":\"your.email@company.com\",\"CONFLUENCE_URL\":\"https://your-company.atlassian.net/wiki\",\"JIRA_API_TOKEN\":\"your_api_token\",\"CONFLUENCE_USERNAME\":\"your.email@company.com\",\"CONFLUENCE_API_TOKEN\":\"your_api_token\"},\"args\":[\"mcp-atlassian\"],\"command\":\"uvx\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add sooperset-mcp-atlassian-cli1hjtrnh --env JIRA_URL=https://your-company.atlassian.net --env JIRA_USERNAME=your.email@company.com --env CONFLUENCE_URL=https://your-company.atlassian.net/wiki --env JIRA_API_TOKEN=your_api_token --env CONFLUENCE_USERNAME=your.email@company.com --env CONFLUENCE_API_TOKEN=your_api_token -- uvx mcp-atlassian

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.sooperset-mcp-atlassian-cli1hjtrnh]
command = "uvx"
args = ["mcp-atlassian"]

[mcp_servers.sooperset-mcp-atlassian-cli1hjtrnh.env]
JIRA_URL = "https://your-company.atlassian.net"
JIRA_USERNAME = "your.email@company.com"
CONFLUENCE_URL = "https://your-company.atlassian.net/wiki"
JIRA_API_TOKEN = "your_api_token"
CONFLUENCE_USERNAME = "your.email@company.com"
CONFLUENCE_API_TOKEN = "your_api_token"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите sooperset/mcp-atlassian, а в поле команды запуска — строку ниже:
uvx mcp-atlassian

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "sooperset-mcp-atlassian-cli1hjtrnh": {
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      },
      "args": [
        "mcp-atlassian"
      ],
      "command": "uvx"
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "sooperset-mcp-atlassian-cli1hjtrnh": {
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      },
      "args": [
        "mcp-atlassian"
      ],
      "command": "uvx",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например sooperset-mcp-atlassian-cli1hjtrnh.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: sooperset-mcp-atlassian-cli1hjtrnh
    command: uvx
    args:
      - "mcp-atlassian"
    env:
      JIRA_URL: https://your-company.atlassian.net
      JIRA_USERNAME: your.email@company.com
      CONFLUENCE_URL: https://your-company.atlassian.net/wiki
      JIRA_API_TOKEN: your_api_token
      CONFLUENCE_USERNAME: your.email@company.com
      CONFLUENCE_API_TOKEN: your_api_token
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "sooperset-mcp-atlassian-cli1hjtrnh": {
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      },
      "args": [
        "mcp-atlassian"
      ],
      "command": "uvx"
    }
  }
}

Похожие MCP-сервера

raalarcon9705/jira-mcp

raalarcon9705/jira-mcp

от raalarcon9705

MCP-сервер для интеграции Jira и Atlassian с AI-ассистентами. Управляйте задачами, спринтами, комментариями и страницами Confluence из Claude, Cursor и других MCP-клиентов. Оптимизирован для токено...

TypeScript⭐ 6
aashari/mcp-server-atlassian-confluence

aashari/mcp-server-atlassian-confluence

от aashari

MCP сервер для подключения ИИ-ассистентов к Confluence: задавайте вопросы документации, ищите по всем пространствам, создавайте и обновляйте страницы. Полезен разработчикам, менеджерам и всем, кто ...

TypeScript⭐ 62
aashari/mcp-server-atlassian-jira

aashari/mcp-server-atlassian-jira

от aashari

Подключает AI-ассистентов к Jira: запрашивайте проекты, задачи, комментарии на естественном языке. Упрощает управление проектами и отслеживание работы для разработчиков, менеджеров и всех пользоват...

TypeScript⭐ 77
nguyenvanduocit/jira-mcp

nguyenvanduocit/jira-mcp

от nguyenvanduocit

Jira MCP — сервер для интеграции AI-ассистентов с Atlassian Jira. Предоставляет инструменты для управления задачами, спринтами, комментариями, поиска по JQL и отслеживания разработки (PR, коммиты)....

Go⭐ 97
FacundoLucci/plsreadme

FacundoLucci/plsreadme

от facundolucci

MCP сервер plsreadme превращает markdown в красивые веб-страницы и создаёт ссылки для шаринга. Помогает разработчикам и редакторам публиковать README, PRD и заметки. Работает с AI-редакторами (Claude, Cursor), поддерживает комментирование и версионирование.

TypeScript⭐ 4
makeplane/plane-mcp-server

makeplane/plane-mcp-server

от makeplane

Управляет проектами и задачами в Plane: создаёт work items, ищет их по воркспейсу, ведёт циклы и проекты. Облачный хостинг от Plane или локальный запуск.

Python⭐ 343
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин