# Подключение 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_КЛЮЧ` — заполнитель. Замените его полным значением своего ключа. Создавайте отдельный ключ для каждого агента, чтобы различать подключения.

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

<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. Создайте или откройте `~/.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 запросит разрешение на вызов инструмента.

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

<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>`404 / Not Found`</td><td>Используйте адрес `/mcp`, а не `/user-profile/mcp`.</td></tr><tr><td>JSON не сохраняется или сервер не появляется</td><td>Проверьте запятые и скобки; запись должна находиться внутри `mcpServers`. Перезапустите Cursor.</td></tr><tr><td>Сервер сохранён, но вызов инструмента не проходит</td><td>Откройте **Output → MCP Logs**, проверьте статус сервера и права владельца ключа в Scrolltool.</td></tr></tbody></table>

## Источники

- [Cursor — MCP integrations: конфигурация и управление серверами](https://prod.cursor.com/help/customization/mcp).
- [Cursor — Model Context Protocol: заголовки и переменные окружения](https://prod.cursor.com/docs/mcp).

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