MCP batch_create: параметры команд в описании и в ошибке 422 #44

New Issue

aep · 2026-10-15T19:22:47+03:00

aep commented

2026-10-15 19:22:47 +03:00

Проблема

Описание MCP-инструмента batch_create (src/jira_hub/mcp_server.py:166) говорит только «params по контракту specs/commands». Клиент MCP этот файл не видит и угадывает имена параметров.

Случай 15.10.2026: перевод AURORA-1527 в «Ожидание разработки» — ensure_status {key, status} → 422 bad_batch: команда 1 (ensure_status): нет target. Со второй попытки прошло с target, но правильное имя пришлось угадывать: ошибка называет только недостающее поле и не говорит, какие поля ожидаются.

Что сделать (bounded)

Описание batch_create: перечислить параметры каждого типа команды (обязательные и необязательные), например ensure_status {key, target}, ensure_sprint {key, sprint — имя или backlog}, ensure_fields {key, duedate YYYY-MM-DD, …}. Источник — SPEC в commands.py (required / optional), чтобы описание не расходилось с валидацией: собрать текст из SPEC, а не дублировать руками.
Сообщения 422 в commands.validate (нет …, лишние параметры …): добавлять ожидаемый набор, например команда 1 (ensure_status): нет target; ожидаются key, target. Тогда клиент с устаревшим описанием исправит пакет с одной попытки.

Готово, когда

описание batch_create в MCP содержит параметры всех типов команд, тест сверяет его с SPEC;
ошибки «нет …» и «лишние параметры …» называют ожидаемые параметры, тесты на оба случая;
make check зелёный.

## Проблема Описание MCP-инструмента `batch_create` (`src/jira_hub/mcp_server.py:166`) говорит только «params по контракту specs/commands». Клиент MCP этот файл не видит и угадывает имена параметров. Случай 15.10.2026: перевод AURORA-1527 в «Ожидание разработки» — `ensure_status {key, status}` → `422 bad_batch: команда 1 (ensure_status): нет target`. Со второй попытки прошло с `target`, но правильное имя пришлось угадывать: ошибка называет только недостающее поле и не говорит, какие поля ожидаются. ## Что сделать (bounded) 1. **Описание `batch_create`**: перечислить параметры каждого типа команды (обязательные и необязательные), например `ensure_status {key, target}`, `ensure_sprint {key, sprint — имя или backlog}`, `ensure_fields {key, duedate YYYY-MM-DD, …}`. Источник — `SPEC` в `commands.py` (`required` / `optional`), чтобы описание не расходилось с валидацией: собрать текст из `SPEC`, а не дублировать руками. 2. **Сообщения 422 в `commands.validate`** (`нет …`, `лишние параметры …`): добавлять ожидаемый набор, например `команда 1 (ensure_status): нет target; ожидаются key, target`. Тогда клиент с устаревшим описанием исправит пакет с одной попытки. ## Готово, когда - описание `batch_create` в MCP содержит параметры всех типов команд, тест сверяет его с `SPEC`; - ошибки «нет …» и «лишние параметры …» называют ожидаемые параметры, тесты на оба случая; - `make check` зелёный.

aep referenced this issue from a commit

2026-10-15 22:13:35 +03:00

feat(mcp): параметры команд в описании batch_create и в ошибках 422 (#44)

aep referenced a pull request that will close this issue

2026-10-15 22:13:35 +03:00

MCP batch_create: параметры команд в описании и в ошибке 422 (#44) #45

aep closed this issue

2026-10-15 22:16:52 +03:00

aep referenced this issue from a commit

2026-10-15 22:16:52 +03:00

Merge pull request 'MCP batch_create: параметры команд в описании и в ошибке 422 (#44)' (#45) from feat/44-mcp-param-hints into main

aep commented