WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky
François Beaufort
François Beaufort
GitHub
Kasper Kulikowski
Kasper Kulikowski
X GitHub LinkedIn

Дата публикации: 18 мая 2026 г. Последнее обновление: 7 октября 2026 г.

WebMCP – это предлагаемый веб-стандарт, который помогает создавать и предоставлять структурированные инструменты для ИИ-агентов. WebMCP предоставляет JavaScript и аннотирует элементы HTML-форм, чтобы агенты знали, как взаимодействовать с функциями страницы и помогать пользователям. Это может значительно повысить эффективность и надежность выполнения действий агентом.

ИИ-агенты – это новая технология. Они могут помочь пользователям лучше выполнять задачи, которые являются очень сложными и техническими. WebMCP повышает точность выполнения задач агентами и может быть добавлен в качестве прогрессивного улучшения.

Объяснение Веб Расширения Статус Chrome Намерение
GitHub Эксперимент с источником Эксперимент с источником Открыть Intent to Experiment (Намерение провести эксперимент)

Почему WebMCP?

WebMCP предоставляет правила взаимодействия, которые устраняют разрыв между веб-приложениями и агентами, повышая эффективность, надежность и выполнение задач. Вместо того чтобы агент проверял элемент, например кнопку или поле, чтобы понять его назначение, веб-сайт объявляет назначение элемента, чтобы он использовался по назначению.

Это надежнее, чем выполнение действий, которое может состоять из множества шагов, каждый из которых агент может интерпретировать по-своему.

Слева агент скрейпит DOM. Справа агент вызывает инструмент. Попробуйте сами на нашей демонстрационной странице бронирования встреч.

Сайты могут сообщать о явной цели, например поиске или покупке, определяя tool. Инструменты выполняются на веб-странице наглядно, поэтому пользователи могут быть уверены, что задачи выполняются должным образом. Это также сохраняет ваш бренд и ориентированные на человека варианты дизайна нетронутыми.

WebMCP поддерживает:

  • Обнаружение. Стандартный способ регистрации инструментов на страницах с помощью агентов, таких как checkout или filter_results.
  • Схемы JSON. Явные определения входных и ожидаемых выходных данных, позволяющие снизить вероятность галлюцинаций и недопонимания.
  • Состояние. Общее понимание текущего контекста страницы, чтобы агент знал, какие ресурсы доступны для действий в реальном времени.

Наша цель – создать API, которые можно внедрить в любой браузер с агентными возможностями, чтобы пользователям было проще выполнять задачи. Вы можете следить за этим процессом на GitHub.

Примеры использования

Использовать WebMCP можно по-разному. Пример:

  • Помогите клиентам получить поддержку. Если вы предоставляете клиентам программное обеспечение, у вас может быть сложный процесс поддержки для решения множества различных вопросов. WebMCP позволяет агенту быстрее перейти к нужной форме и заполнить поля информацией, предоставленной пользователем.
  • Улучшение бронирования путешествий. Помогите агентам бронировать сложные поездки с несколькими городами и пассажирами за меньшее количество шагов.

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

На практике ваши инструменты могут выполнять следующие задачи:

  • Заполнение структурированных форм. Создайте инструмент на основе submit_application, который будет помогать агентам сопоставлять данные, собранные в ходе разговора с пользователем, с полями формы. Например, вы можете указать, что в поле нужно ввести полное имя, а не имя и фамилию по отдельности.
  • Взаимодействие агентов поддержки с интерфейсами, предназначенными для людей. Некоторые поля предназначены для людей и могут быть непонятны агентам. Вы можете создать инструмент date_pick, который позволяет выбирать дату и время при бронировании.
  • Ускоренная отладка приложений. Вы можете создать инструмент run_diagnostics на странице настроек для разработчиков, чтобы агент мог запускать исправления, которые в противном случае скрыты за вложенными меню.

Не нашли нужный вариант использования? Или у вас есть идея, которой вы хотите поделиться для WebMCP? Задавайте вопросы и участвуйте в обсуждениях на GitHub.

Начать

Присоединитесь к эксперименту с источником WebMCP в Chrome 149. Подробнее о том, как начать работу с экспериментами с источником…

Локальный WebMCP

WebMCP доступен в качестве экспериментального параметра Chrome для локальной разработки:

  1. Откройте Chrome и перейдите на страницу chrome://flags/#enable-webmcp-testing.
  2. Установите для параметра значение Enabled (Включено).
  3. Перезапустите Chrome, чтобы применить изменения.

Использовать API WebMCP

Для настройки инструментов сайта можно использовать два API:

  • Императивный API. Определяйте различные типы инструментов с помощью стандартного JavaScript, например ввод формы, инструменты навигации, управление состоянием или другие функции.
  • Declarative API. Добавьте аннотации в стандартные HTML-формы, чтобы создать инструмент WebMCP.

Вы можете отлаживать инструменты WebMCP и проверять, как браузер анализирует схему JSON, с помощью инструментов разработчика Chrome.

Ограничения

Хотя WebMCP упрощает выполнение сложных задач для агентов и людей, у него есть ограничения:

  • Просмотр в режиме Headless. Хотя инструменты WebMCP можно запускать в средах Headless, этот API в первую очередь предназначен для локальных рабочих процессов в браузере с участием человека в контуре.
  • Дополнительная нагрузка для сложных интерфейсов. Если у вас очень сложный сайт, вам, скорее всего, потребуется провести рефакторинг или добавить код JavaScript для обработки состояния приложения и интерфейса.
  • Обнаружение инструментов. Клиенты и браузеры должны напрямую посещать сайт, чтобы узнать, есть ли на нем вызываемые инструменты.

Правила в отношении разрешений

Оба API ограничены правилами в отношении разрешений tools. По умолчанию используется значение self, которое разрешает регистрацию инструментов в контекстах верхнего уровня и одного источника и запрещает ее для междоменных окон iframe.

Чтобы разрешить использование инструментов WebMCP в iframe из разных источников, добавьте в iframe атрибут allow="tools".

Демоверсии

Примеры демонстраций, охватывающих как императивные, так и декларативные реализации, доступны по следующим ссылкам:

Вы также можете изучить исходный код демоверсии на GitHub.

Протестируйте инструменты, имитируя агента

Мы создали два расширения Chrome, которые помогут вам понять, как работают инструменты WebMCP в наших демоверсиях и ваших приложениях.

Установите пример расширения Chrome с агентом, чтобы проверять, отслеживать и выполнять инструменты WebMCP с помощью запросов на естественном языке. В частности, это расширение всегда доверяет аннотациям WebMCP, которые могут предупреждать агента о действиях, связанных с безопасностью. Это показывает, как инструмент может работать по-разному с аннотациями.

По умолчанию это расширение использует небольшой сервер Node с AI SDK. Ключи API обязательны и хранятся на локальном сервере. По умолчанию запросы отправляются в модель gemini-3.6-flash, но вы можете изменить модель и поставщика API в файле .env расширения. В расширении есть поля для OpenAI, Google и Anthropic. Вы также можете настроить его для использования модели от другого поставщика.

Вы также можете использовать клиентскую модель с Prompt API. Для этого не требуются ключи API, а данные остаются на вашем устройстве. Для этого включите правило chrome://flags/#prompt-api-tool-use.

Установите расширение Model Context Tool Inspector, чтобы поэкспериментировать с агентом и посмотреть, как инструменты WebMCP работают в демоверсиях или ваших приложениях. Используйте запросы на естественном языке, чтобы определить, взаимодействует ли агент с инструментами WebMCP так, как ожидается.

Чтобы Gemini мог вызывать ваши инструменты, у вас должен быть ключ API, который вы указываете в интерфейсе расширения. По умолчанию ваши запросы отправляются в модель gemini-3.6-flash. Вы можете выбрать другую модель Gemini для экспериментов или настроить код расширения, чтобы использовать модель другого поставщика.

Взаимодействие и отзывы

Протокол WebMCP активно обсуждается и может измениться в будущем. Если вы попробуете эти API и захотите поделиться мнением, мы будем рады его услышать.

Далее
Императивный API