# MCP-эндпоинт хэлпцентра

Как подключить справочный центр Plaia как MCP-сервер к AI-ассистенту: URL, авторизация, инструменты.

## Что это

Справочный центр опубликован как **MCP-сервер** (Model Context Protocol, Streamable HTTP): AI-ассистенты — Claude, ZCode и совместимые клиенты — могут отвечать на вопросы о платформе по официальной документации.

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

```text
URL:         https://help.mcp.plaia.ru/mcp
Транспорт:   Streamable HTTP (JSON-RPC POST)
Авторизация: Basic Auth (логин и пароль выдаёт администратор)
```

Пример конфигурации клиента:

```json
{
  "mcpServers": {
    "plaia-help": {
      "url": "https://help.mcp.plaia.ru/mcp",
      "headers": {
        "Authorization": "Basic <base64(login:password)>"
      }
    }
  }
}
```

## Инструменты

| Инструмент | Назначение |
| --- | --- |
| `search_help` | Поиск по всем статьям справки |
| `list_categories` | Разделы справки |
| `list_articles` | Статьи раздела или все |
| `get_article` | Полный текст статьи (Markdown) |
| `get_api_reference` | Справочник методов API платформы |
| `get_support_info` | Контакты поддержки |

Ресурсы: `help://article/{slug}`, `help://category/{id}`.

## Для кого это полезно

- **Поддержка и PM** — ассистент мгновенно находит нужную статью и ссылку.
- **Разработчики** — ассистент отвечает по API-справочнику с путями методов.
- **Новые сотрудники** — «как сделать X» по официальной документации.

## Альтернативы без MCP

- [llms.txt](/llms.txt) и [llms-full.txt](/llms-full.txt) — для LLM-краулеров.
- Markdown каждой статьи: `/md/{slug}.md` (см. [Справка для AI-ассистентов](/help-for-ai)).

Логин/пароль Basic Auth для /mcp — у администратора платформы.