entherium_report_defect

Статус: GA Доступ: по токену контракт API: 0.3.0 · capability 2026-09-03.1 Открыть как Markdown Открыть в Claude Открыть в ChatGPT

File a DEFECT you found in the platform. Give MAXIMUM detail so it can be detected AND reproduced, as in full QA management: ordered steps_to_reproduce, what you expected vs the actual behaviour, evidence (links / quotes / screenshot URLs / logs — plain strings or {“type”,“url”|“value”} objects both work), the component, and environment (instance/url/run_guid/commit). Set spec_ref to the feature’s SPEC id (“SPEC-NNN”) when the defect is about a known spec, so it targets the right feature context (an unknown spec id is REJECTED). A report WITHOUT repro steps or an evidence locator is QUARANTINED, not tracked. Duplicates of an existing defect are merged server-side. Returns {“accepted”: true} when the report is taken, or {“accepted”: false} if it could not be accepted — nothing else about the ticket comes back.

Доступ: запись — клиент спрашивает подтверждение перед каждым вызовом

Доступен на: /mcp/

Подсказки, объявленные MCP-клиентам (ToolAnnotations)

Подсказка	Значение
`readOnlyHint`	false
`destructiveHint`	false
`idempotentHint`	false
`openWorldHint`	false
`anthropic/requiresUserInteraction`	true

Параметры

Имя	Тип	Обязателен	Описание
`title`	`string`	да	One-line summary of the defect, as a QA ticket title
`steps_to_reproduce`	`array \| null`	нет	Ordered steps that make the defect appear; required for the report to be tracked
`expected`	`string \| null`	нет	What should have happened
`actual`	`string \| null`	нет	What actually happened
`evidence`	`array \| array \| string \| null`	нет	Links, quotes, screenshot URLs or log lines — plain strings or {{type, url\|value}} objects
`component`	`string \| null`	нет	Platform area the defect belongs to (e.g. publish, generate, portal)
`severity`	`string \| null`	нет	sev1 (outage) … sev4 (cosmetic)
`environment`	`object \| null`	нет	Where it happened: instance, url, run_guid, commit
`behavior_cases`	`array \| null`	нет	Other inputs or cases you tried and what they did
`spec_ref`	`string \| null`	нет	Feature id of the form SPEC-NNN the defect belongs to; unknown ids are rejected

Пример вызова

Отправляется внутри инициализированной MCP-сессии (см. Подключение). Каждый параметр показан типизированной заглушкой; необязательные можно опустить — но для инструментов дефектов/задач именно QA-поля спасают отчёт от карантина.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "entherium_report_defect",
    "arguments": {
      "title": "<title>",
      "steps_to_reproduce": [],
      "expected": "<expected>",
      "actual": "<actual>",
      "evidence": [],
      "component": "<component>",
      "severity": "<severity>",
      "environment": {},
      "behavior_cases": [],
      "spec_ref": "<spec_ref>"
    }
  }
}

Возвращает

Поле	Тип	Описание
`accepted`	`boolean` (необязательно)	True iff the write was applied / the report was taken in
`error`	`string` (необязательно)	Why it was not accepted (truthful, never a silent drop)
`task_id`	`integer` (необязательно)	Id of the created task (create_task only)

Если не работает

Симптом	Причина	Действие
`401`	Токен отсутствует или истёк	Токены выпускает владелец платформы через `POST /api/v1/auth/agent-token` (только суперпользователь) — попросите перевыпуск. ⚠️ Новый токен заменяет набор грантов
`403` / ошибка capability	У токена нет capability или гранта на контракт	Сначала `my_capabilities`; грант запрашивается у владельца