diff --git a/docs/ai/hexlet-mcp.md b/docs/ai/hexlet-mcp.md new file mode 100644 index 00000000..3ca9e696 --- /dev/null +++ b/docs/ai/hexlet-mcp.md @@ -0,0 +1,92 @@ +--- +title: "Как подключить MCP Хекслета" +--- + +[Перейти на сайт](https://ru.hexlet.io) + +# Как подключить MCP Хекслета + +> Как подключить Хекслет и его справку к ассистенту вроде Claude, чтобы он отвечал по вашему обучению и каталогу программ. + +MCP это способ дать ассистенту на основе ИИ доступ к внешнему сервису. У Хекслета два MCP-сервера. Первый работает с вашим аккаунтом, через него ассистент находит программы в каталоге и отвечает по вашему обучению. Второй ищет ответы в этой справке. + +Способ подключения одинаковый для учащихся, наставников и сотрудников. Разница только в том, какие инструменты получит ассистент после входа. + +## MCP Хекслета + +Адрес сервера `https://mcp.hexlet.io`, он один для всех языковых версий сайта. Вы входите под своим аккаунтом Хекслета в браузере и подтверждаете доступ на экране согласия, поэтому токен или ключ вписывать никуда не нужно. + +![Экран согласия Хекслета. Приложение Claude Code просит доступ к аккаунту, ниже перечислено, что оно сможет делать, и кнопки Authorize и Deny](/img/docs/img-219--hexlet-mcp-consent.png) + +### claude.ai и Claude Desktop + +1. Откройте Settings → Connectors и нажмите Add custom connector. +2. Введите имя `Hexlet` и адрес `https://mcp.hexlet.io`. +3. Нажмите Connect, войдите в Хекслет и подтвердите доступ. + +{/* скрин: окно Add custom connector в claude.ai с заполненными именем и адресом */} + +Коннектор, подключённый в claude.ai, сам появится в Claude Code, если вы вошли в него под тем же аккаунтом Claude. + +{/* Клиенты ниже ждут проверки на живом клиенте (SUPPORT-100). Открыть после проверки. Claude Code через claude mcp add не входит, Хекслет отклоняет redirect_uri на localhost с портом. + +### Claude Code + +Добавьте сервер командой в терминале. + +```bash +claude mcp add --transport http hexlet https://mcp.hexlet.io +``` + +Затем запустите Claude Code, выполните в сессии команду `/mcp`, выберите `hexlet` и войдите в Хекслет в открывшемся браузере. + +### ChatGPT + +1. Откройте в ChatGPT раздел Plugins, нажмите кнопку с плюсом и выберите Add custom MCP server. +2. Введите имя `Hexlet`, адрес `https://mcp.hexlet.io` и выберите вход через OAuth. +3. Подтвердите предупреждение о стороннем сервере и нажмите Create. +4. Войдите в Хекслет в открывшемся браузере и подтвердите доступ. + +### Codex CLI + +Добавьте сервер и войдите в Хекслет двумя командами в терминале. + +```bash +codex mcp add hexlet --url https://mcp.hexlet.io +codex mcp login hexlet +``` + +Первая команда записывает сервер в конфиг Codex. Вторая открывает в браузере страницу входа в Хекслет, где нужно подтвердить доступ. + +*/} + +### OpenCode + +Инструкция написана для OpenCode второй версии. Выполните две команды в каталоге проекта. + +```bash +opencode mcp add hexlet --url https://mcp.hexlet.io +opencode mcp auth hexlet +``` + +Первая команда записывает сервер в `opencode.json` проекта. OpenCode читает этот файл, только когда каталог проекта находится под git. В каталоге без репозитория сервер в списке не появится, поэтому там добавьте к первой команде флаг `--global`, и сервер попадёт в общий конфиг, доступный во всех проектах. + +Вторая команда открывает в браузере страницу входа в Хекслет, где нужно подтвердить доступ. Команда `opencode mcp list` показывает состояние серверов, у подключённого стоит `connected`. + +### Проверка подключения + +Попросите ассистента вызвать инструмент `get_me`. Если подключение работает, он ответит данными вашего аккаунта Хекслета. + +### Что умеет ассистент после подключения + +Набор инструментов зависит от аккаунта. Каталог программ доступен любому вошедшему. Учащийся дополнительно получает инструменты по своему обучению, наставник по своим группам, сотрудник по своим правам на платформе. Сотрудник видит записи только тех языковых версий, с которыми работает. + +Список инструментов меняется, поэтому проще спросить у самого ассистента, что он может сделать через MCP Хекслета. Он перечислит то, что доступно вашему аккаунту. + +## MCP справки + +Справку подключают отдельным сервером по адресу `https://help.hexlet.io/mcp` тем же способом, что и MCP Хекслета. Входить в аккаунт для неё не нужно. После подключения ассистент ищет ответы на вопросы об обучении и платформе в статьях этой справки. + +:::note[Другие ассистенты] +Подключение проверено в клиентах из этой статьи. Cursor, Gemini и другие ассистенты могут не подключиться к MCP Хекслета. +::: diff --git a/static/img/docs/img-219--hexlet-mcp-consent.png b/static/img/docs/img-219--hexlet-mcp-consent.png new file mode 100644 index 00000000..32b027b6 Binary files /dev/null and b/static/img/docs/img-219--hexlet-mcp-consent.png differ