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

sooperset/mcp-atlassian

от sooperset
MCP сервер для Atlassian (Confluence и Jira, Cloud и Server/Data Center). AI-агенты используют 72 инструмента: поиск, создание, обновление задач и страниц, комментарии и статусы, ускоряя разработку.

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

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

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обязательный

    The comment content in Markdown format

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

    The ID of the page to add a comment to

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обязательный

    The comment content in Markdown format

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

    The ID of the page to add the inline comment to

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

    The exact text on the page to anchor the inline comment to. Must match text that exists in the page content.

  • text_selection_match_countinteger

    Total number of times the selected text appears on the page. Defaults to 1.

  • text_selection_match_indexinteger

    Zero-based index of which occurrence of the text to anchor to. Defaults to 0 (first occurrence).

confluence_add_label

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

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

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

    Label name to add (lowercase, no spaces). Examples: 'draft', 'reviewed', 'confidential', 'v1.0'. Labels help organize and categorize content.

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

    Confluence content ID to label. For pages/blogs: numeric ID (e.g., '123456789'). For attachments: ID with 'att' prefix (e.g., 'att123456789'). Use get_attachments to find attachment IDs.

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

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

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

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

    Confluence content ID (page, blog post, comment, or attachment). Example: '123456789'

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

    The operation to check. Common values: 'read', 'update', 'delete', 'export', 'purge', 'administer', 'create_or_delete_from_view'.

  • subject_typestring

    Whether the subject is a 'user' or a 'group'. Defaults to 'user'.

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

    Account ID of the user (for subject_type='user') or group ID (for subject_type='group'). Example user account ID: '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

    (Optional) Whether to copy attachments to the new page. Defaults to true. Only supported on Confluence Cloud.

  • destination_parent_idstring

    (Optional) Parent page ID in the destination space. When omitted the page is created at the space root.

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

    Space key for the new page (e.g. 'DEV', 'TEAM')

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

    Title for the new copied page

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

    The ID of the page to copy

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

    The content of the page. Format depends on content_format parameter. Can be Markdown (default), wiki markup, storage format, or XHTML storage format. Either 'content' or 'content_file' must be provided, but not both.

  • content_filestring

    (Optional) Absolute or relative filesystem path to read the page body from (UTF-8). Use this instead of 'content' when the body is too large to pass comfortably as a tool argument. Mutually exclusive with 'content'.

  • content_formatstring

    (Optional) The format of the content parameter. Options: 'markdown' (default), 'wiki', 'storage', or 'xhtml'. Use 'xhtml' when providing Confluence XHTML storage format (same as 'storage'). Wiki format uses Confluence wiki markup syntax

  • emojistring

    (Optional) Page title emoji (icon shown in navigation). Can be any emoji character like '📝', '🚀', '📚'. Set to null/None to remove.

  • enable_heading_anchorsboolean

    (Optional) Whether to enable automatic heading anchor generation. Only applies when content_format is 'markdown'

  • include_contentboolean

    (Optional) Whether to include page content in the response. Defaults to false since callers already have the content at create time

  • page_widthstring

    (Optional) Page layout width. Options: 'full-width', 'default'. Defaults to null (Confluence default).

  • parent_idstring

    (Optional) parent page ID. If provided, this page will be created as a child of the specified page

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

    The key of the space to create the page in (usually a short uppercase code like 'DEV', 'TEAM', or 'DOC')

  • subtypestring

    (Optional) Confluence page subtype. Use 'live' to create a Confluence Live Doc. Only supported for Confluence Cloud.

  • table_layoutstring

    (Optional) Table width preset applied to all markdown tables. Options: 'full-width' (1800 px), 'wide' (960 px), 'default' (760 px). Only applies when content_format is 'markdown'.

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

    The title of the page

confluence_create_page_from_template

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

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

Параметры
  • parent_idstring

    Optional ID of the parent page.

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

    Key of the space in which to create the page.

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

    ID of the template to use as the page body.

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

    Title for the new page.

confluence_delete_attachment

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

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

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

    The ID of the attachment to delete. Attachment IDs can be found using the get_attachments tool. Example: 'att123456789'. Warning: This permanently deletes the attachment and all its versions.

confluence_delete_page

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

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

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

    The ID of the page to delete

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

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

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

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

    The ID of the attachment to download (e.g., 'att123456789'). Find attachment IDs using get_attachments tool. Example workflow: get_attachments(content_id) → use returned ID here.

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

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

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

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

    The ID of the Confluence content (page or blog post) to download attachments from. Example: '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обязательный

    The ID of the Confluence content (page or blog post) to list attachments for. Example: '123456789'

  • filenamestring

    (Optional) Filter results to only attachments matching this filename. Exact match only. Example: 'report.pdf'

  • limitinteger

    (Optional) Maximum number of attachments to return per request (1-100). Use pagination (start/limit) for large attachment lists. Default: 50

  • media_typestring

    (Optional) Filter by MIME type. Note: Confluence API returns 'application/octet-stream' for most binary files (PNG, JPG, PDF) instead of specific MIME types like 'image/png'. For more reliable filtering, use the 'filename' parameter. Examples: 'application/octet-stream' (binary files), 'application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' (for .docx)

  • startinteger

    (Optional) Starting index for pagination. Use 0 for the first page. To get the next page, add the 'limit' value to 'start'. Default: 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обязательный

    The ID of the page to get inline comments from

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

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

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

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

    Confluence content ID (page, blog post, or attachment). For pages: numeric ID from URL (e.g., '123456789'). For attachments: ID with 'att' prefix (e.g., 'att123456789'). Works with any Confluence content type that supports labels.

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

    Whether to convert page to markdown (true) or keep it in raw HTML format (false). Raw HTML can reveal macros (like dates) not visible in markdown, but CAUTION: using HTML significantly increases token usage in AI responses.

  • include_metadataboolean

    Whether to include page metadata such as creation date, last update, version, and labels.

  • page_idstring

    Confluence page ID, full page URL, or tiny link. For example: '123456789', 'https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title', or 'https://example.atlassian.net/wiki/x/N4CIO'. Provide this OR both 'title' and 'space_key'. If page_id is provided, title and space_key will be ignored.

  • space_keystring

    The key of the Confluence space where the page resides (e.g., 'DEV', 'TEAM'). Required if using 'title'.

  • titlestring

    The exact title of the Confluence page. Use this with 'space_key' if 'page_id' is not known.

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

    Whether to convert page content to markdown (true) or keep it in raw HTML format (false). Only relevant if include_content is true.

  • expandstring

    Fields to expand in the response (e.g., 'version', 'body.storage')

  • include_contentboolean

    Whether to include the page content in the response

  • include_foldersboolean

    Whether to include child folders in addition to child pages

  • limitinteger

    Maximum number of child items to return (1-50)

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

    The ID of the parent page whose children you want to retrieve

  • startinteger

    Starting index for pagination (0-based)

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

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

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

Параметры
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

    Whether to convert page to markdown (true) or keep it in raw HTML format (false). Raw HTML can reveal macros (like dates) not visible in markdown, but CAUTION: using HTML significantly increases token usage in AI responses.

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

    Confluence page ID (numeric ID, can be found in the page URL). For example, in 'https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title', the page ID is '123456789'.

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

    The version number of the page to retrieve

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обязательный

    The ID of the Confluence page or blog post to retrieve images from. Example: '123456789'

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

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

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

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

    The ID of the page

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

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

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

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

    The ID of the template to retrieve.

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

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

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

Параметры
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

    Max pages to fetch

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

    Space key

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

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

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

Параметры
  • cursorstring

    Optional pagination cursor from a previous response.

  • limitinteger

    Maximum number of permission entries to return. Defaults to 25.

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

    Numeric ID of the Confluence space. This is the internal space ID, not the space key. Example: '98304'. You can find the space ID from the Confluence REST API (GET /wiki/api/v2/spaces) or from the space URL.

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

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

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

Параметры
  • limitinteger

    Maximum number of templates to return.

  • space_keystring

    Optional space key to list templates defined in that space. When omitted, global templates are returned.

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 of the page to move

  • positionstring

    Position: 'append' (default, move as child of target), 'above' (move before target as sibling), or 'below' (move after target as sibling)

  • target_parent_idstring

    Target parent page ID. If omitted with target_space_key, moves to space root.

  • target_space_keystring

    Target space key for cross-space moves

confluence_reply_to_comment

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

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

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

    The reply content in Markdown format

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

    The ID of the parent comment to reply to

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

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

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

Параметры
  • limitinteger

    Maximum number of results (1-50)

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

    Search query - can be either a simple text (e.g. 'project documentation') or a CQL query string. Simple queries use 'siteSearch' by default, to mimic the WebUI search, with an automatic fallback to 'text' search if not supported. Examples of CQL: - Basic search: 'type=page AND space=DEV' - Personal space search: 'space="username"' (note: personal space keys starting with ~ must be quoted) - Search by title: 'title"Meeting Notes"' - Use siteSearch: 'siteSearch ~ "important concept"' - Use text search: 'text ~ "important concept"' - Recent content: 'created >= "2023-01-01"' - Content with specific label: 'label=documentation' - Recently modified content: 'lastModified > startOfMonth("-1M")' - Content modified this year: 'creator = currentUser() AND lastModified > startOfYear()' - Content you contributed to recently: 'contributor = currentUser() AND lastModified > startOfWeek()' - Content watched by user: 'watcher = "user@domain.com" AND type = page' - Exact phrase in content: 'text ~ ""Urgent Review Required"" AND label = "pending-approval"' - Title wildcards: 'title ~ "Minutes*" AND (space = "HR" OR space = "Marketing")' Note: Special identifiers need proper quoting in CQL: personal space keys (e.g., "~username"), reserved words, numeric IDs, and identifiers with special characters.

  • spaces_filterstring

    (Optional) Comma-separated list of space keys to filter results by. Overrides the environment variable CONFLUENCE_SPACES_FILTER if provided. Use empty string to disable filtering.

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

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

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

Параметры
  • group_namestring

    Group to search within on Server/DC instances (default: 'confluence-users'). Ignored on Cloud.

  • limitinteger

    Maximum number of results (1-50)

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

    Search query - a CQL query string for user search. Examples of CQL: - Basic user lookup by full name: 'user.fullname ~ "First Last"' Note: Special identifiers need proper quoting in CQL: personal space keys (e.g., "~username"), reserved words, numeric IDs, and identifiers with special characters.

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[]

    (Optional) Group names allowed to edit the page.

  • edit_usersstring[]

    (Optional) Account IDs (Cloud) or usernames (Server/DC) allowed to edit the page.

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

    The ID of the page to restrict

  • read_groupsstring[]

    (Optional) Group names allowed to view the page.

  • read_usersstring[]

    (Optional) Account IDs (Cloud) or usernames (Server/DC) allowed to view the page. Empty list = unrestricted.

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

    The new content of the page. Format depends on content_format parameter and may be Markdown (default), wiki markup, storage format, or XHTML storage format. Either 'content' or 'content_file' must be provided, but not both.

  • content_filestring

    (Optional) Absolute or relative filesystem path to read the new page body from (UTF-8). Use this instead of 'content' when the body is too large to pass comfortably as a tool argument. Mutually exclusive with 'content'.

  • content_formatstring

    (Optional) The format of the content parameter. Options: 'markdown' (default), 'wiki', 'storage', or 'xhtml'. Use 'xhtml' when providing Confluence XHTML storage format (same as 'storage'). Wiki format uses Confluence wiki markup syntax

  • emojistring

    (Optional) Page title emoji (icon shown in navigation). Can be any emoji character like '📝', '🚀', '📚'. Set to null/None to remove.

  • enable_heading_anchorsboolean

    (Optional) Whether to enable automatic heading anchor generation. Only applies when content_format is 'markdown'

  • include_contentboolean

    (Optional) Whether to include page content in the response. Defaults to false since callers already have the content at update time

  • is_minor_editboolean

    Whether this is a minor edit

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

    The ID of the page to update

  • page_widthstring

    (Optional) Page layout width. Options: 'full-width', 'default'. Defaults to null (preserve existing).

  • parent_idstring

    Optional the new parent page ID

  • table_layoutstring

    (Optional) Table width preset applied to all markdown tables. Options: 'full-width' (1800 px), 'wide' (960 px), 'default' (760 px). Only applies when content_format is 'markdown'.

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

    The new title of the page

  • version_commentstring

    Optional comment for this version

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

    (Optional) Format of new_content. Options: 'markdown' (default) or 'storage' (raw Confluence storage XML). Use 'storage' to insert macros or elements that markdown cannot express.

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

    Exact text of the heading that starts the section to replace. Matching is case-sensitive. Use confluence_get_page with convert_to_markdown=false to inspect exact heading text when unsure.

  • is_minor_editboolean

    Whether this is a minor edit

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

    Replacement content for the section body. Do NOT include the heading itself — only the body beneath it. Format is controlled by content_format.

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

    The ID of the page to update

  • version_commentstring

    Optional comment for this version

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

    (Optional) A comment describing this attachment or version. Visible in the attachment history. Example: 'Updated Q4 2024 figures'

  • content_base64string

    (Optional) Base64-encoded file content to upload directly, without the server reading from disk. Use this when the server cannot access host file paths (e.g. a remote or containerized MCP server). Requires 'filename'. Provide either 'file_path' or 'content_base64', not both.

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

    The ID of the Confluence content (page or blog post) to attach the file to. Page IDs can be found in the page URL or by using the search/get_page tools. Example: '123456789'

  • filenamestring

    (Optional) Attachment filename, including extension (e.g. 'report.pdf'). Required when using 'content_base64'; it determines the attachment title and file type. Ignored when 'file_path' is used.

  • file_pathstring

    Full path to the file to upload. Can be absolute (e.g., '/home/user/document.pdf' or 'C:\Users\name\file.docx') or relative to the current working directory (e.g., './uploads/document.pdf'). If a file with the same name already exists, a new version will be created. Requires the server to be able to read the path; for remote or containerized servers use 'content_base64' instead. Provide either 'file_path' or 'content_base64', not both.

  • minor_editboolean

    (Optional) Whether this is a minor edit. If true, watchers are not notified. Default is false.

confluence_upload_attachments

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

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

Параметры
  • commentstring

    (Optional) Comment for all uploaded attachments. Visible in version history. Example: 'Q4 2024 batch upload'

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

    The ID of the Confluence content (page or blog post) to attach files to. Example: '123456789'. If uploading multiple files with the same names, new versions will be created automatically.

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

    Comma-separated list of file paths to upload. Can be absolute or relative paths. Examples: './file1.pdf,./file2.png' or 'C:\docs\report.docx,D:\image.jpg'. All files uploaded with same comment/minor_edit settings.

  • minor_editboolean

    (Optional) Whether this is a minor edit. If true, watchers are not notified. Default is false.

jira_add_comment

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

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

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

    Comment text in Markdown format

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

  • publicboolean

    (Optional) For JSM/Service Desk issues only. Set to true for customer-visible comment, false for internal agent-only comment. Posted via the ServiceDesk API as a raw string; Jira Cloud renders it server-side and stores ADF (markdown observed to render on Cloud, without the client-side markdown-to-ADF guarantees of the regular comment path). Cannot be combined with visibility. If the issue's project is listed in JIRA_INTERNAL_ONLY_PROJECTS, only public=false is accepted — public=true or omitting this field is rejected.

  • visibilitystring

    (Optional) Comment visibility as JSON string (e.g. '{"type":"group","value":"jira-users"}')

jira_add_issues_to_sprint

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

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

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

    Comma-separated issue keys (e.g., 'PROJ-1,PROJ-2')

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

    Sprint ID to add issues to

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 issue key (e.g., 'PROJ-123')

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

    User to add as watcher. For Jira Cloud, use the account ID. For Jira Server/DC, use the username.

jira_add_worklog

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

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

Параметры
  • commentstring

    (Optional) Comment for the worklog in Markdown format

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

  • original_estimatestring

    (Optional) New value for the original estimate

  • remaining_estimatestring

    (Optional) New value for the remaining estimate

  • startedstring

    (Optional) Start time in ISO format. If not provided, the current time will be used. Example: '2023-08-01T12:00:00.000+0000'

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

    Time spent in Jira format. Examples: '1h 30m' (1 hour and 30 minutes), '1d' (1 day), '30m' (30 minutes), '4h' (4 hours)

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

    User identifier to assign (email, display name, or account ID), or a JSON object string from jira_search_assignable_users. Pass null or empty string to unassign the issue.

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

jira_batch_create_issues

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

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

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

    JSON array of issue objects. Each object should contain: - project_key (required): The project key (e.g., 'PROJ') - summary (required): Issue summary/title - issue_type (required): Type of issue (e.g., 'Task', 'Bug') - description (optional): Issue description in Markdown format - assignee (optional): Assignee username or email - components (optional): Array of component names Example: [ {"project_key": "PROJ", "summary": "Issue 1", "issue_type": "Task"}, {"project_key": "PROJ", "summary": "Issue 2", "issue_type": "Bug", "components": ["Frontend"]} ]

  • validate_onlyboolean

    If true, only validates the issues without creating them

jira_batch_create_versions

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

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

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

    Jira project key (e.g., 'PROJ', 'ACV2')

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

    JSON array of version objects. Each object should contain: - name (required): Name of the version - startDate (optional): Start date (YYYY-MM-DD) - releaseDate (optional): Release date (YYYY-MM-DD) - description (optional): Description of the version Example: [ {"name": "v1.0", "startDate": "2025-01-01", "releaseDate": "2025-02-01", "description": "First release"}, {"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

    (Optional) Comma-separated list of fields to filter changelogs by (e.g. 'status,assignee'). Default to None for all fields.

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

    Comma-separated list of Jira issue IDs or keys (e.g. 'PROJ-123,PROJ-124')

  • limitinteger

    Maximum number of changelogs to return in result for each issue. Default to -1 for all changelogs. Notice that it only limits the results in the response, the function will still fetch all the data.

jira_create_customer_request

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

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

Параметры
  • attachmentsstring

    (Optional) JSON array string of files to attach to the created request. Each object must contain 'filename', 'mime_type', and base64-encoded 'base64' content. Example: [{"filename": "log.txt", "mime_type": "text/plain", "base64": "aGVsbG8="}]

  • raise_on_behalf_ofstring

    (Optional) Jira user identifier for raiseOnBehalfOf. For Server/DC this is typically username or key; for Cloud use the identifier expected by your JSM instance.

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

    JSON string of request field values keyed by field ID. Examples: - Summary and description: {"summary": "Access issue", "description": "Cannot log in"} - Multi-value field: {"customfield_10001": ["alice", "bob"]}

  • request_participantsstring

    (Optional) JSON array string or comma-separated list of request participants. Examples: ["user1","user2"] or "user1,user2"

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

    Request type ID (e.g., '23')

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

    Service desk ID (e.g., '4')

  • strict_on_behalfboolean

    If true, fail immediately when raiseOnBehalfOf cannot be applied. If false, retry without raiseOnBehalfOf and return a fallback warning.

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

    (Optional) JSON string of additional fields to set. Examples: - Set priority: {"priority": {"name": "High"}} - Add labels: {"labels": ["frontend", "urgent"]} - Link to parent (for any issue type): {"parent": "PROJ-123"} - Link to epic: {"epicKey": "EPIC-123"} or {"epic_link": "EPIC-123"} - Set Fix Version/s: {"fixVersions": [{"id": "10020"}]} - Custom fields: {"customfield_10010": "value"}

  • assigneestring

    (Optional) Assignee's user identifier (string): Email, display name, or account ID (e.g., 'user@example.com', 'John Doe', 'accountid:...')

  • componentsstring

    (Optional) Comma-separated list of component names to assign (e.g., 'Frontend,API')

  • descriptionstring

    Issue description in Markdown format. On Jira Cloud, use '{expand:Title}...{expand}' for a collapsible section.

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

    Issue type (e.g. 'Task', 'Bug', 'Story', 'Epic', 'Subtask'). The available types depend on your project configuration. For subtasks, use 'Subtask' (not 'Sub-task') and include parent in additional_fields.

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

    The JIRA project key (e.g. 'PROJ', 'DEV', 'ACV2'). This is the prefix of issue keys in your project. Never assume what it might be, always ask the user.

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

    Summary/title of the issue

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

    (Optional) Comment to add to the link. Rejected when either linked issue belongs to a project listed in JIRA_INTERNAL_ONLY_PROJECTS (a link comment may be customer-visible on JSM and cannot be forced internal): create the link without a comment, then post an internal note with jira_add_comment(public=false) on the relevant issue.

  • comment_visibilitystring

    (Optional) Visibility settings for the comment as JSON string (e.g. '{"type":"group","value":"jira-users"}')

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

    The key of the inward issue (e.g., 'PROJ-123', 'ACV2-642')

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

    The type of link to create (e.g., 'Duplicate', 'Blocks', 'Relates to')

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

    The key of the outward issue (e.g., '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

    (Optional) URL to a 16x16 icon for the link

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

    The key of the issue to add the link to (e.g., 'PROJ-123', 'ACV2-642')

  • relationshipstring

    (Optional) Relationship description (e.g., 'causes', 'relates to', 'documentation')

  • summarystring

    (Optional) Description of the link

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

    The title/name of the link (e.g., 'Documentation Page', 'Confluence Page')

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

    The URL to link to (e.g., 'https://example.com/page' or Confluence page URL)

jira_create_sprint

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

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

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

    The id of board (e.g., '1000')

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

    End time for sprint (ISO 8601 format)

  • goalstring

    (Optional) Goal of the sprint

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

    Name of the sprint (e.g., 'Sprint 1')

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

    Start time for sprint (ISO 8601 format)

jira_create_version

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

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

Параметры
  • descriptionstring

    Description of the version

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

    Name of the version

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

    Jira project key (e.g., 'PROJ', 'ACV2')

  • release_datestring

    Release date (YYYY-MM-DD)

  • start_datestring

    Start date (YYYY-MM-DD)

jira_delete_issue

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

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

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

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

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

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

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

jira_edit_comment

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

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

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

    Updated comment text in Markdown format

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

    The ID of the comment to edit

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

  • visibilitystring

    (Optional) Comment visibility as JSON string (e.g. '{"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

    (Optional) The name of board, support fuzzy search

  • board_typestring

    (Optional) The type of jira board (e.g., 'scrum', 'kanban')

  • limitinteger

    Maximum number of results (1-50)

  • project_keystring

    (Optional) Jira project key (e.g., 'PROJ', 'ACV2')

  • start_atinteger

    Starting index for pagination (0-based)

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

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

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

Параметры
  • include_archivedboolean

    Whether to include archived projects in the results

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

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

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

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

    The id of the board (e.g., '1001')

  • expandstring

    Optional fields to expand in the response (e.g., 'changelog').

  • fieldsstring

    Comma-separated fields to return in the results. Use '*all' for all fields, or specify individual fields like 'summary,status,assignee,priority'

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

    JQL query string (Jira Query Language). Examples: - Find Epics: "issuetype = Epic AND project = PROJ" - Find issues in Epic: "parent = PROJ-123" - Find by status: "status = 'In Progress' AND project = PROJ" - Find by assignee: "assignee = currentUser()" - Find recently updated: "updated >= -7d AND project = PROJ" - Find by label: "labels = frontend AND project = PROJ" - Find by priority: "priority = High AND project = PROJ"

  • limitinteger

    Maximum number of results (1-50)

  • start_atinteger

    Starting index for pagination (0-based)

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обязательный

    The issue type ID (from get_project_issue_types). Example: '10002' for Task.

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

    Jira project key (e.g., 'PROJ', 'JTEST')

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

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

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

Параметры
  • max_issuesinteger

    Maximum issues to scan for links (1-500)

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

    Jira project key (e.g., '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

    Case-insensitive substring filter on option values. Also matches child values in cascading selects.

  • context_idstring

    Field context ID (Cloud only). If omitted, auto-resolves to the global context.

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

    Custom field ID (e.g., 'customfield_10001'). Use jira_search_fields to find field IDs.

  • issue_typestring

    Issue type name (required for Server/DC). Example: 'Bug'

  • project_keystring

    Project key (required for Server/DC). Example: 'PROJ'

  • return_limitinteger

    Maximum number of results to return (applied after filtering).

  • values_onlyboolean

    If true, return only value strings in a compact JSON format instead of full option objects.

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

    Maximum number of comments to include (0 or null for no comments)

  • expandstring

    (Optional) Fields to expand. Examples: 'renderedFields' (for rendered content), 'transitions' (for available status transitions), 'changelog' (for history)

  • fieldsstring

    (Optional) Comma-separated list of fields to return (e.g., 'summary,status,customfield_10010'). You may also provide a single field as a string (e.g., 'duedate'). Use '*all' for all fields (including custom fields), or omit for essential fields only.

  • includestring

    (Optional) Comma-separated sections to inline in the response, avoiding extra tool calls. Supported: all, remote_links, transitions, watchers, changelog, comments, worklogs

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

  • propertiesstring

    (Optional) A comma-separated list of issue properties to return

  • update_historyboolean

    Whether to update the issue view history for the requesting user

  • use_display_namesboolean

    When true, custom field keys in the output use human-readable display names (e.g. 'Story Points') instead of opaque IDs (e.g. 'customfield_10243'). The 'names' expansion is added automatically. Standard fields are unaffected.

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

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

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

Параметры
  • include_status_changesboolean

    Include status change history with timestamps and durations

  • include_status_summaryboolean

    Include aggregated time spent in each status

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

    Jira issue key (e.g., '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

    (Optional) Filter by application type (case-sensitive). Examples: 'stash' (Bitbucket Server), 'bitbucket', 'GitHub', 'githube' (GitHub Enterprise Server), 'GitLab'. If omitted, types are discovered automatically.

  • data_typestring

    (Optional) Filter by data type. Examples: 'pullrequest', 'branch', 'repository'

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

    Jira issue key (e.g., '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 issue key (e.g., 'PROJ-123'). Returns image attachments as inline ImageContent for LLM vision.

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

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

Get Issue Forms

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

    Jira issue key (e.g., 'PROJ-123')

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

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

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

Параметры
  • application_typestring

    (Optional) Filter by application type (case-sensitive). Examples: 'stash' (Bitbucket Server), 'bitbucket', 'GitHub', 'githube' (GitHub Enterprise Server), 'GitLab'. If omitted, types are discovered automatically.

  • data_typestring

    (Optional) Filter by data type. Examples: 'pullrequest', 'branch', 'repository'

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

    Comma-separated list of Jira issue keys (e.g., '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

    Include raw date values in the response

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

  • metricsstring

    Comma-separated list of SLA metrics to calculate. Available: cycle_time, lead_time, time_in_status, due_date_compliance, resolution_time, first_response_time. Defaults to configured metrics or 'cycle_time,time_in_status'.

  • working_hours_onlyboolean

    Calculate using working hours only (excludes weekends/non-business hours). Defaults to value from JIRA_SLA_WORKING_HOURS_ONLY environment variable.

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

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

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

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

    Jira issue key (e.g., 'PROJ-123')

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

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

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

Параметры
  • name_filterstring

    (Optional) Filter link types by name substring (case-insensitive)

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

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

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

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

    ProForma form UUID (e.g., '1946b8b7-8f03-4dc0-ac2d-5fac0d960c6a')

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

    Jira issue key (e.g., 'PROJ-123')

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

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

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

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

    Jira project key (e.g., 'PROJ', 'ACV2')

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

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

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

Параметры
  • max_epicsinteger

    Maximum number of epics to fetch (1-500)

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

    Jira project key (e.g., 'PROJ')

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

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

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

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

    The project key, e.g. 'PROJ'.

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

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

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

Параметры
  • limitinteger

    Maximum number of results (1-50)

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

    Jira project key (e.g., 'PROJ', 'ACV2')

  • start_atinteger

    Starting index for pagination (0-based)

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 project key (e.g., 'PROJ', 'JTEST')

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

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

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

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

    Jira project key (e.g., '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

    Maximum number of results (1-50)

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

    Queue ID (e.g., '47')

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

    Service desk ID (e.g., '4')

  • start_atinteger

    Starting index for pagination (0-based)

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

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

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

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

    Request type ID (e.g., '23')

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

    Service desk ID (e.g., '4')

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

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

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

Параметры
  • limitinteger

    Maximum number of results (1-50)

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

    Service desk ID (e.g., '4')

  • start_atinteger

    Starting index for pagination (0-based)

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 project key (e.g., '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

    Maximum number of results (1-50)

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

    Service desk ID (e.g., '4')

  • start_atinteger

    Starting index for pagination (0-based)

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

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

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

Параметры
  • fieldsstring

    Comma-separated fields to return in the results. Use '*all' for all fields, or specify individual fields like 'summary,status,assignee,priority'

  • limitinteger

    Maximum number of results (1-50)

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

    The id of sprint (e.g., '10001')

  • start_atinteger

    Starting index for pagination (0-based)

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

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

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

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

    The id of board (e.g., '1000')

  • limitinteger

    Maximum number of results (1-50)

  • start_atinteger

    Starting index for pagination (0-based)

  • statestring

    Sprint state (e.g., 'active', 'future', 'closed')

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

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

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

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

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

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

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

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

    Identifier for the user (e.g., email address 'user@example.com', username 'johndoe', account ID 'accountid:...', or key for Server/DC).

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

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

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

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

jira_link_to_epic

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

Ссылка на Epic

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

    The key of the epic to link to (e.g., 'PROJ-456')

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

    The key of the issue to link (e.g., '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 issue key to move (e.g., 'PROJ-123')

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

    Key of the target project (e.g., 'OTHERPROJ'). The issue will keep its current issue type and may receive a new key in the target project.

jira_move_issues_to_backlog

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

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

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

    Comma-separated issue keys (e.g., 'PROJ-1,PROJ-2')

jira_remove_issue_link

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

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

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

    The ID of the link to remove

jira_remove_watcher

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

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

Параметры
  • account_idstring

    Account ID to remove (for Jira Cloud).

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

    Jira issue key (e.g., 'PROJ-123')

  • usernamestring

    Username to remove (for 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

    (Optional) fields to expand. Examples: 'renderedFields', 'transitions', 'changelog'

  • fieldsstring

    (Optional) Comma-separated fields to return in the results. Use '*all' for all fields, or specify individual fields like 'summary,status,assignee,priority'

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

    JQL query string (Jira Query Language). Examples: - Find Epics: "issuetype = Epic AND project = PROJ" - Find issues in Epic: "parent = PROJ-123" - Find by status: "status = 'In Progress' AND project = PROJ" - Find by assignee: "assignee = currentUser()" - Find recently updated: "updated >= -7d AND project = PROJ" - Find by label: "labels = frontend AND project = PROJ" - Find by priority: "priority = High AND project = PROJ"

  • limitinteger

    Maximum number of results (1-50)

  • page_tokenstring

    (Optional) Pagination token from a previous search result. Cloud only — Server/DC uses start_at for pagination.

  • projects_filterstring

    (Optional) Comma-separated list of project keys to filter results by. Overrides the environment variable JIRA_PROJECTS_FILTER if provided.

  • start_atinteger

    Starting index for pagination (0-based)

  • use_display_namesboolean

    When true, custom field keys in the output use human-readable display names (e.g. 'Story Points') instead of opaque IDs (e.g. 'customfield_10243'). The 'names' expansion is added automatically. Standard fields are unaffected.

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

    Issue key to scope the search to (e.g. 'DT-779'). Required if project_key is not given.

  • limitinteger

    Maximum number of users to return (default 20).

  • project_keystring

    Project key to scope the search to (e.g. 'DT'). Required if issue_key is not given.

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

    Free-form text to search Jira users by: display name, username, or email substring (e.g. 'Smith', 'jane.doe', 'doe@example.com'). Server-side match is case-insensitive and partial.

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

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

Поля поиска

Параметры
  • keywordstring

    Keyword for fuzzy search. If left empty, lists the first 'limit' available fields in their default order.

  • limitinteger

    Maximum number of results

  • refreshboolean

    Whether to force refresh the field list

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

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

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

Параметры
  • current_project_idsstring

    Comma-separated list of project IDs to exclude from results

  • max_resultsinteger

    Maximum number of results to return

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

    Name or key prefix to search for

jira_transition_issue

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

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

Параметры
  • commentstring

    (Optional) Comment to add during the transition in Markdown format. This will be visible in the issue history. Rejected for projects listed in JIRA_INTERNAL_ONLY_PROJECTS (a transition comment may be customer-visible on JSM and cannot be forced internal): transition without a comment, then post an internal note with jira_add_comment(public=false).

  • fieldsstring

    (Optional) JSON string of fields to update during the transition. Some transitions require specific fields to be set (e.g., resolution). Example: '{"resolution": {"name": "Fixed"}}'

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

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

    ID of the transition to perform. Use the jira_get_transitions tool first to get the available transition IDs for the issue. Example values: '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

    (Optional) JSON string of additional fields to update. Use this for custom fields or more complex updates. Link to epic: {"epicKey": "EPIC-123"} or {"epic_link": "EPIC-123"}.

  • attachmentsstring

    (Optional) JSON string array or comma-separated list of file paths to attach to the issue. Example: '/path/to/file1.txt,/path/to/file2.txt' or ['/path/to/file1.txt','/path/to/file2.txt']

  • componentsstring

    (Optional) Comma-separated list of component names (e.g., 'Frontend,API')

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

    JSON string of fields to update. For 'assignee', provide a string identifier (email, name, or accountId). For 'description', provide text in Markdown format; on Jira Cloud, use '{expand:Title}...{expand}' for a collapsible section. Example: '{"assignee": "user@example.com", "summary": "New Summary", "description": "## Updated\nMarkdown text"}'

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

    Jira issue key (e.g., 'PROJ-123', 'ACV2-642')

  • return_fieldsstring

    (Optional) Controls which fields of the updated issue are returned, to reduce response size and token usage. Defaults to '*all' (the complete issue, which can be very large). TOKEN-SAVING TIP: after an update you usually do NOT need the whole issue back. Pass a comma-separated list of just the field(s) you care about (e.g., 'summary,duedate'), or a single light field such as 'status' for a minimal confirmation - this can cut the response by thousands of tokens. The issue 'key' is always returned regardless. If you later need other fields, fetch them on demand with jira_get_issue (which also supports field filtering). Use '*all' only when you genuinely need the full updated issue.

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[]обязательный

    List of answer objects. Each answer must have: questionId (string), type (TEXT/NUMBER/SELECT/etc), value (any)

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

    ProForma form UUID (e.g., '1946b8b7-8f03-4dc0-ac2d-5fac0d960c6a')

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

    Jira issue key (e.g., '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

    (Optional) New end date for the sprint

  • goalstring

    (Optional) New goal for the sprint

  • namestring

    (Optional) New name for the sprint

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

    The id of sprint (e.g., '10001')

  • start_datestring

    (Optional) New start date for the sprint

  • statestring

    (Optional) New state for the sprint (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

    Set archived flag (true to archive)

  • descriptionstring

    New description for the version

  • namestring

    New name for the version

  • releasedboolean

    Set released flag (true to mark released)

  • release_datestring

    New release date (YYYY-MM-DD)

  • start_datestring

    New start date (YYYY-MM-DD)

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

    Numeric ID of the version to update (e.g. '10001')

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

raalarcon9705/jira-mcp

raalarcon9705/jira-mcp

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

TypeScript⭐ 5
n24q02m/better-notion-mcp

n24q02m/better-notion-mcp

Markdown-first MCP сервер для AI-агентов: управляет страницами, базами данных, блоками и комментариями Notion одним вызовом. Сокращает токены на 77%, поддерживает локальный и HTTP транспорт. Идеален для автоматизации Notion через ИИ.

TypeScript⭐ 36
Notion MCP

Notion MCP

официальный

Notion MCP сервер даёт AI-агентам прямой доступ к Notion через API: читайте и редактируйте страницы в Markdown, делайте запросы к данным. Разработчики используют этот MCP инструмент для интеграции помощников с заметками и проектами, экономя токены.

TypeScript⭐ 4625
UnMarkdown/mcp-server

UnMarkdown/mcp-server

MCP сервер Unmarkdown преобразует Markdown в документы для Google Docs, Word, Slack и других платформ с 62 шаблонами. Управляет документами и публикует страницы. Идеален для AI-ассистентов, которым нужно быстро оформлять и публиковать контент.

JavaScript⭐ 1
ivo-toby/contentful-mcp

ivo-toby/contentful-mcp

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

TypeScript⭐ 62
orellazi/coda-mcp

orellazi/coda-mcp

MCP сервер для работы с API Coda: управляйте страницами (создание, чтение, обновление, дублирование, переименование) и таблицами (строки, столбцы, вставка, обновление, удаление, кнопки). Инструмент полезен для интеграции AI-ассистентов с документами Coda и автоматизации рутинных операций.

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

Лука Никитин