# Довідка у вашому ШІ (MCP)

У довідки Watbot є MCP-сервер. Підключіть його до свого ШІ-помічника — Claude, ChatGPT, Cursor або іншого, що підтримує протокол MCP, — і помічник відповідатиме на запитання про Watbot за актуальною довідкою та даватиме посилання на її сторінки. Наприклад, розробник у редакторі коду запитає, як викликати метод API, і не шукатиме відповідь у браузері.

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

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

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

> [!TIP]
> Запитати ШІ про довідку можна й без налаштування: кнопка «Запитати ШІ» в шапці довідки відкриває [ШІ-чат](https://support.watbot.org/uk/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.org/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.org/mcp"
    }
  }
}
```

### VS Code

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

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

### Інші помічники

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

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

## Перевірити підключення

Запитайте помічника: «Як запустити розсилку за днями тижня? Знайди відповідь у довідці». Він має викликати `search_docs` і відповісти з посиланням на сторінку довідки про розсилки.

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

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

## Обмеження

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