withHuman — MCP-сервер для Claude Code: согласование вызовов агента
Ставит вызовы инструментов ИИ-агента на паузу, пока человек не одобрит действие. Пригодится, когда агент умеет возвращать деньги, деплоить или мержить код.
claude mcp add --transport http withhuman https://app.withhuman.ai/api/mcp/v1Что делает withHuman
withHuman работает как слой согласования перед запуском инструмента. Правила задаются в одном месте: рутинный вызов проходит сам, запрещённый отклоняется, спорный ждёт решения человека. Подключённые агенты подчиняются этим же правилам.
Каждый вызов уходит в withHuman через адаптер — рантайм-хук или обёртку SDK — по протоколу Agent Approval Protocol. Дальше срабатывает конвейер: он смотрит на имя инструмента и аргументы, например пропускает возвраты до определённой суммы и эскалирует более крупные. Кому и когда задавать вопрос, решают пути эскалации по команде, уровню и рабочим часам. Ревьюер получает письмо, сообщение в Slack или Discord и жмёт кнопку в веб-приложении, где видит аргументы вызова и пояснение агента.
Сервер разворачивается в Docker: docker run -d --name withhuman -p 8080:8080 -v withhuman-data:/data quay.io/withhuman/bundle:latest, затем секрет достаётся из /data/bootstrap-secret. Без Docker есть сборка из исходников, для неё нужны Go и Node 25. Для работы за пределами своей машины настройте HTTPS, укажите WITHHUMAN_PUBLIC_ORIGIN, список доверенных прокси в WITHHUMAN_TRUSTED_PROXIES и ключ WITHHUMAN_SECRETS_KEY; без SMTP приглашения и сброс пароля не дойдут до людей.
Какие задачи решает
- одобрять возврат средств перед его проведением
- пропускать вызовы инструментов по сумме в аргументах
- назначать ревьюера по команде и рабочим часам
- отклонять запрещённые агенту действия автоматически
- собирать очередь заявок на решение в веб-приложении
Примеры запросов агенту
- Свяжи этот агент с withHuman и настрой конвейер: возвраты до 20 долларов одобрять сразу, крупнее — спрашивать меня
- Добавь путь эскалации на команду payments в рабочие часы, остальное пусть уходит дежурному
- Покажи, какие вызовы инструментов сейчас ждут моего одобрения
Как установить withHuman
Командой платформы: удалённый сервер
claude mcp add --transport http withhuman https://app.withhuman.ai/api/mcp/v1Командой платформы: удалённый сервер
codex mcp add withhuman --url https://app.withhuman.ai/api/mcp/v1Файл настроек
{
"mcpServers": {
"withhuman": {
"url": "https://app.withhuman.ai/api/mcp/v1"
}
}
}Файл настроек
{
"servers": {
"withhuman": {
"type": "http",
"url": "https://app.withhuman.ai/api/mcp/v1"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http withhuman https://app.withhuman.ai/api/mcp/v1По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о withHuman
Как установить withHuman в Claude Code?
Выполните claude mcp add --transport http withhuman https://app.withhuman.ai/api/mcp/v1.
Что делает withHuman?
Проверяет вызовы инструментов агента до запуска и либо одобряет их по правилам, либо отклоняет, либо отправляет человеку на согласование. Ревьюер решает в веб-приложении или по ссылке из письма, Slack и Discord.
Что нужно, чтобы запустить withHuman у себя?
Docker для запуска готового контейнера. Сборка из исходников требует Go и Node 25. Перед выходом за пределы локальной машины понадобятся HTTPS, SMTP и ключ WITHHUMAN_SECRETS_KEY.
