# Подключение MCP Scrolltool к ChatGPT и Codex

MCP подключает ИИ-агента к Scrolltool: агент получает доступ к папкам, курсам и тренажёрам и может создавать новые курсы. Доступ ограничен выбранной командой Scrolltool и правами владельца ключа.

Для персонального ключа Scrolltool используйте приложение с локальными настройками MCP или клиент Codex. Веб-версия ChatGPT использует отдельную форму, у которой есть ограничения авторизации.

## Создайте ключ в Scrolltool

1. Войдите в Scrolltool и выберите команду, с которой должен работать агент.
2. Откройте **Профиль → MCP** или перейдите на [страницу MCP в профиле](https://go.scroll-tool.ru/user-profile/mcp).
3. Задайте понятное имя ключа, например «Codex — рабочий компьютер», и нажмите **Создать ключ**.

[![Страница MCP в профиле Scrolltool](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/01-scroll-production-form.png)](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/01-scroll-production-form.png)

*На странице MCP создают персональный ключ подключения.*

4. Скопируйте ключ целиком, включая число и символ `|` в начале. Сохраните его в менеджере паролей: полное значение показывается только при создании.
5. После сохранения нажмите **Я сохранил ключ, скрыть**.

[![Сохранённый ключ в списке Scrolltool](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/04-scroll-key-created.png)](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/04-scroll-key-created.png)

*Ключ в списке после скрытия значения. Данные команды на снимке закрыты.*

В примерах ниже `ВАШ_MCP_КЛЮЧ` — заполнитель. Замените его полным значением своего ключа. Создавайте отдельный ключ для каждого агента, чтобы различать подключения.

## Параметры подключения

<table id="bkmrk-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80-%D0%97%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%90%D0%B4"><thead><tr><th>Параметр</th><th>Значение</th></tr></thead><tbody><tr><td>Адрес MCP-сервера</td><td>`https://go.scroll-tool.ru/mcp`</td></tr><tr><td>Транспорт</td><td>Streamable HTTP</td></tr><tr><td>HTTP-заголовок</td><td>`Authorization`</td></tr><tr><td>Значение заголовка</td><td>`Bearer ВАШ_MCP_КЛЮЧ`</td></tr></tbody></table>

Между `Bearer` и ключом нужен пробел. Адрес `/user-profile/mcp` открывает настройки профиля; в агенте указывают адрес `/mcp`.

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

### Через настройки приложения

1. Откройте **Settings → MCP servers → Add server**.
2. Введите имя `scrolltool_production` и выберите **Streamable HTTP**.
3. Укажите URL `https://go.scroll-tool.ru/mcp`.
4. В HTTP-заголовках добавьте `Authorization` со значением `Bearer ВАШ_MCP_КЛЮЧ`.
5. Сохраните настройки и нажмите **Restart** или перезапустите клиент.

### Через файл конфигурации Codex

Откройте `~/.codex/config.toml` и добавьте запись:

```toml
[mcp_servers.scrolltool_production]
url = "https://go.scroll-tool.ru/mcp"

[mcp_servers.scrolltool_production.http_headers]
Authorization = "Bearer ВАШ_MCP_КЛЮЧ"

```

Сохраните остальные разделы файла. В Windows стандартный путь — `%USERPROFILE%\.codex\config.toml`. Символ `~` обозначает домашнюю папку пользователя.

Перезапустите клиент и откройте новый чат. Локальные клиенты Codex используют конфигурацию одного хоста; подключение в веб-версии ChatGPT настраивается отдельно.

## Что учитывать в ChatGPT в браузере

Путь к форме: **Plugins («Плагины») → Добавить → Добавить пользовательский сервер MCP**.

[![Меню добавления пользовательского MCP в ChatGPT](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/02-chatgpt-add-menu.png)](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/02-chatgpt-add-menu.png)

*Открытие формы пользовательского MCP-сервера в ChatGPT.*

[![Способы аутентификации в ChatGPT](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/03-chatgpt-auth-options.png)](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/03-chatgpt-auth-options.png)

*Форма с вариантами OAuth, «Без аутентификации» и смешанным режимом.*

Если форма предлагает только эти варианты и не содержит HTTP-заголовков, передать персональный ключ Scrolltool через неё нельзя. **Без аутентификации** не отправляет ключ, а **OAuth Client Secret** не заменяет MCP-ключ. В этом случае используйте локальное подключение Codex, описанное выше.

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

Отправьте агенту запрос:

```text
Используй MCP Scrolltool scrolltool_production.
Вызови list_folders и покажи названия доступных папок.
Ничего не создавай и не изменяй.

```

Подключение работает, если агент вызвал `list_folders` нужного сервера и получил ответ Scrolltool. Пустой список допустим, если в аккаунте нет доступных папок. Текстовый ответ без вызова инструмента не подтверждает подключение.

## Если подключение не работает

<table id="bkmrk-%D0%9F%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%D0%B0-%D0%A7%D1%82%D0%BE-%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%B8"><thead><tr><th>Проблема</th><th>Что проверить</th></tr></thead><tbody><tr><td>`401 / Unauthorized`</td><td>Полный ключ с началом `id|`, имя заголовка `Authorization`, префикс `Bearer` и пробел.</td></tr><tr><td>`403 / Forbidden` или нужного курса нет</td><td>Выбранную команду Scrolltool и права владельца ключа.</td></tr><tr><td>`404 / Not Found`</td><td>В клиенте должен быть адрес `/mcp`, а не `/user-profile/mcp`.</td></tr><tr><td>Настройки сохранены, но инструментов нет</td><td>Перезапустите клиент, проверьте статус сервера и выберите `scrolltool_production` в новом чате.</td></tr></tbody></table>

## Источники

- [OpenAI — Model Context Protocol: настройки MCP и HTTP-заголовки](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).
- [OpenAI — Add custom MCP server: веб-форма ChatGPT](https://developers.openai.com/api/docs/guides/custom-mcp-server).

*Обновлено 29 октября 2026 года. Названия пунктов могут зависеть от языка и версии клиента.*