MCP · Полное руководство · октябрь 2026

Peerivo Watch MCP

Поиск, чтение сайтов, работа с настоящим Chromium и автономные задачи прямо из ChatGPT. Ниже — пошаговое подключение, параметры каждого инструмента и ограничения доступа.

Точный URL сервера

https://watch-mcp.peerivo.net/mcp

Протокол — MCP Streamable HTTP с HTTPS и OAuth. Личный кабинет: https://watch.peerivo.net/app.

Запрос к /mcp без OAuth отвечает 401 invalid_token. Это правильная защита API, а не неисправность и не страница входа.

Как подключить MCP к ChatGPT

  1. Откройте ChatGPT на веб-сайте. Перейдите в Plugins → + → Add custom MCP server. Возможность может зависеть от плана и политики рабочего пространства.
  2. Имя: Peerivo Watch. В Server URL укажите https://watch-mcp.peerivo.net/mcp.
  3. Выберите OAuth-авторизацию и подтвердите предупреждение о доверии к внешним инструментам. Нажмите Create as a plugin.
  4. При авторизации войдите через Peerivo ID на сайте Watch и подтвердите необходимые разрешения watch:read и watch:write.
  5. Вернитесь в ChatGPT, проверьте обнаруженные команды и включите плагин в новом чате. Его можно вызвать через @Peerivo Watch.
  6. Для проверки напишите: «@Peerivo Watch Найди официальный сайт Node.js и открой его главную страницу».

Скриншоты интерфейса быстро устаревают — сверяйтесь с официальной инструкцией ChatGPT.

Отдельные адреса для разных задач

watch.peerivo.net/app — вход, кабинет, кошелёк, приватные экраны. watch-mcp.peerivo.net/mcp — машинное подключение. Не используйте watch-mcp.peerivo.net/app для входа.

Другие ИИ — Claude, Gemini, Cursor

Watch поддерживает OAuth Client ID Metadata Documents (CIMD): MCP-клиент публикует собственную HTTPS-метадату, а Watch проверяет точное совпадение client_id и redirect_uri перед авторизацией. Совместимость с конкретными версиями Claude/Cursor/Gemini требует E2E-проверки. Пошаговая настройка разных ИИ. Административный deployment-ключ нельзя выдавать пользователям.

Режимы доступа

watch:read

Поиск, Fetch, извлечение полей, просмотр браузера, чтение собственных запусков и переходы.

watch:write

Агентные запуски и управление ими, браузерные действия и запрос ручной проверки — с дополнительными серверными ограничениями.

Наличие scope watch:write не снимает серверных ограничений на мутации. Persistent profiles, server-side credentials и workflow grants — привилегированные возможности; у обычного Peerivo ID нет права использовать deployment-гранты.

Поиск и Fetch не оплачиваются как платные агентные действия. Для Agent/Browser есть тарифные единицы; условия и доступность платежей смотрите на странице тарифов.

Все MCP-инструменты и параметры

В каталоге представлены все 27 команд полного deployment-реестра; из них 19 доступны в пользовательском OAuth. Остальные 8 команд относятся к служебному контуру и не выдаются в списке инструментов OAuth-клиентам.

27 инструментов

Поиск и чтение

OAuth: чтение

web_fetch

Открывает публичную страницу в Chromium и возвращает текст и ссылки.

Параметры: url
OAuth: чтение

browser_extract

Извлекает поля по CSS-селекторам из отрисованной страницы.

Параметры: url, fields[{name,selector,attribute?,all?}]
В OAuth заглушка

web_task

Автономный поисковый цикл без кликов; доступен в deployment-контуре. Для OAuth используйте web_search/web_fetch или Web Agent.

Параметры: goal, outputSchema?

Браузер

OAuth: чтение

browser_open

Создать изолированную сессию собственного Chromium.

Параметры: url?
OAuth: чтение

browser_snapshot

ARIA-снимок страницы с исключением известных секретов.

Параметры: sessionId
OAuth: чтение

browser_observe

ARIA, интерактивные элементы с ref и изображение экрана.

Параметры: sessionId, includeScreenshot?
OAuth: чтение

browser_navigate

Открыть допустимый HTTP(S)-адрес в своей сессии.

Параметры: sessionId, url
OAuth: чтение

browser_detect_challenge

Найти признаки CAPTCHA и ручных проверок.

Параметры: sessionId
OAuth: действие (с одобрением)

browser_action

wait/click/fill/press по selector или ref; изменения ограничены настройками и токеном разрешения.

Параметры: sessionId, action{type, selector?|ref?, value?, key?, approvalToken?}
OAuth: действие

browser_request_human

Приостановить собственную сессию для ручной проверки.

Параметры: sessionId, reason?, ttlMs?
OAuth: чтение

browser_close

Закрыть собственную сессию.

Параметры: sessionId

Агент

OAuth: чтение

web_agent_templates

Перечень готовых шаблонов целей и схем результатов.

Параметры: без параметров
OAuth: действие

web_agent_start

Запустить Web Agent, получить runId и ссылку на приватный экран.

Параметры: url, goal, maxEffect?, maxSteps?, outputSchema?
OAuth: действие

web_agent

Автономная браузерная задача на естественном языке.

Параметры: url, goal, maxEffect?, maxSteps?, outputSchema?, inputs?
OAuth: действие

web_agent_batch_start

Пакетный старт до 20 независимых заданий в рамках лимитов аккаунта.

Параметры: runs[{url,goal,maxEffect?,outputSchema?,inputs?}]
OAuth: чтение

web_agent_runs

Список собственных запусков.

Параметры: limit? (1–100)
OAuth: чтение

web_agent_run_status

Статус и результат своего запуска.

Параметры: runId
OAuth: действие

web_agent_run_cancel

Отменить свой запуск.

Параметры: runId
OAuth: действие

web_agent_run_resume

Продолжить свой запуск после прохождения ручной проверки.

Параметры: runId
В OAuth заглушка

web_agent_resume

Старый интерфейс resume по taskId; в OAuth используйте web_agent_run_resume.

Параметры: taskId

Администрирование

Только deployment

browser_open_profile

Открыть зашифрованный постоянный профиль через краткоживущий грант.

Параметры: grantId, url
Только deployment

browser_apply_credential

Ввод учётных данных из серверного broker без раскрытия модели.

Параметры: sessionId, grantId, selectors
Только deployment

workflow_run

Версионированный детерминированный сценарий по гранту.

Параметры: grantId, sessionId, inputs?, credentialGrants?
Только deployment

workflow_resume

Продолжение сценария после требуемого одобрения.

Параметры: runId
Только deployment

workflow_repair_propose

Кандидаты на исправление локаторов шага и их валидация.

Параметры: workflowId, stepId, sessionId

Готовые сценарии

Открыть публичный демокаталог — безопасная проверка извлечения данных без входа или оплаты.

Поиск и изучение сайта

@Peerivo Watch Найди документацию PostgreSQL
о JSONB, открой 3 первоисточника,
верни ссылки и краткое сравнение.

Подходящие команды: web_search, web_fetch, browser_extract.

Автономный браузерный агент

@Peerivo Watch Открой https://example.com.
Проверь наличие формы обратной связи.
Верни JSON {found, title, evidence}.
Ничего не отправляй и не оплачивай.

Пример outputSchema для web_agent_start:

{"type":"object","properties":{"found":{"type":"boolean"},"title":{"type":"string"},"evidence":{"type":"string"}},"required":["found","title","evidence"]}

Пошаговая работа с браузером

browser_open({url}) → browser_observe({sessionId}) → browser_navigate либо разрешённый browser_action → browser_close. После изменения страницы элементный ref нужно получать заново.

Долгий запуск и ручная проверка

web_agent_start → web_agent_run_status → откройте собственный live viewer в Watch. Когда требуется CAPTCHA или 2FA, пройдите её лично, затем используйте web_agent_run_resume. Для остановки используйте web_agent_run_cancel.

Безопасность

  • OAuth с привязкой к Peerivo ID: доступ к чужой сессии по одному sessionId или runId не предоставляется.
  • Запрещены адреса localhost, приватные IP, неподдерживаемые схемы, URL со встроенными учётными данными.
  • Изолированные браузерные контексты; чувствительные значения исключаются из снимков при известных credential grants.
  • Не помещайте пароли, коды подтверждения, deployment API key или Bearer token в чат и описание задачи.
  • Клики и заполнение форм ограничены отдельными одобрениями; необратимые операции требуют подтверждения.
  • CAPTCHA обрабатывается через Human Desk с участием человека, без обхода защиты.
  • Число одновременных запусков и частота задач ограничены сервером; возможны ответы 429.

Если не работает

401 invalid_token / OAuth authorization required

Не открывайте /mcp как обычную страницу. Создайте OAuth-подключение в ChatGPT, проверьте полный адрес и завершите согласие в Peerivo ID.

«Разрешить» нажата, но вход не завершён

Создайте новое подключение OAuth из ChatGPT. Повторная отправка уже использованного одноразового кода не работает; проверьте cookies и актуальную сессию на сайте Watch.

Tool not found

Проверьте точное название команды, обновите сведения об инструментах в Plugins и откройте новый чат. Убедитесь, что авторизация дала требуемый scope.

Writes disabled / approval required

На сервере запрещены изменения либо требуется специальное одобрение. Одна авторизация OAuth не включает опасные операции. Используйте режим чтения или разрешённый сценарий.

Browser session does not belong to this account

Сессия чужая, истекла или была закрыта. Запустите browser_open через текущий Peerivo ID.

Deployment grant not available

Вызван административный профиль, workflow либо broker credentials через обычный OAuth. Они пока не предоставляются пользовательскому аккаунту.

429, слишком много задач

Посмотрите web_agent_runs, остановите завершённые/лишние задачи; не превышайте лимиты аккаунта.

Частые вопросы

Нужен ли свой сервер?

Нет, для пользовательского OAuth достаточно публичного MCP endpoint и Peerivo ID.

Нужен ли токен владельца?

Нет. Служебный deployment token не предназначен для передачи людям. Входите через OAuth.

Платное ли подключение?

Само подключение не требует покупки. Оплата действий и её активация описаны в тарифах Watch.

Где просматривать экран агента?

В личном кабинете Watch, в разделе собственных запусков.

Как обратиться в поддержку?

Почта: triombus@gmail.com. Указывайте инструмент и текст ошибки, не присылайте пароли и токены.