MCP для ИИ-ассистентов
ИИ-ассистент в редакторе кода или в чате подключается к вашим адресам приёма по Model Context Protocol: сам ждёт вебхук, читает его целиком, настраивает ответы, а через CLI ещё и пробрасывает запросы на ваш localhost. Пока вы отлаживаете обработчик, переключаться в ленту и копировать тела не нужно.
Через CLI (рекомендуем)
Все инструменты, включая туннель на localhost и повтор запросов на ваш локальный сервис. MCP-клиент сам запускает CLI на вашей машине, токен вручную копировать не нужно.
- Заведите аккаунт, бесплатный тариф подходит.
- Установите CLI и выполните
webhooks login, вход откроется в браузере. - В настройках MCP-клиента добавьте сервер, который запускается командой
webhooks mcp(транспорт stdio). Флагом--allow localhost:3000разрешите локальный сервис, куда ассистенту можно поднять туннель и повторять запросы. Если сервисов несколько, повторите флаг. Без него туннель и повтор не работают: порты разрешаете вы, а не ассистент. - Попросите ассистента показать ваши адреса или поднять туннель на ваш порт, и он вызовет инструменты сам.
{
"mcpServers": {
"webhooks": {
"command": "webhooks",
"args": [
"mcp",
"--allow",
"localhost:3000"
]
}
}
}Без установки, по адресу
Для ассистентов в браузере или в облаке, которые не запускают программы на вашей машине. Инструменты те же, кроме туннеля и повтора на localhost: сервис до вашей машины не достаёт.
- Создайте токен: кабинет → «Настройки» → «API-токены». Токен показывается один раз, сразу скопируйте его.
- В настройках MCP-клиента добавьте удалённый сервер (Streamable HTTP) по адресу
https://hook.csap.ru/api/v1/mcpс заголовкомAuthorization: Bearer whk_….
{
"mcpServers": {
"webhooks": {
"type": "http",
"url": "https://hook.csap.ru/api/v1/mcp",
"headers": {
"Authorization": "Bearer whk_…"
}
}
}
}Что можно попросить
Отладка платёжного уведомления
«Дождись вебхука на мой адрес, я сделаю тестовую оплату. Проверь, что обработчик верно читает статус и сумму.»
Проверка повторов
«Настрой адресу ответ 500 на все POST-запросы, а после первого повтора верни 200. Покажи, через сколько пришёл повтор.»
Разбор незнакомого формата
«Покажи последние три запроса с адреса и опиши, чем отличаются их тела. Напиши тип для этих данных.»
Инструменты
| Инструмент | Что делает | Где |
|---|---|---|
| list_endpoints | адреса приёма аккаунта с полными ссылками | везде |
| create_endpoint | завести новый адрес в пределах тарифа | везде |
| list_requests | запросы адреса, новые первыми: фильтр по методу и времени, курсор before для следующей страницы | везде |
| get_request | разбор запроса: заголовки, параметры и тело текстом, двоичное в base64; длинное тело обрезается | везде |
| wait_for_request | дождаться следующего запроса: ответ приходит, как только запрос принят, или по истечении ожидания | везде |
| get_rules | правила ответов адреса и каталог условий и действий | везде |
| set_rules | заменить правила адреса целиком, с теми же проверками и лимитами, что в редакторе | везде |
| get_recipients | получатели копий адреса: куда уходит копия каждого подходящего запроса, сводка доставок и лимит тарифа | везде |
| save_recipient | завести или изменить получателя копий: адрес и условия, с теми же проверками, что в кабинете | везде |
| delete_recipient | удалить получателя копий; прошлые доставки остаются в журнале адреса | везде |
| list_test_events | каталог примеров вебхуков провайдеров: платежи, мессенджеры, CRM, для разработчиков | везде |
| send_test_event | прислать на адрес пример вебхука провайдера как настоящий запрос: квота, правила, туннель; подписан секретом адреса, если он задан | везде |
| start_tunnel | пробросить запросы адреса на локальный сервис (по умолчанию http://localhost:3000) | только через CLI |
| stop_tunnel | остановить туннель адреса или все | только через CLI |
| tunnel_status | туннели: цель, состояние, сколько запросов доставлено, последняя ошибка | только через CLI |
| tunnel_logs | последние доставки туннеля: метод, путь, ответ локального сервиса, время (без тел) | только через CLI |
| replay_request | повторить запрос из ленты на локальный сервис, при желании поменяв метод, путь, заголовки или тело | только через CLI |
Безопасность
- Ассистент получает те же права, что и CLI: адреса, запросы и правила ответа. Пароль, оплата и настройки аккаунта ему недоступны.
- Туннель и повтор через CLI идут только на вашу машину: localhost, 127.0.0.1 или [::1]. Другой адрес, даже в локальной сети, отклоняется.
- Участник команды с ролью наблюдателя через MCP только смотрит и не меняет правила.
- Чтобы закрыть доступ, отзовите токен на странице «API-токены»: ассистент сразу получит отказ.
- Частота вызовов ограничена, данные хранятся на сервере в России.
Подробности для разработчиков есть в документации. Для проброса запросов на localhost нужен туннель через CLI.