Assurance — MCP-сервер для Claude Code: что делает и как установить
Проверяет, что агент на самом деле прочитал и протестировал, а что пропустил. Пригодится, когда сессия заканчивается бодрым «всё готово».
claude mcp add assurance-mcp -- uvx assurance-mcpЧто делает Assurance
Assurance читает транскрипт сессии Claude и разбирает его по фактам: какие команды запускались, какие падали, что менялось после последнего прогона тестов. Отчёт пишется обычными фразами, без оценок вроде «работа выполнена корректно». Если команда не распознана, сервер так и говорит и называет её — молчание не считается успехом.
Есть Stop-хук: после каждого хода Claude он прогоняет аудит и говорит только тогда, когда есть что сказать. Уровней три — «note», «suggested review» и «stop and check». Последний срабатывает, когда непроверенный код ушёл в push, merge, деплой, миграцию или коммит в main. Хук не блокирует сессию и не роняет её.
Запуск идёт через uvx, то есть нужен установленный uv или pip install assurance. Хук правит ~/.claude/settings.json — установщик сначала показывает изменение и спрашивает подтверждение. Тестовые команды сервер узнаёт из package.json, Makefile и justfile, а прогон с нулём тестов не засчитывает за прохождение.
Какие задачи решает
- увидеть, что тесты падали три раза подряд, хотя агент отчитался об успехе
- поймать правку, после которой нужный тест так и не запускался
- разобрать сессию, где часть команд осталась нераспознанной
- проверить, что непротестированный код не ушёл в push или деплой
- получить отчёт по сессии без ручного чтения транскрипта
Примеры запросов агенту
- Запусти аудит последней сессии Claude и покажи, что осталось непроверенным
- Проверь по транскрипту, запускался ли
pytest -q tests/test_invoice.pyпосле последней правки - Установи Stop-хук assurance, чтобы аудит шёл после каждого хода
Как установить Assurance
Командой платформы
claude mcp add assurance-mcp -- uvx assurance-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from assurance-mcp <команда>
Командой платформы
codex mcp add assurance -- uvx assurance-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from assurance-mcp <команда>
Файл настроек
{
"mcpServers": {
"assurance": {
"command": "uvx",
"args": [
"assurance-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from assurance-mcp <команда>
Файл настроек
{
"servers": {
"assurance": {
"type": "stdio",
"command": "uvx",
"args": [
"assurance-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from assurance-mcp <команда>
Командой платформы
gemini mcp add assurance uvx assurance-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from assurance-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Assurance
Как установить Assurance в Claude Code?
Добавьте MCP-сервер командой claude mcp add assurance-mcp -- uvx assurance-mcp. Для хука есть отдельный шаг: uvx assurance@latest hook install.
Что делает Assurance?
Разбирает запись сессии и говорит, что агент сделал, что пропустил и что проверить не удалось. Отдельно показывает команды, которые не смог опознать.
Что нужно для работы Assurance?
Команда запускается через uvx, поэтому нужен uv либо установка пакета через pip install assurance. Хук при установке меняет ~/.claude/settings.json и спрашивает подтверждение.
