three.ws Herald — MCP-сервер для Claude Code
Выводит 3D-аватара во вкладку браузера, чтобы агент лично озвучил завершение долгой задачи или ошибку. Помогает не пропустить критичные события в фоне.
claude mcp add --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio herald-mcp -- npx -y @three-ws/herald-mcpЧто делает three.ws Herald
Сервер отправляет важные события агента на личный канал пользователя в сервисе three.ws. Вместо сухой строчки в терминале на открытой веб-странице появляется трёхмерный персонаж: он жестикулирует, проговаривает статус голосом и оставляет ссылку на результат. На устройствах без поддержки GPU интерфейс переключается на обычную карточку с текстом.
Внутри доступны три инструмента. Функция announce передаёт произвольные реплики с настройкой важности от 0 до 100, announce_result отчитывается по завершённым задачам, а check_rail тихо проверяет соединение. Браузерная библиотека сама отсекает лишний спам через фильтры частоты, ночной режим и порог срочности.
Если в браузере не открыта ни одна вкладка, сообщение сгорит примерно через пять минут. Для работы обязательно нужен ключ THREE_WS_API_KEY с правом herald:announce. Оповещения приходят исключительно владельцу токена, поэтому отправить сообщение чужому человеку через этот сервер технически невозможно.
Какие задачи решает
- получать голосовые уведомления о завершении долгих миграций и бэкфиллов
- узнавать об авариях фоновых воркеров без постоянной проверки консоли
- привлекать внимание человека к срочным решениям агента
- проверять статус шины оповещений без ложных срабатываний
Примеры запросов агенту
- Запусти миграцию базы данных и позови меня через herald, когда всё закончится
- Проверь соединение с шиной оповещений через herald
- Если сборка упадёт с ошибкой, оповести меня в браузере с максимальным приоритетом
Как установить three.ws Herald
Командой платформы
claude mcp add --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio herald-mcp -- npx -y @three-ws/herald-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add herald-mcp --env THREE_WS_API_KEY=<THREE_WS_API_KEY> --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -- npx -y @three-ws/herald-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"herald-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/herald-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>",
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"herald-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/herald-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>",
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e THREE_WS_API_KEY=<THREE_WS_API_KEY> -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> herald-mcp npx -y @three-ws/herald-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о three.ws Herald
Как установить three.ws Herald в Claude Code?
Выполните команду claude mcp add herald-mcp -e THREE_WS_API_KEY=<THREE_WS_API_KEY> -- npx -y @three-ws/herald-mcp, подставив свой ключ из кабинета разработчика.
Что делает three.ws Herald?
Он передаёт важные сообщения от агента прямо в активный браузер через говорящего 3D-персонажа. Это избавляет от необходимости прокручивать логи терминала в ожидании финиша.
Можно ли отправлять оповещения другим людям?
Нет, доставка работает только на открытые вкладки владельца API-ключа. Параметра выбора получателя в инструментах нет из соображений безопасности.
