Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 92 additions & 0 deletions docs/ai/hexlet-mcp.md
Original file line number Diff line number Diff line change
@@ -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 Хекслета.
:::
Binary file added static/img/docs/img-219--hexlet-mcp-consent.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading