# MCP Events bridge

MCP-сервер MCP Events bridge для Claude Code превращает вебхуки в события, на которые подписываются ИИ-агенты через Hookdeck Event Gateway.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 у репозитория
- Автор: hookdeck
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/hookdeck/mcp-events-bridge
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/mcp-events-bridge

## Что делает

Мост транслирует входящие вебхуки от GitHub, Resend и других сервисов в формат MCP Events, избавляя агентов от постоянного опроса. Шлюз проверяет подписи, записывает попытки и повторяет доставку при сбоях. Для запуска нужны ключи `HOOKDECK_API_KEY`, `HOOKDECK_SIGNING_SECRET`, `BRIDGE_MCP_SECRET` и `RESEND_API_KEY`.

Клиенты с поддержкой MCP Events получают вебхуки напрямую, а Claude Code опрашивает сервер через инструменты `wait_for_event` и `poll_events`. Архитектура работает без базы данных, сохраняя каждое соединение как сеанс Event Gateway. Консольная утилита Hookdeck пересылает события на локальную машину без публичного URL.

Каждое событие фильтруется по параметрам подписки, таким как отправитель почты или репозиторий. Пакет распространяется как открытый проект версии 0.9 и требует Node.js для выполнения через `npx` в окружении клиента.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `HOOKDECK_API_KEY`, `HOOKDECK_SIGNING_SECRET`, `BRIDGE_MCP_SECRET`, `BRIDGE_PORT`, `RESEND_API_KEY`, `GITHUB_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mcp-events-bridge -e HOOKDECK_API_KEY=<HOOKDECK_API_KEY> -e HOOKDECK_SIGNING_SECRET=<HOOKDECK_SIGNING_SECRET> -e BRIDGE_MCP_SECRET=<BRIDGE_MCP_SECRET> -e RESEND_API_KEY=<RESEND_API_KEY> -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @hookdeck/mcp-events-bridge
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add mcp-events-bridge --env HOOKDECK_API_KEY=<HOOKDECK_API_KEY> --env HOOKDECK_SIGNING_SECRET=<HOOKDECK_SIGNING_SECRET> --env BRIDGE_MCP_SECRET=<BRIDGE_MCP_SECRET> --env BRIDGE_PORT=<BRIDGE_PORT> --env RESEND_API_KEY=<RESEND_API_KEY> -- npx -y @hookdeck/mcp-events-bridge
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-events-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "@hookdeck/mcp-events-bridge"
            ],
            "env": {
                "HOOKDECK_API_KEY": "<HOOKDECK_API_KEY>",
                "HOOKDECK_SIGNING_SECRET": "<HOOKDECK_SIGNING_SECRET>",
                "BRIDGE_MCP_SECRET": "<BRIDGE_MCP_SECRET>",
                "BRIDGE_PORT": "<BRIDGE_PORT>",
                "RESEND_API_KEY": "<RESEND_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-events-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hookdeck/mcp-events-bridge"
            ],
            "env": {
                "HOOKDECK_API_KEY": "<HOOKDECK_API_KEY>",
                "HOOKDECK_SIGNING_SECRET": "<HOOKDECK_SIGNING_SECRET>",
                "BRIDGE_MCP_SECRET": "<BRIDGE_MCP_SECRET>",
                "BRIDGE_PORT": "<BRIDGE_PORT>",
                "RESEND_API_KEY": "<RESEND_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e HOOKDECK_API_KEY=<HOOKDECK_API_KEY> -e HOOKDECK_SIGNING_SECRET=<HOOKDECK_SIGNING_SECRET> -e BRIDGE_MCP_SECRET=<BRIDGE_MCP_SECRET> -e BRIDGE_PORT=<BRIDGE_PORT> -e RESEND_API_KEY=<RESEND_API_KEY> mcp-events-bridge npx -y @hookdeck/mcp-events-bridge
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

## Когда брать
- получать уведомления о падении CI-пайплайна прямо в сеансе агента
- обрабатывать входящие письма от Resend внутри ИИ-агента
- фильтровать вебхуки GitHub по репозиториям и действиям
- синхронизировать события внешних сервисов без опроса API

## Примеры запросов агенту
- Подожди новое событие от вебхука через инструменты моста
- Запроси последние события от вебхука через `poll_events`
- Подпишись на входящие письма от Resend в агенте

## Похожие
- [hookdeck-event-gateway](https://affpapa.org/nevibecode/skills/hookdeck-event-gateway.md) — скилл · 214 установок
- [cursor-webhooks](https://affpapa.org/nevibecode/skills/cursor-webhooks.md) — скилл · 200 установок
- [vercel-webhooks-events](https://affpapa.org/nevibecode/skills/vercel-webhooks-events.md) — скилл · 1 установка
- [inngest-events](https://affpapa.org/nevibecode/skills/inngest-events.md) — скилл · 4000 установок
- [maintainx-webhooks-events](https://affpapa.org/nevibecode/skills/maintainx-webhooks-events.md) — скилл · 1 установка
- [gateway-workers](https://affpapa.org/nevibecode/skills/gateway-workers.md) — скилл · 25500 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
