Hookdeck CLI
CLI Hookdeck пересылает вебхуки на локальный сервер, управляет Event Gateway и запускает MCP-сервер, через который агент разбирает сбои доставки
- 369 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Принимает на локальный порт вебхуки из внешней сети, а их содержимое и заголовки проходят через облачный сервис Hookdeck
- Хранит ключи API и данные входа в файлах конфигурации, а ключ CLI открывает все ваши проекты
- С флагом --allow-write агент получает право создавать, менять, удалять и повторять доставки в Event Gateway
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/hookdeck-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Что отправляет автору: что отправляет автору: инструмент hookdeck cli собирает анонимную телеметрию для улучшения работы. отключить отправку можно командой или переменной окружения.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Принимает на локальный порт вебхуки из внешней сети, а их содержимое и заголовки проходят через облачный сервис Hookdeck
- Хранит ключи API и данные входа в файлах конфигурации, а ключ CLI открывает все ваши проекты
- С флагом --allow-write агент получает право создавать, менять, удалять и повторять доставки в Event Gateway
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Hookdeck CLI — официальная командная утилита сервиса Hookdeck, которая решает три задачи. Первая: команда `hookdeck listen 3000 stripe` пересылает вебхуки на локальный сервер через постоянный бесплатный адрес события, причем история событий сохраняется между сессиями, и вы или коллеги можете просматривать и повторять доставку. Разработка с Hookdeck бесплатна, а деньги сервис берет за рабочую нагрузку. Авторы называют CLI заменой ngrok и других HTTP-туннелей, хотя подход другой. Вторая задача — управление ресурсами Event Gateway из терминала: источники, получатели, соединения, преобразования, события, запросы и попытки доставки. Можно повторить упавшее событие, создать преобразование и проверить его на тестовых данных, поставить соединение на паузу. Для рабочего процесса в CI есть команда `hookdeck ci` и вход по ключу API проекта, а вход по `hookdeck login` открывает браузер. Третья задача — MCP-сервер. Команда `hookdeck gateway mcp` запускается как подпроцесс stdio в Cursor или Claude Desktop и дает агенту инструменты для разбора трафика: проблемы, события, запросы, попытки, метрики и преобразования. По умолчанию сервер только читает, а создание, изменение и удаление включаются флагом --allow-write или переменной HOOKDECK_MCP_ALLOW_WRITE. Пауза соединения доступна и без записи. Отдельный `hookdeck outpost mcp` работает с продуктом Outpost: арендаторами и их получателями.
Для кого. Для разработчиков, которые принимают вебхуки Stripe, GitHub или Shopify и хотят отлаживать их на локальной машине, а также для команд на Hookdeck, которым нужен агент для разбора сбоев доставки.
Подходит, если
- Нужно принимать вебхуки платежного сервиса на локальном сервере по постоянному адресу, не меняя адрес при каждом запуске
- Вы хотите повторить прошлое событие на локальном сервере вместо того, чтобы снова вызывать его у провайдера
- Агент должен разобрать, почему падают доставки в боевой среде: список проблем, попытки, ошибка 500 и частота отказов по получателям
- Нужно из терминала или CI создавать источники, соединения и преобразования Event Gateway и проверять их на тестовых данных
- Нужно оставить агента в режиме чтения: по умолчанию MCP-сервер ничего не меняет, и все его инструменты чтения оканчиваются на _read
Не подходит, если
- Вы не пользуетесь Hookdeck и не хотите заводить аккаунт: утилита работает с сервисом Hookdeck и требует входа или временной гостевой учетной записи
- Вам нужен общий HTTP-туннель для не-вебхук-трафика: инструмент пересылает события, и один процесс слушает один источник
- Вы хотите доверить агенту запись без контроля: для изменения нужен флаг --allow-write, и его стоит включать осознанно
- Нужна управляемая выдача ключей API агентом: управление ключами намеренно не выведено в MCP
Пример запроса к агенту
Подключи Hookdeck MCP в режиме чтения и покажи, есть ли сейчас открытые проблемы доставки и какие события для моего источника Stripe закончились ошибкойОграничения
- Для работы нужен аккаунт Hookdeck. Без входа команды вроде `hookdeck listen` создают временную гостевую учетную запись.
- Один процесс CLI слушает один источник за раз.
- Ключ CLI открывает все проекты, ключ проекта только один проект, и только ключ CLI умеет перечислять проекты и переключать их.
- MCP-сервер по умолчанию только читает. Запись включается флагом --allow-write или переменной HOOKDECK_MCP_ALLOW_WRITE, а выдача и смена ключей API через MCP не выводится.
- Разработка бесплатна, рабочая нагрузка платная. Сервис Hookdeck облачный.
- Для сбора телеметрии в документации есть отдельный раздел, настройки лежат в файлах конфигурации.
Как отключить. Команда `hookdeck logout` выходит из аккаунта и убирает сохраненные учетные данные. Удалите блок hookdeck из конфигурации MCP-клиента и перезапустите клиент. Саму утилиту снимает менеджер пакетов, которым вы ставили: npm uninstall -g hookdeck-cli, brew uninstall hookdeck или scoop uninstall hookdeck.
Частые вопросы
Как принимать вебхуки на локальном сервере через Hookdeck?
Выполните hookdeck login, затем hookdeck listen 3000 stripe: 3000 здесь порт вашего сервера, stripe имя источника. CLI покажет постоянный адрес события и будет пересылать на него запросы. Путь меняет флаг --path, а вывод режим --output с вариантами interactive, compact и quiet.
Как подключить Hookdeck MCP к Cursor или Claude Desktop?
Добавьте в mcp.json Cursor или в claude_desktop_config.json сервер hookdeck с командой hookdeck и аргументами gateway и mcp. Клиент запустит его как подпроцесс stdio. Если вы не вошли в аккаунт, доступен инструмент hookdeck_login, который авторизует через браузер.
Может ли агент через MCP изменять данные в Hookdeck?
По умолчанию нет: сервер стартует только на чтение. Изменение включается флагом --allow-write или переменной HOOKDECK_MCP_ALLOW_WRITE=true. Паузу и снятие паузы соединения можно выполнять и без записи, так как это обратимо. Управление ключами API через MCP не доступно в любом режиме.
Чем Hookdeck CLI отличается от ngrok?
Hookdeck принимает события на своей стороне и пересылает их вам, общий туннель к вашей машине он не открывает. Адрес события постоянный и бесплатный для разработки, история событий сохраняется между сессиями, а доставку можно повторить. Авторы называют CLI заменой ngrok, хотя подход и философия у него другие.
Как использовать Hookdeck CLI в CI?
Войдите ключом проекта командой hookdeck ci --api-key или передайте ключ флагом --api-key в команду listen. Такой ключ ограничен одним проектом и не умеет перечислять проекты. Для входа ключом пользователя служит hookdeck login --cli-key.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальная панель для параллельных сессий Claude Code и Codex: кто работает, кто ждет ответа, плюс 3D-аквариум и Stream Deck
Логи, алерты и управление контейнерами Docker и Podman: MCP-сервер и CLI, права агента задает область токена
Защищенный MCP-рантайм, через который агент управляет локальными машинами, серверами и контейнерами
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
Удаленный MCP-сервер платформы Devopness, которая создает инфраструктуру и выкладывает приложения в ваших облачных аккаунтах
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
Коротко о README
README объясняет, что CLI пересылает вебхуки на локальный сервер и управляет ресурсами Event Gateway, и перечисляет способы установки через npm, Homebrew, Scoop, Linux и Docker. Дальше подробно описаны команды входа и прослушивания, фильтры событий, режимы вывода, работа в CI, управление ресурсами, оба MCP-сервера, файлы конфигурации и ключи.