# Свой fetch-инструмент для ассистента

Подключите к ассистенту инструмент, который читает веб-страницы по-настоящему. Он живет на Just Run, доступен по HTTPS с любой машины и возвращает сводку релизов со ссылками на прочитанные источники.

* **Скачайте:** [скрипт настройки](/example-assets/hosted-fetch.zip)
* **Вам понадобится:** Bash, cURL и jq локально. Ключ провайдера модели fetch-серверу не нужен.

## Запуск[​](#run "Прямая ссылка на Запуск")

Распакуйте архив `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](/hosted-mcp/logs-testing-and-troubleshooting).

## Что получится[​](#result "Прямая ссылка на Что получится")

Скрипт проверяет `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
Подготовь короткую сводку для сопровождения: недавние изменения, что стоит
протестировать и подтверждающую ссылку для каждого пункта. Отделяй факты от выводов.
Если страницу не удалось прочитать, скажи об этом; не заполняй пробел по памяти.
```

Проверьте фактические вызовы инструмента и процитированные места. Одной настройки подключения недостаточно, чтобы считать, что ассистент им воспользовался. Полученные страницы — внешние данные, а не инструкции к выполнению.

## Как адаптировать[​](#customise "Прямая ссылка на Как адаптировать")

Подставьте официальные страницы зависимостей, которые сопровождает ваша команда. Запрос тоже перепишите под себя: назовите нужный инструмент, перечислите свои адреса и потребуйте подтверждающую ссылку для каждого пункта. Оговорку про нечитаемую страницу оставьте — она удерживает ассистента от ответа по памяти.

## Удаление ресурсов[​](#cleanup "Прямая ссылка на Удаление ресурсов")

Удалите подключение из ассистента, затем управляемый инстанс:

```
api DELETE "/v1/hosted-mcp/$MCP_ID"
unset MCP_TOKEN JUSTRUN_PAT
```

Удаление инстанса удаляет и его песочницу. При ошибке настройки используйте выведенный ID в веб-интерфейсе; скрипт оставляет сервис выделенным до удаления.

**Дальше:** [дайте ассистенту задачу с проверяемым результатом](/examples/build-a-coding-agent.md).
