MCP для ИИ-ассистентов

ИИ-ассистент в редакторе кода или в чате подключается к вашим адресам приёма по Model Context Protocol: сам ждёт вебхук, читает его целиком, настраивает ответы, а через CLI ещё и пробрасывает запросы на ваш localhost. Пока вы отлаживаете обработчик, переключаться в ленту и копировать тела не нужно.

Через CLI (рекомендуем)

Все инструменты, включая туннель на localhost и повтор запросов на ваш локальный сервис. MCP-клиент сам запускает CLI на вашей машине, токен вручную копировать не нужно.

  1. Заведите аккаунт, бесплатный тариф подходит.
  2. Установите CLI и выполните webhooks login, вход откроется в браузере.
  3. В настройках MCP-клиента добавьте сервер, который запускается командой webhooks mcp (транспорт stdio). Флагом --allow localhost:3000 разрешите локальный сервис, куда ассистенту можно поднять туннель и повторять запросы. Если сервисов несколько, повторите флаг. Без него туннель и повтор не работают: порты разрешаете вы, а не ассистент.
  4. Попросите ассистента показать ваши адреса или поднять туннель на ваш порт, и он вызовет инструменты сам.
настройка MCP-клиента: через CLI
{
  "mcpServers": {
    "webhooks": {
      "command": "webhooks",
      "args": [
        "mcp",
        "--allow",
        "localhost:3000"
      ]
    }
  }
}

Без установки, по адресу

Для ассистентов в браузере или в облаке, которые не запускают программы на вашей машине. Инструменты те же, кроме туннеля и повтора на localhost: сервис до вашей машины не достаёт.

  1. Создайте токен: кабинет → «Настройки» → «API-токены». Токен показывается один раз, сразу скопируйте его.
  2. В настройках MCP-клиента добавьте удалённый сервер (Streamable HTTP) по адресу https://hook.csap.ru/api/v1/mcp с заголовком Authorization: Bearer whk_….
настройка MCP-клиента: по адресу
{
  "mcpServers": {
    "webhooks": {
      "type": "http",
      "url": "https://hook.csap.ru/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer whk_…"
      }
    }
  }
}

Что можно попросить

Отладка платёжного уведомления

«Дождись вебхука на мой адрес, я сделаю тестовую оплату. Проверь, что обработчик верно читает статус и сумму.»

Проверка повторов

«Настрой адресу ответ 500 на все POST-запросы, а после первого повтора верни 200. Покажи, через сколько пришёл повтор.»

Разбор незнакомого формата

«Покажи последние три запроса с адреса и опиши, чем отличаются их тела. Напиши тип для этих данных.»

Инструменты

Инструменты MCP для ИИ-ассистентов
ИнструментЧто делаетГде
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.

Cookie и Яндекс Метрика

Мы хотим подключить Яндекс Метрику: она ставит cookie и помогает понять, как посетители пользуются сайтом. Метрика заработает, только если вы разрешите. Без неё сервис работает так же. Политика обработки данных