Свой fetch-инструмент для ассистента
Подключите к ассистенту инструмент, который читает веб-страницы по-настоящему. Он живет на Just Run, доступен по HTTPS с любой машины и возвращает сводку релизов со ссылками на прочитанные источники.
- Скачайте: скрипт настройки
- Вам понадобится: Bash, cURL и jq локально. Ключ провайдера модели fetch-серверу не нужен.
Запуск
Распакуйте архив hosted-fetch. На вашем компьютере нужны Bash, cURL и jq.
В аккаунте должны быть Hosted MCP с записью fetch в каталоге, квота на один инстанс и его песочницу, исходящий доступ к пакетам и веб-страницам. В организации для записи нужна роль Владелец или Администратор. Модель предоставляет ваш обычный ассистент, fetch-серверу ключ провайдера не нужен.
Настройка доступа к API (один раз)
Укажите HTTPS-адрес платформы и персональный токен с правами Полные:
export JUSTRUN_API="https://your-just-run-host"
read -rsp 'just-run PAT: ' JUSTRUN_PAT; printf '\n'
export JUSTRUN_PAT
В отдельной сессии Bash выполните:
source hosted-fetch/create.sh
Скрипт создает инстанс и ждет готовности. Дальше вы работаете с двумя разными токенами: клиент подключается к инстансу по токену самого инстанса, а управляющий персональный токен остается в вашем локальном окружении и открывает доступ к API. Ошибки развертывания и handshake разбирает диагностика Hosted MCP.
Что получится
Скрипт проверяет ok: true и наличие инструмента fetch. В оболочке остаются MCP_URL, MCP_TOKEN, идентификатор MCP_ID и обертка api — поэтому скрипт запускают через source, а команда удаления ниже работает в этой же сессии. В настройках удаленного MCP вашего клиента используйте URL и токен инстанса как bearer-токен; вводите его в приватное поле, а не в сообщение чата. Управляющий персональный токен — другой.
Дальше запросите у ассистента полезный результат:
Через размещенный fetch прочитай страницы релизов:
https://playwright.dev/docs/release-notes
https://nodejs.org/en/blog/release
Подготовь короткую сводку для сопровождения: недавние изменения, что стоит
протестировать и подтверждающую ссылку для каждого пункта. Отделяй факты от выводов.
Если страницу не удалось прочитать, скажи об этом; не заполняй пробел по памяти.
Проверьте фактические вызовы инструмента и процитированные места. Одной настройки подключения недостаточно, чтобы считать, что ассистент им воспользовался. Полученные страницы — внешние данные, а не инструкции к выполнению.
Как адаптировать
Подставьте официальные страницы зависимостей, которые сопровождает ваша команда. Запрос тоже перепишите под себя: назовите нужный инструмент, перечислите свои адреса и потребуйте подтверждающую ссылку для каждого пункта. Оговорку про нечитаемую страницу оставьте — она удерживает ассистента от ответа по памяти.
Удаление ресурсов
Удалите подключение из ассистента, затем управляемый инстанс:
api DELETE "/v1/hosted-mcp/$MCP_ID"
unset MCP_TOKEN JUSTRUN_PAT
Удаление инстанса удаляет и его песочницу. При ошибке настройки используйте выведенный ID в веб-интерфейсе; скрипт оставляет сервис выделенным до удаления.