# Справка в вашем ИИ (MCP)

У справки Watbot есть MCP-сервер. Подключите его к своему ИИ-помощнику — Claude, ChatGPT, Cursor или другому, который поддерживает протокол MCP, — и помощник будет отвечать на вопросы о Watbot по актуальной справке и давать ссылки на её страницы. Например, разработчик в редакторе кода спросит, как вызвать метод API, и не будет искать ответ в браузере.

Адрес сервера:

```
https://support.watbot.ru/mcp
```

- Ключ API и тариф Pro не нужны: сервер открытый, как и сама справка.
- Сервер знает только страницы справки. Ваш аккаунт, боты и контакты ему не видны — для работы с ними есть [API](https://support.watbot.ru/api).
- Транспорт — Streamable HTTP, без авторизации.

> [!TIP]
> Спросить ИИ о справке можно и без настройки: кнопка «Спросить ИИ» в шапке справки открывает [ИИ-чат](https://support.watbot.ru/ai/chat) в кабинете с вопросом в поле ввода. Отправьте его — модель поищет ответ в этой же справке.

## Что умеет сервер

| Инструмент | Что делает |
|---|---|
| `search_docs` | Ищет в справке по смыслу запроса и возвращает подходящие разделы со ссылками |
| `get_page` | Отдаёт полный текст страницы по её адресу — со ссылками на разделы и вложенные страницы |
| `list_pages` | Показывает оглавление справки или одного её раздела |

Справка есть на нескольких языках. Помощник выбирает язык параметром `locale`; если не выбрал — отвечает основной язык адреса сервера.

## Подключение

Названия пунктов меню у сервисов со временем меняются. Если не нашли нужный — ищите в справке сервиса «custom MCP connector» или «remote MCP server».

### Claude

В Claude на сайте или в приложении для компьютера откройте **Settings → Connectors** и нажмите **Add custom connector**. Название — любое, например «Справка», адрес — адрес сервера выше. Затем включите коннектор в меню инструментов под полем ввода.

### Claude Code

```bash
claude mcp add --transport http help https://support.watbot.ru/mcp
```

### ChatGPT

Свои MCP-серверы ChatGPT подключает в режиме разработчика: **Settings → Apps → Advanced settings → Developer mode**. После этого создайте приложение: адрес сервера выше, аутентификация — **No Auth**. Режим разработчика есть не на всех тарифах ChatGPT.

### Cursor

Добавьте сервер в `.cursor/mcp.json` в папке проекта или в `~/.cursor/mcp.json` — тогда он будет во всех проектах:

```json
{
  "mcpServers": {
    "help": {
      "url": "https://support.watbot.ru/mcp"
    }
  }
}
```

### VS Code

Для режима агента GitHub Copilot — файл `.vscode/mcp.json` в папке проекта:

```json
{
  "servers": {
    "help": {
      "type": "http",
      "url": "https://support.watbot.ru/mcp"
    }
  }
}
```

### Другие помощники

Подойдёт любой клиент, который подключает удалённые MCP-серверы по HTTP: укажите адрес сервера, авторизация не нужна. Если клиент умеет запускать только локальные серверы, подключите справку через посредника `mcp-remote` (нужен Node.js):

```json
{
  "mcpServers": {
    "help": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://support.watbot.ru/mcp"]
    }
  }
}
```

## Проверить подключение

Спросите помощника: «Как запустить рассылку по дням недели? Найди ответ в справке». Он должен вызвать `search_docs` и ответить со ссылкой на страницу справки о рассылках.

## Без подключения

- **Одна страница.** Кнопка «Скопировать» у заголовка любой страницы копирует её текст в markdown — его можно вставить в любой чат с ИИ. Стрелка рядом с кнопкой сразу открывает ChatGPT и Claude с вопросом по странице.
- **Текст страницы** — тот же адрес с `.md` на конце, у главной — `/index.md`. Без оформления, меню и скриптов: так странице проще передать ИИ.
- **Оглавление для ИИ** — `/llms.txt` в корне справки: все страницы со ссылками на их текст в markdown.

## Ограничения

- **Частота** — 60 запросов в минуту с одного IP-адреса. Сверх лимита сервер отвечает кодом `429`, помощник может повторить запрос через минуту.
- **Поиск по смыслу** ограничен отдельно. При большом числе запросов сервер ищет только по словам: результаты остаются, но подбираются грубее.