Добавить сервер
  1. Каталог MCP
  2. sooperset
  3. sooperset/mcp-atlassian
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 недоступен.

Add Comment

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

Параметры

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

    The ID of the page to add a comment to

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

    The comment content in Markdown format

confluence_add_inline_comment

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

Add Inline Comment

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

Параметры

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

    The ID of the page to add the inline comment to

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

    The comment content in Markdown format

  • 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 недоступен.

Add Label

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

Параметры

  • 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.

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

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

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

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

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'

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

    Account ID of the user (for subject_type='user') or group ID (for subject_type='group'). Example user account ID: '5b10a2844c20165700ede21g'

  • 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'.

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 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 не настроен или недоступен.

Параметры

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

    The ID of the page to copy

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

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

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

    Title for the new copied page

  • destination_parent_idstring

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

  • copy_attachmentsboolean

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

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.

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.

Параметры

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

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

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

    The title of the page

  • 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.

  • parent_idstring

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

  • 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

  • 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

  • emojistring

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

  • 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'.

  • page_widthstring

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

  • 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'.

  • subtypestring

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

confluence_create_page_from_template

Create a new Cloud page pre-populated with a template's body. This operation is only available for Confluence Cloud. Fetches the named template and creates a page with its storage-format content. The page can be edited afterwards via confluence_update_page.

Create Page from Template

Create a new Cloud page pre-populated with a template's body. This operation is only available for Confluence Cloud. Fetches the named template and creates a page with its storage-format content. The page can be edited afterwards via confluence_update_page.

Параметры

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

    Key of the space in which to create the page.

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

    Title for the new page.

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

    ID of the template to use as the page body.

  • parent_idstring

    Optional ID of the parent page.

confluence_delete_attachment

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

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 не настроен или недоступен.

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 с сообщением об ошибке или превышении размера.

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 на каждое успешно загруженное вложение.

Download All 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-строку со списком вложений и метаданными.

Get Content 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'

  • 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

  • limitinteger

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

  • filenamestring

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

  • 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)

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

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

Get Comments

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

Параметры

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

    Confluence page ID (numeric ID, can be parsed from URL, e.g. from 'https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title' -> '123456789')

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

Получает все инлайн-комментарии для страницы Confluence. Args: ctx: Контекст FastMCP. page_id: ID страницы, для которой нужно получить инлайн-комментарии. Returns: JSON-строка со списком инлайн-комментариев. Raises: ValueError: Если клиент 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, представляющую список объектов меток.

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 с содержимым страницы и/или метаданными, или ошибку, если страница не найдена или параметры некорректны.

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 с содержимым страницы и/или метаданными, или ошибку, если страница не найдена или параметры некорректны.

Параметры

  • 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.

  • titlestring

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

  • space_keystring

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

  • include_metadataboolean

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

  • 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.

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-строка, представляющая список объектов дочерних страниц и папок.

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-строка, представляющая список объектов дочерних страниц и папок.

Параметры

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

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

  • expandstring

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

  • limitinteger

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

  • include_contentboolean

    Whether to include the page content in the response

  • 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.

  • startinteger

    Starting index for pagination (0-based)

  • include_foldersboolean

    Whether to include child folders in addition to child pages

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

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

Get Page Version Diff

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

Параметры

  • 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'.

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

    Source version number

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

    Target version number

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

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

Get Page History

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

Параметры

  • 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

  • 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.

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 на каждое успешно загруженное изображение.

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 не настроен или недоступен.

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только чтение

Get a Cloud page template by ID, including its storage-format body.

Get Page Template

Get a Cloud page template by ID, including its storage-format body.

Параметры

  • 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 со статистикой просмотров страницы, включая общее количество просмотров и дату последнего просмотра.

Get Page Views

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

Параметры

  • 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'.

  • include_titleboolean

    Whether to fetch and include the page title

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.

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

    Space key

  • limitinteger

    Max pages to fetch

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

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

Get Space Permissions

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

Параметры

  • 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.

  • limitinteger

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

  • cursorstring

    Optional pagination cursor from a previous response.

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

List Confluence page content templates. This operation is only available for Confluence Cloud. Returns template metadata (ID, name, description, type) without the full body. Use confluence_get_page_template to fetch a template's body.

List Page Templates

List Confluence page content templates. This operation is only available for Confluence Cloud. Returns template metadata (ID, name, description, type) without the full body. Use confluence_get_page_template to fetch a template's body.

Параметры

  • space_keystring

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

  • limitinteger

    Maximum number of templates to return.

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 не настроен.

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

  • 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

  • positionstring

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

confluence_reply_to_comment

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

Reply to Comment

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

Параметры

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

    The ID of the parent comment to reply to

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

    The reply content in Markdown format

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

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

Search Content

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

Параметры

  • 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.

  • limitinteger

    Maximum number of results (1-50)

  • 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.

Search User

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

Параметры

  • 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.

  • limitinteger

    Maximum number of results (1-50)

  • group_namestring

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

confluence_set_page_restrictions

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

Set Page Restrictions

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

Параметры

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

    The ID of the page to restrict

  • read_usersstring[]

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

  • read_groupsstring[]

    (Optional) Group names allowed to view the page.

  • edit_usersstring[]

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

  • edit_groupsstring[]

    (Optional) Group names allowed to edit the page.

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.

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.

Параметры

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

    The ID of the page to update

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

    The new title of the page

  • 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.

  • is_minor_editboolean

    Whether this is a minor edit

  • version_commentstring

    Optional comment for this version

  • parent_idstring

    Optional the new parent page ID

  • 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

  • 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

  • emojistring

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

  • 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'.

  • page_widthstring

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

  • 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'.

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 недействителен.

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 недействителен.

Параметры

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

    The ID of the page to update

  • 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.

  • 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.

  • 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.

  • is_minor_editboolean

    Whether this is a minor edit

  • 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 с подтверждением загрузки и метаданными вложения.

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 с подтверждением загрузки и метаданными вложения.

Параметры

  • 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'

  • 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.

  • 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.

  • 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.

  • commentstring

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

  • 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 с результатами загрузки каждого файла.

Upload Multiple Attachments

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

Параметры

  • 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.

  • commentstring

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

  • 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 недоступен.

Add Comment

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

Параметры

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

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

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

    Comment text in Markdown format

  • visibilitystring

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

  • 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.

jira_add_issues_to_sprint

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

Add Issues to Sprint

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

Параметры

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

    Sprint ID to add issues to

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

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

jira_add_watcher

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

Add Issue 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 недоступен.

Add Worklog

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

Параметры

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

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

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

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

  • commentstring

    (Optional) Comment for the worklog in Markdown format

  • startedstring

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

  • original_estimatestring

    (Optional) New value for the original estimate

  • remaining_estimatestring

    (Optional) New value for the remaining estimate

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 недоступен или пользователь не найден.

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 недоступен или пользователь не найден.

Параметры

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

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

  • 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.

jira_batch_create_issues

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

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. Аргументы: ctx: Контекст FastMCP. project_key: Ключ проекта. versions: Строка с JSON-массивом объектов версий. Возвращает: JSON-массив результатов — каждый содержит флаг успеха, версию или ошибку.

Batch Create Versions

Создайте сразу несколько версий в проекте Jira. Аргументы: ctx: Контекст FastMCP. project_key: Ключ проекта. versions: Строка с JSON-массивом объектов версий. Возвращает: JSON-массив результатов — каждый содержит флаг успеха, версию или ошибку.

Параметры

  • 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 клиент недоступен.

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 клиент недоступен.

Параметры

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

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

  • fieldsstring

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

  • 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

Create a Jira Service Management customer request.

Create Customer Request

Create a Jira Service Management customer request.

Параметры

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

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

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

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

  • 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"]}

  • 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_participantsstring

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

  • 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="}]

  • 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

Создаёт новую задачу в 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 недоступен.

Параметры

  • 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

  • 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.

  • assigneestring

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

  • descriptionstring

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

  • componentsstring

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

  • 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"}

jira_create_issue_link

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

Create Issue Link

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

Параметры

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

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

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

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

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

    The key of the outward issue (e.g., 'PROJ-456')

  • 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"}')

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 недоступен.

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 недоступен.

Параметры

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

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

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

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

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

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

  • summarystring

    (Optional) Description of the link

  • relationshipstring

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

  • icon_urlstring

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

jira_create_sprint

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

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

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

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

    Start time for sprint (ISO 8601 format)

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

    End time for sprint (ISO 8601 format)

  • goalstring

    (Optional) Goal of the sprint

jira_create_version

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

Create Version

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

Параметры

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

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

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

    Name of the version

  • start_datestring

    Start date (YYYY-MM-DD)

  • release_datestring

    Release date (YYYY-MM-DD)

  • descriptionstring

    Description of the version

jira_delete_issue

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

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 недоступен.

Edit Comment

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

Параметры

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

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

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

    The ID of the comment to edit

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

    Updated comment text in Markdown format

  • 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: список объектов досок.

Get Agile Boards

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

Параметры

  • board_namestring

    (Optional) The name of board, support fuzzy search

  • project_keystring

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

  • board_typestring

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

  • start_atinteger

    Starting index for pagination (0-based)

  • limitinteger

    Maximum number of results (1-50)

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

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

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')

  • 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"

  • fieldsstring

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

  • start_atinteger

    Starting index for pagination (0-based)

  • limitinteger

    Maximum number of results (1-50)

  • expandstring

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

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

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

Параметры

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

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

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

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

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

Find all cross-project issue links for a project. Scans issues in the project, extracts every issue link whose target belongs to a different project, and groups them by target project and link type. Useful for dependency analysis across multi-project Jira setups.

Get Cross-Project Dependencies

Find all cross-project issue links for a project. Scans issues in the project, extracts every issue link whose target belongs to a different project, and groups them by target project and link type. Useful for dependency analysis across multi-project Jira setups.

Параметры

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

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

  • max_issuesinteger

    Maximum issues to scan for links (1-500)

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

Получает допустимые значения опций для пользовательского поля. Возвращает список допустимых параметров для настраиваемых полей типа выбор, множественный выбор, радиокнопка, флажок и каскадный выбор. 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 со списком доступных опций.

Параметры

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

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

  • context_idstring

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

  • project_keystring

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

  • issue_typestring

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

  • containsstring

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

  • 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 не настроен.

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 не настроен.

Параметры

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

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

  • 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.

  • expandstring

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

  • comment_limitinteger

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

  • propertiesstring

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

  • update_historyboolean

    Whether to update the issue view history for the requesting user

  • includestring

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

  • 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-строку с датами задачи и опциональными данными отслеживания статусов.

Get Issue Dates

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

Параметры

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

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

  • include_status_changesboolean

    Include status change history with timestamps and durations

  • include_status_summaryboolean

    Include aggregated time spent in each status

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: Список задействованных репозиториев

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: Список задействованных репозиториев

Параметры

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

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

  • 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'

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

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

Параметры

  • 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

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

Параметры

  • 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 со списком информации о разработке для каждой задачи.

Get Issues Development Info

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

Параметры

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

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

  • 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'

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.

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.

Параметры

  • 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.

  • include_raw_datesboolean

    Include raw date values in the response

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

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

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, или объект ошибки в случае неудачи.

Get Form Details

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

Параметры

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

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

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

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

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

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

Get Project Components

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

Параметры

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

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

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

Group a project's epics under their cross-project parent issues. Fetches all epics in the project, detects their parent issue via the parent field or inward issue links, then groups them by parent. Epics with no detected parent appear under "Unlinked". Useful for understanding how a project's epics roll up to initiatives in another project.

Get Project Epic Hierarchy

Group a project's epics under their cross-project parent issues. Fetches all epics in the project, detects their parent issue via the parent field or inward issue links, then groups them by parent. Epics with no detected parent appear under "Unlinked". Useful for understanding how a project's epics roll up to initiatives in another project.

Параметры

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

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

  • max_epicsinteger

    Maximum number of epics to fetch (1-500)

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

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

Get Project Issues

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

Параметры

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

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

  • limitinteger

    Maximum number of results (1-50)

  • 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).

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.

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).

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).

Параметры

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

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

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

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

  • start_atinteger

    Starting index for pagination (0-based)

  • limitinteger

    Maximum number of results (1-50)

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

Get field definitions for a Jira Service Management request type.

Get Request Type Fields

Get field definitions for a Jira Service Management request type.

Параметры

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

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

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

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

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

Get request types for a Jira Service Management service desk.

Get Request Types

Get request types for a Jira Service Management service desk.

Параметры

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

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

  • start_atinteger

    Starting index for pagination (0-based)

  • limitinteger

    Maximum number of results (1-50)

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).

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).

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

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

  • start_atinteger

    Starting index for pagination (0-based)

  • limitinteger

    Maximum number of results (1-50)

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

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

Get Sprint Issues

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

Параметры

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

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

  • fieldsstring

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

  • start_atinteger

    Starting index for pagination (0-based)

  • limitinteger

    Maximum number of results (1-50)

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

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

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')

  • statestring

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

  • start_atinteger

    Starting index for pagination (0-based)

  • limitinteger

    Maximum number of results (1-50)

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

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

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 не настроен или недоступен.

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, представляющая записи времени.

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 недоступен.

Link to Epic

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

Параметры

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

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

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

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

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.

Move Issue to Project

Перемещает задачу 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 недоступен.

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 недоступен.

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 не настроен или недоступен.

Remove Issue Watcher

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

Параметры

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

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

  • usernamestring

    Username to remove (for Jira Server/DC).

  • account_idstring

    Account ID to remove (for Jira Cloud).

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

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

Search Issues

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

Параметры

  • 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"

  • fieldsstring

    (Optional) 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)

  • start_atinteger

    Starting index for pagination (0-based)

  • projects_filterstring

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

  • expandstring

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

  • page_tokenstring

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

  • 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": [...]} в случае успеха, или объект ошибки при неудаче.

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": [...]} в случае успеха, или объект ошибки при неудаче.

Параметры

  • 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.

  • project_keystring

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

  • 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).

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

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

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, возвращаются только проекты, соответствующие этим ключам.

Search Projects

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

Параметры

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

    Name or key prefix to search for

  • max_resultsinteger

    Maximum number of results to return

  • current_project_idsstring

    Comma-separated list of project IDs to exclude from results

jira_transition_issue

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

Transition Issue

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

Параметры

  • 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'

  • 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"}}'

  • 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).

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 недоступен, или неверный ввод.

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

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

  • 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"}'

  • 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"}.

  • componentsstring

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

  • 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']

  • 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 формы (получить из…

Update 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 формы (получить из…

Параметры

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

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

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

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

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

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

jira_update_sprint

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

Update Sprint

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

Параметры

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

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

  • namestring

    (Optional) New name for the sprint

  • statestring

    (Optional) New state for the sprint (future|active|closed)

  • start_datestring

    (Optional) New start date for the sprint

  • end_datestring

    (Optional) New end date for the sprint

  • goalstring

    (Optional) New goal for the sprint

jira_update_version

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

Update Version

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

Параметры

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

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

  • namestring

    New name for the version

  • descriptionstring

    New description for the version

  • start_datestring

    New start date (YYYY-MM-DD)

  • release_datestring

    New release date (YYYY-MM-DD)

  • archivedboolean

    Set archived flag (true to archive)

  • releasedboolean

    Set released flag (true to mark released)

Другие проверенные MCP-сервера

PSPDFKit/nutrient-dws-mcp-server

PSPDFKit/nutrient-dws-mcp-server

официальный

MCP-сервер для подключения AI-ассистентов к Nutrient DWS API: создавайте, редактируйте, конвертируйте и подписывайте документы через естественный язык. Полезен разработчикам, внедряющим документооб...

TypeScript⭐ 68
atilaahmettaner/tradingview-mcp

atilaahmettaner/tradingview-mcp

MCP сервер для рыночных данных и технического анализа — акции, крипта, форекс и фьючерсы. Включает скринеры, бэктестинг и 30+ инструментов. Работает с Claude, ChatGPT, Cursor — всё в одном сервере.

Python⭐ 3576
hashicorp/terraform-mcp-server

hashicorp/terraform-mcp-server

официальный

MCP-сервер для интеграции с Terraform Registry и HCP Terraform, автоматизирующий управление workspace, переменными и запусками в Infrastructure as Code (IaC) через ИИ-ассистенты.

Go⭐ 1474
duaraghav8/MCPJungle

duaraghav8/MCPJungle

MCPJungle — это MCP-шлюз, объединяющий множество серверов за одним endpoint. Регистрируйте инструменты один раз, подключайте Claude, Cursor или своих AI-агентов к единой точке входа. Упрощает управление, контроль доступа и observability для команд и локальных разработчиков.

Go⭐ 1161
GLips/Figma-Context-MCP

GLips/Figma-Context-MCP

Framelink MCP для Figma даёт AI-ассистентам вроде Cursor доступ к макетам из Figma. Сервер упрощает данные дизайна, передавая только релевантную информацию о расположении и стилях — так модель точн...

TypeScript⭐ 15431
jau123/MeiGen-AI-Design-MCP

jau123/MeiGen-AI-Design-MCP

MCP-сервер для генерации изображений и видео через ИИ. Работает в Claude Code, Cursor и других AI-инструментах, поддерживает 9 моделей и 1446 промптов. Параллельная генерация, управление стилями и ...

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

Лука Никитин