aashari/mcp-server-atlassian-jira

Удаляет ресурсы Jira. По умолчанию возвращает формат TOON. Формат вывода: TOON (по умолчанию) или JSON (outputFormat: "json") Типовые операции: 1. Удаление задачи: /rest/api/3/issue/{issueIdOrKey} Параметр запроса: deleteSubtasks=true — удалить подзадачи 2. Удаление комментария: /rest/api/3/issue/{issueIdOrKey}/comment/{commentId} 3. Удаление записи времени: /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId} 4. Удаление вложения: /rest/api/3/attachment/{attachmentId} 5. Удаление наблюдателя: /rest/api/3/issue/{issueIdOrKey}/watchers Параметр запроса: accountId={accountId} Примечание: большинство DELETE-эндпоинтов при успехе возвращают 204 No Content. Ссылка на API: https://developer.atlassian.com/cloud/jira/platform/rest/v3/

Читает любые данные Jira. По умолчанию возвращает формат TOON (на 30-60% меньше токенов, чем JSON). ВАЖНО - Оптимизация стоимости: - ВСЕГДА используйте параметр jq для фильтрации полей ответа. Нефильтрованные ответы очень дороги! - Используйте параметр запроса maxResults, чтобы ограничить количество результатов (например, maxResults: "5") - Если не уверены в доступных полях, сначала получите ОДИН элемент с maxResults: "1" и БЕЗ фильтра jq, чтобы изучить схему, затем используйте jq в последующих вызовах Шаблон обнаружения схемы: 1. Первый вызов: path: "/rest/api/3/search/jql", queryParams: {"maxResults": "1", "jql": "project=PROJ"} (без jq) — изучите доступные поля 2. Затем используйте: jq: "issues[*].{key: key, summary: fields.summary, status: fields.status.name}" — извлеките только то, что нужно Формат вывода: TOON (по умолчанию, экономит токены) или JSON (outputFormat: "json") Типовые пути: - /rest/api/3/project - список всех проектов - /rest/api/3/project/{projectKeyOrId} - получить детали проекта - /rest/api/3/search/jql - поиск задач по JQL (используйте параметр запроса jql). ПРИМЕЧАНИЕ: /rest/api/3/search устарел! - /rest/api/3/issue/{issueIdOrKey} - получить детали задачи - /rest/api/3/issue/{issueIdOrKey}/comment - список комментариев задачи - /rest/api/3/issue/{issueIdOrKey}/worklog - список записей работы по задаче - /rest/api/3/issue/{issueIdOrKey}/transitions - получить доступные переходы - /rest/api/3/user/search - поиск пользователей (используйте параметр query) - /rest/api/3/status - список всех статусов - /rest/api/3/issuetype - список типов задач - /rest/api/3/priority - список приоритетов Примеры JQ: issues[*].key, issues[0], issues[*].{key: key, summary: fields.summary} Примеры JQL-запросов: project=PROJ, assignee=currentUser(), status="In Progress", created >= -7d Справка по API: https://developer.atlassian.com/cloud/jira/platform/rest/v3/

Частично обновляет ресурсы Jira. По умолчанию возвращает формат TOON. ВАЖНО - Оптимизация затрат: Используйте параметр jq, чтобы фильтровать поля ответа. Формат вывода: TOON (по умолчанию) или JSON (outputFormat: "json") Типовые операции: 1. Обновление полей задачи: /rest/api/3/issue/{issueIdOrKey} тело: {"fields": {"summary": "Updated title"}} (обновляет только указанные поля) 2. Обновление комментария: /rest/api/3/issue/{issueIdOrKey}/comment/{commentId} тело: {"body": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Updated comment"}]}]}} 3. Обновление трудозатрат: /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId} тело: {"timeSpentSeconds": 7200} Примечание: метод PATCH обновляет только указанные поля, остальные остаются без изменений. Справочник API: https://developer.atlassian.com/cloud/jira/platform/rest/v3/

Создаёт ресурсы Jira. По умолчанию возвращает формат TOON (экономит токены). ВАЖНО — Оптимизация затрат: - Используй параметр jq, чтобы извлечь только нужные поля из ответа (например, jq: "{key: key, id: id}") - Нефильтрованные ответы содержат все метаданные и обходятся дорого! Формат вывода: TOON (по умолчанию) или JSON (outputFormat: "json") Частые операции: 1. Создать задачу: /rest/api/3/issue body: {"fields": {"project": {"key": "PROJ"}, "summary": "Issue title", "issuetype": {"name": "Task"}, "description": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Description"}]}]}}} 2. Добавить комментарий: /rest/api/3/issue/{issueIdOrKey}/comment body: {"body": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Comment text"}]}]}} 3. Добавить запись работы: /rest/api/3/issue/{issueIdOrKey}/worklog body: {"timeSpentSeconds": 3600, "comment": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Work done"}]}]}} 4. Перевести задачу по статусу: /rest/api/3/issue/{issueIdOrKey}/transitions body: {"transition": {"id": "31"}} 5. Добавить вложение: /rest/api/3/issue/{issueIdOrKey}/attachments Примечание: требует multipart/form-data (сложно — используй UI Jira для вложений) Справка по API: https://developer.atlassian.com/cloud/jira/platform/rest/v3/

Заменяет ресурсы Jira (полное обновление). По умолчанию возвращает формат TOON. ВАЖНО — Оптимизация затрат: Используйте параметр jq, чтобы извлекать из ответа только нужные поля. Формат вывода: TOON (по умолчанию) или JSON (outputFormat: "json"). Частые операции: 1. Обновление задачи (полное): /rest/api/3/issue/{issueIdOrKey} тело: {"fields": {"summary": "Новый заголовок", "description": {...}, "assignee": {"accountId": "..."}}} 2. Обновление проекта: /rest/api/3/project/{projectIdOrKey} тело: {"name": "Новое имя проекта", "description": "Обновлённое описание"} 3. Установка свойства задачи: /rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey} тело: {"value": "значение свойства"} Примечание: PUT заменяет весь ресурс. Для частичного обновления лучше используйте PATCH. Справочник API: https://developer.atlassian.com/cloud/jira/platform/rest/v3/