> For AI agents: the complete documentation index is available at /rspress-russian/llms.txt, the full documentation bundle is available at /rspress-russian/llms-full.txt.

# WebMCP


[Добавлено в v2.1.0](https://github.com/web-infra-dev/rspress/releases/tag/v2.1.0)

Rspress включает [`webMcp`](/rspress-russian/api/config/config-agent.md#webmcp) по умолчанию, поэтому агенты могут использовать [WebMCP](https://developer.chrome.com/docs/ai/webmcp), чтобы искать, читать и перемещаться по документации Rspress. Подробнее см. в [ChatGPT - Site tools](https://learn.chatgpt.com/docs/webmcp).


Для вашего агента

Попробуйте WebMCP со своим агентом

Скопировать

Откройте https://rspress.rs в браузере и проверьте, какие WebMCP-инструменты страница предоставляет вам. Используйте названия и описания, которые вернул браузер, чтобы перечислить каждый инструмент по имени и в одном предложении объяснить, что он умеет. Если список пуст или вам не удалось получить к нему доступ, сообщите, что именно произошло.

```ts title="rspress.config.ts"
import { defineConfig } from '@rspress/core';

export default defineConfig({
  webMcp: true, // значение по умолчанию
});
```

Установите `webMcp: false`, чтобы отключить встроенные инструменты Rspress. Хук [`useWebMcp`](/rspress-russian/ui/hooks/use-web-mcp.md) по-прежнему доступен для регистрации собственных инструментов.

## Встроенные инструменты

| Инструмент         | Назначение                                                                                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `get_site_info`    | Метаданные сайта, локали, версии, навигация и активная боковая панель.                                                                                             |
| `list_pages`       | Фильтрация и постраничный вывод метаданных страниц; по умолчанию используются активный язык и версия. Работает независимо от поиска.                               |
| `get_page`         | Чтение метаданных, frontmatter, оглавления и Markdown для известного маршрута без перехода (включается вместе с [SSG-MD](/rspress-russian/guide/basic/ssg-md.md)). |
| `get_current_page` | Чтение метаданных, frontmatter, оглавления и Markdown для текущей страницы (включается вместе с [SSG-MD](/rspress-russian/guide/basic/ssg-md.md)).                 |
| `search_docs`      | Поиск по локальному индексу документации для активного языка и версии (только локальный поиск стандартной темы).                                                   |
| `navigate`         | Переход к известному внутреннему маршруту с последующим возвратом метаданных страницы, маршрутов разделов и ссылок на предыдущую и следующую страницы.             |


Схемы входных данных инструментов

Источник: [e2e/fixtures/webmcp/toolInputSchemas.json](https://github.com/web-infra-dev/rspress/blob/main/e2e/fixtures/webmcp/toolInputSchemas.json)
```json title="toolInputSchemas.json"
{
  "get_current_page": {
    "type": "object",
    "properties": {},
    "required": [],
    "additionalProperties": false
  },
  "get_page": {
    "type": "object",
    "properties": {
      "routePath": {
        "type": "string",
        "minLength": 1
      }
    },
    "required": ["routePath"],
    "additionalProperties": false
  },
  "get_site_info": {
    "type": "object",
    "properties": {},
    "required": [],
    "additionalProperties": false
  },
  "list_pages": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1
      },
      "lang": {
        "type": "string"
      },
      "version": {
        "type": "string"
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100
      },
      "offset": {
        "type": "integer",
        "minimum": 0
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "navigate": {
    "type": "object",
    "properties": {
      "routePath": {
        "type": "string",
        "minLength": 1
      }
    },
    "required": ["routePath"],
    "additionalProperties": false
  },
  "search_docs": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 1
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20
      }
    },
    "required": ["query"],
    "additionalProperties": false
  }
}
```

## Кросс-доменные агенты

Используйте [`webMcp.exposedTo`](/rspress-russian/api/config/config-agent.md#webmcp), чтобы разрешить определённым безопасным источникам обнаруживать инструменты.

## Собственные инструменты

Используйте [`useWebMcp`](/rspress-russian/ui/hooks/use-web-mcp.md) из `@rspress/core/runtime`, чтобы регистрировать инструменты в собственных компонентах. Инструменты автоматически удаляются при размонтировании компонента.
