# MCP-сервер Scrolltool Подключение ИИ-агентов к Scrolltool через MCP: получение ключа, настройка ChatGPT/Codex, Claude и Cursor, проверка подключения. # Подключение 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_КЛЮЧ` — заполнитель. Замените его полным значением своего ключа. Создавайте отдельный ключ для каждого агента, чтобы различать подключения. ## Параметры подключения
ПараметрЗначение
Адрес MCP-сервера`https://go.scroll-tool.ru/mcp`
ТранспортStreamable HTTP
HTTP-заголовок`Authorization`
Значение заголовка`Bearer ВАШ_MCP_КЛЮЧ`
Между `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. Пустой список допустим, если в аккаунте нет доступных папок. Текстовый ответ без вызова инструмента не подтверждает подключение. ## Если подключение не работает
ПроблемаЧто проверить
`401 / Unauthorized`Полный ключ с началом `id|`, имя заголовка `Authorization`, префикс `Bearer` и пробел.
`403 / Forbidden` или нужного курса нетВыбранную команду Scrolltool и права владельца ключа.
`404 / Not Found`В клиенте должен быть адрес `/mcp`, а не `/user-profile/mcp`.
Настройки сохранены, но инструментов нетПерезапустите клиент, проверьте статус сервера и выберите `scrolltool_production` в новом чате.
## Источники - [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 года. Названия пунктов могут зависеть от языка и версии клиента.* # Подключение MCP Scrolltool к Claude MCP подключает ИИ-агента к Scrolltool: агент получает доступ к папкам, курсам и тренажёрам и может создавать новые курсы. Доступ ограничен выбранной командой Scrolltool и правами владельца ключа. В Claude есть два пути подключения: команда в **Claude Code** и пользовательский коннектор в браузере или Claude Desktop. Для коннектора с персональным ключом нужен доступ к функции **Request headers**. ## Создайте ключ в Scrolltool 1. Войдите в Scrolltool и выберите команду, с которой должен работать агент. 2. Откройте **Профиль → MCP** или перейдите на [страницу MCP в профиле](https://go.scroll-tool.ru/user-profile/mcp). 3. Задайте понятное имя ключа, например «Claude — рабочий компьютер», и нажмите **Создать ключ**. [![Страница 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_КЛЮЧ` — заполнитель. Замените его полным значением своего ключа. Создавайте отдельный ключ для каждого агента, чтобы различать подключения. ## Параметры подключения
ПараметрЗначение
Адрес MCP-сервера`https://go.scroll-tool.ru/mcp`
ТранспортStreamable HTTP
HTTP-заголовок`Authorization`
Значение заголовка`Bearer ВАШ_MCP_КЛЮЧ`
Между `Bearer` и ключом нужен пробел. Адрес `/user-profile/mcp` открывает настройки профиля; в агенте указывают адрес `/mcp`. ## Подключите через Claude Code Для этого способа нужен установленный Claude Code. 1. При создании ключа Scrolltool можно скопировать готовую команду из блока **Claude Code — выполнить в терминале**. Либо замените заполнитель в примере ниже и выполните команду одной строкой: ```bash claude mcp add --transport http --scope user scrolltool_production https://go.scroll-tool.ru/mcp --header "Authorization: Bearer ВАШ_MCP_КЛЮЧ" ``` Параметр `--scope user` сохраняет подключение для ваших проектов. Если имя `scrolltool_production` уже занято, выберите другое и укажите его в запросе проверки. 2. Проверьте регистрацию сервера: ```bash claude mcp list claude mcp get scrolltool_production ``` 3. В Claude Code выполните `/mcp`. Проверьте статус **Connected** и наличие инструментов Scrolltool. Сообщение **Added** означает сохранение настроек. Успешное соединение подтверждают статус **Connected** и вызов инструмента. Команда с вашим ключом даёт доступ к аккаунту — не публикуйте её в общедоступных логах или снимках. ## Подключите коннектор в браузере или Claude Desktop Этот способ доступен, если в форме есть **Request headers**. Функция находится в beta и доступна ограниченному числу организаций. 1. Откройте **Customize → Connectors → Add → Add custom connector**. [![Меню добавления коннектора Claude](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/06-claude-add-menu.png)](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/06-claude-add-menu.png) *Добавление пользовательского коннектора в Claude.* 2. Введите **Name**: `Scrolltool` и **MCP server URL**: `https://go.scroll-tool.ru/mcp`. Нажмите **Continue**. [![Название и URL Scrolltool в форме Claude](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/07-claude-name-url.png)](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/07-claude-name-url.png) *Первый шаг формы: название подключения и адрес MCP-сервера.* 3. На шаге **Authentication** выберите **No sign-in**. В **Request headers** добавьте `Authorization` со значением `Bearer ВАШ_MCP_КЛЮЧ`. Нажмите **Add**. 4. В новом чате откройте **+ → Connectors** и включите Scrolltool. Если **Request headers** отсутствует, одного **No sign-in** недостаточно: ключ не будет передан. Используйте Claude Code. Не вводите MCP-ключ в поля **OAuth Client ID** или **Client Secret**. На Team и Enterprise коннектор сначала добавляет владелец через **Organization settings → Connectors → Add → Custom → Web**, затем подключается участник. ## Проверьте подключение Отправьте агенту запрос: ```text Используй MCP Scrolltool scrolltool_production. Вызови list_folders и покажи названия доступных папок. Ничего не создавай и не изменяй. ``` Подключение работает, если агент вызвал `list_folders` нужного сервера и получил ответ Scrolltool. Пустой список допустим, если в аккаунте нет доступных папок. Текстовый ответ без вызова инструмента не подтверждает подключение. Для коннектора в браузере вместо имени сервера можно указать в запросе название **Scrolltool**, выбранное при добавлении. ## Если подключение не работает
ПроблемаЧто проверить
`401 / Unauthorized`Скопируйте ключ целиком с началом `id|`. В значении `Authorization` должны быть `Bearer`, пробел и ключ.
`404 / Not Found`Используйте `https://go.scroll-tool.ru/mcp`.
Claude Code показывает **Added**, но соединения нетВыполните `/mcp`, проверьте статус сервера и затем вызов `list_folders`.
В форме нет **Request headers**Подключите сервер через Claude Code; режим **No sign-in** без заголовка не передаёт ключ.
## Источники - [Claude — Add a connector that isn’t in the directory: Request headers и ограничения](https://claude.com/docs/connectors/custom/add-unlisted). - [Anthropic — Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). - [Claude Code — Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp). *Обновлено 29 октября 2026 года. Названия пунктов могут зависеть от языка, версии клиента и прав аккаунта.* # Подключение MCP Scrolltool к Cursor MCP подключает ИИ-агента к Scrolltool: агент получает доступ к папкам, курсам и тренажёрам и может создавать новые курсы. Доступ ограничен выбранной командой Scrolltool и правами владельца ключа. В Cursor можно добавить сервер через файл `mcp.json`. Если в вашем веб-кабинете есть форма **Add MCP**, доступно и подключение через неё. ## Создайте ключ в Scrolltool 1. Войдите в Scrolltool и выберите команду, с которой должен работать агент. 2. Откройте **Профиль → MCP** или перейдите на [страницу MCP в профиле](https://go.scroll-tool.ru/user-profile/mcp). 3. Задайте понятное имя ключа, например «Cursor — рабочий компьютер», и нажмите **Создать ключ**. [![Страница 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_КЛЮЧ` — заполнитель. Замените его полным значением своего ключа. Создавайте отдельный ключ для каждого агента, чтобы различать подключения. ## Параметры подключения
ПараметрЗначение
Адрес MCP-сервера`https://go.scroll-tool.ru/mcp`
ТранспортStreamable HTTP
HTTP-заголовок`Authorization`
Значение заголовка`Bearer ВАШ_MCP_КЛЮЧ`
Между `Bearer` и ключом нужен пробел. Адрес `/user-profile/mcp` открывает настройки профиля; в агенте указывают адрес `/mcp`. ## Подключите через файл конфигурации 1. Создайте или откройте `~/.cursor/mcp.json` — персональную конфигурацию для всех проектов. В Windows стандартный путь — `%USERPROFILE%\.cursor\mcp.json`. 2. Добавьте конфигурацию и замените заполнитель полным ключом: ```json { "mcpServers": { "scrolltool_production": { "url": "https://go.scroll-tool.ru/mcp", "headers": { "Authorization": "Bearer ВАШ_MCP_КЛЮЧ" } } } } ``` Если `mcpServers` уже существует, добавьте запись внутрь него, сохранив остальные серверы. Готовый JSON также можно скопировать со страницы создания ключа Scrolltool. 3. Сохраните файл и перезапустите Cursor. 4. Откройте **Customize → MCPs**, включите Scrolltool и проверьте список инструментов. Для одного проекта используется файл `.cursor/mcp.json` в его папке. Одноимённая запись проекта имеет приоритет над глобальной. Ключ в таком примере хранится в файле конфигурации. Не добавляйте файл с ключом в публичный репозиторий. При необходимости используйте значение `Bearer ${env:SCROLLTOOL_TOKEN}` в `headers`: переменная должна быть доступна процессу Cursor. `envFile` для удалённых HTTP/SSE-серверов не поддерживается. ## Подключите через форму Add MCP Если веб-кабинет показывает управление MCP-серверами: 1. Откройте **Integrations**. В строке **Find MCP servers in Plugins** перейдите по ссылке **Plugins**, затем нажмите **Add MCP**. [![Страница MCP в веб-кабинете Cursor](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/09-cursor-mcp-list.png)](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/09-cursor-mcp-list.png) *Управление MCP-серверами: кнопки Edit mcp.json и Add MCP.* 2. Заполните **Name**: `scrolltool_production`; **Transport**: `HTTP`; **URL**: `https://go.scroll-tool.ru/mcp`. 3. В **HTTP headers** нажмите **Add header**. Введите **Key**: `Authorization`; **Value**: `Bearer ВАШ_MCP_КЛЮЧ`, заменив заполнитель своим ключом. [![Форма подключения Scrolltool в Cursor](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/10-cursor-add-server.png)](https://wiki.scroll-tool.ru/uploads/images/gallery/2026-10/10-cursor-add-server.png) *В примере показаны параметры Scrolltool и заполнитель вместо реального ключа.* 4. Поля **OAuth client ID** и **OAuth client secret** оставьте пустыми. Нажмите **Add server**. 5. Проверьте вызов инструмента в том агенте Cursor, где будете использовать подключение. Если сервер там не появился, настройте локальный файл `mcp.json` по шагам выше. ## Проверьте подключение Отправьте агенту запрос: ```text Используй MCP Scrolltool scrolltool_production. Вызови list_folders и покажи названия доступных папок. Ничего не создавай и не изменяй. ``` Подключение работает, если агент вызвал `list_folders` нужного сервера и получил ответ Scrolltool. Пустой список допустим, если в аккаунте нет доступных папок. Текстовый ответ без вызова инструмента не подтверждает подключение. В режиме **Agent** подтвердите чтение папок, если Cursor запросит разрешение на вызов инструмента. ## Если подключение не работает
ПроблемаЧто проверить
`401 / Unauthorized`Полный ключ с началом `id|`, заголовок `Authorization`, префикс `Bearer` и пробел.
`404 / Not Found`Используйте адрес `/mcp`, а не `/user-profile/mcp`.
JSON не сохраняется или сервер не появляетсяПроверьте запятые и скобки; запись должна находиться внутри `mcpServers`. Перезапустите Cursor.
Сервер сохранён, но вызов инструмента не проходитОткройте **Output → MCP Logs**, проверьте статус сервера и права владельца ключа в Scrolltool.
## Источники - [Cursor — MCP integrations: конфигурация и управление серверами](https://prod.cursor.com/help/customization/mcp). - [Cursor — Model Context Protocol: заголовки и переменные окружения](https://prod.cursor.com/docs/mcp). *Обновлено 29 октября 2026 года. Названия пунктов могут зависеть от языка и версии клиента.*