Cursor + MCP для 1С: работающая инструкция с картинками

22 сентября мы опубликовали статью «Cursor + MCP: собираем идеальное рабочее место 1С-разработчика за 15 минут». По состоянию на 24 сентября у неё было 6163 просмотра, 6 плюсов и 7 минусов. Критика в комментариях была по делу. Мы сверили статью с документацией расширений и с живой установкой и нашли в ней ошибки, в том числе в главном тезисе: MCP-сервер Platform Tools не передаёт агенту объектную модель конфигурации.

Эта статья - продолжение той и первая часть новой серии. В ней мы заново проходим установку и исправляем найденные ошибки. Дальше «первая статья» - это 2795749, а «часть 1» - эта. Каждый шаг ниже пройден на реальном стенде 24–25.09.26. Снимки экрана сделаны на этом стенде; где снимка нет, приведён текст интерфейса. В конце таблица: что было написано в первой статье и как на самом деле.

Всё, что нужно для повторения, приведено прямо в статье: packagedef (шаг 3), .cursor/mcp.json и шаблон этого файла для git (шаг 6), скрипт проверки MCP-сервера без Cursor (шаг 7). Демо-конфигурацию Нано-УТ мы не выкладываем: для шагов этой части подойдёт выгрузка в XML любой Вашей конфигурации.

Что MCP-сервер Platform Tools делает на самом деле

Сначала о главном, потому что от этого зависят ожидания.

«1C: Platform Tools» - расширение для VS Code и совместимых редакторов (Cursor, Windsurf, VSCodium). «1C: Platform Tools MCP» - второе расширение, которое публикует команды первого как инструменты MCP для ИИ-агента. Оба расширения - community-проект организации yellow-hammer на GitHub под лицензией MIT. Фирма «1С» к ним отношения не имеет.

По документации MCP-сервер даёт агенту «доступ к командам расширения: тесты, профили запуска, сборка и загрузка конфигурации… работа с базой». Это пульт управления: создать базу из исходников, загрузить или выгрузить cf/cfe, собрать epf, запустить тесты, проверить синтаксис, поднять OData, запустить пайплайн.

Инструментов для чтения метаданных (реквизиты, табличные части, структура объектов) в MCP нет. Это сделано намеренно: в исходном коде расширения (src/shared/mcpCommandPolicy.ts) команды группы metadata.* перечислены в HIDDEN_PREFIXES, то есть не публикуются как MCP-инструменты. Дерево метаданных в расширении есть, но только в интерфейсе редактора, для человека. Как агенту всё-таки получить метаданные, разберём отдельно.

Рис. 1. Кто с кем связан. Агент говорит с MCP-сервером через stdio, сервер с расширением - по TCP на localhost (с токеном, если он задан, см. шаг 6). Метаданные (реквизиты, табличные части) агент берёт из XML-файлов проекта сам: команды metadata.* в MCP не публикуются.

Шаг 1. Открыть редактор в Cursor 3.x

Cursor 3.x после запуска показывает окно агентов, а не привычный редактор с деревом файлов. Редактор открывается кнопкой IDE в правом верхнем углу. Все дальнейшие шаги выполняются в нём.

Шаг 2. Поставить расширения и обновить их

В Cursor расширения ставятся из Open VSX (в VS Code - из VS Marketplace; без доступа к маркетплейсу можно поставить файл .vsix из релизов на GitHub). В поиске расширений найдите и установите оба:

• 1C: Platform Tools;
• 1C: Platform Tools MCP.

Издатель обоих - yellow-hammer.

У нас сначала установились версии 0.9.5 и 0.2.3, хотя на GitHub уже вышли 0.9.6 и 0.3.0. Через пару минут Cursor сам обновил их до 0.9.6 и 0.3.0. Поэтому после установки откройте карточку каждого расширения и проверьте версию. Если она отстаёт от последнего релиза на GitHub, обновите расширение.

Рис. 2. Панель Extensions: 1 установленное расширение «1C: Platform Tools» от yellow-hammer, 2 поле Version в карточке - 0.9.6. Сверьте с последним релизом на GitHub.

Рис. 3. 1 «1C: Platform Tools MCP», 2 версия 0.3.0. В описании расширения прямо написано, что Cursor добавляет новый сервер выключенным. Об этом шаг 7.

Шаг 3. Инициализировать проект (packagedef)

Откройте каталог проекта (File → Open Folder). Пока в нём нет файла packagedef, расширение работает в урезанном режиме: видны только панели «1С: Проекты» и «1С: Администрирование». Это нормально. Расширение активируется, когда в рабочей области есть каталог с файлом packagedef.

Писать packagedef руками не нужно. Панель «1С: Проекты» открывает страницу «Начало работы с 1C: Platform Tools» с кнопками:

• Открыть проект;
• Создать проект;
• Инициализировать текущий;
• Инициализировать структуру.

Нажмите Инициализировать текущий. Та же операция есть в палитре команд («1С: Зависимости: Инициализировать проект») и в MCP (инструменты project_init и deps_initPackagedef).

У нас получился такой packagedef:

1
2
3
4
5
6
7
8
9

Описание.Имя("project-1с")
    .Версия("1.0.0")
    .ВерсияСреды("2.0.0")
    .ЗависитОт("add")
    .ЗависитОт("vanessa-automation-single")
    .ЗависитОт("vanessa-runner", "3.0.0")
    .РазработкаЗависитОт("1testrunner")
    .РазработкаЗависитОт("oneunit")
;

Две вещи, которые в первой статье были описаны неверно:

• packagedef - это файл проекта и зависимостей менеджера пакетов OneScript (opm). Это не «стандартный способ описания проекта 1С», и 1С:EDT на него не ориентируется: у EDT свой формат проекта, а расширение переводит EDT-проект в XML отдельной командой.
• .ВерсияСреды("2.0.0") - минимальная версия движка OneScript, а не версия платформы 1С:Предприятие.

Заодно расширение создало каталог build/ и само скачало portable JRE 21 и md-sparrow, которые нужны для дерева метаданных в интерфейсе.

Шаг 4. Перезапустить окно и найти панели 1С

После появления packagedef перезапустите окно: Ctrl+Shift+P → Developer: Reload Window. Расширение активируется по событию workspaceContains:packagedef, и без перезапуска полный набор панелей может не появиться.

После перезапуска появляются панели «1С: Инструменты», «1С: Метаданные» и «1С: Свойства». На нашем стенде в выпадающем списке панелей Cursor 3.19.7 их не было. Открыть их можно через View → Open View… → 1С: Инструменты.

Рис. 4. Выпадающий список панелей Cursor 3.19.7: 1 из панелей расширения здесь только «1С: Проекты» и «1С: Администрирование». «1С: Инструменты» в списке нет.

Рис. 5. View → Open View…: 1 здесь есть все панели расширения - «1С: Инструменты», «1С: Метаданные», «1С: Свойства».

Шаг 5. Включить IPC расширения

После установки MCP-расширения Cursor показал уведомление: «MCP-серверу нужен IPC расширения 1c-platform-tools: без него инструменты недоступны» с кнопкой [Включить]. Нажмите её.

Кнопка записывает в пользовательские настройки:

1

"1c-platform-tools.ipc.enabled": true

После этого расширение поднимает локальный TCP-сервер на 127.0.0.1:40241 (порт по умолчанию). Мы проверили это на стенде командой PowerShell Get-NetTCPConnection. MCP-сервер подключается к расширению именно по этому порту и передаёт токен из переменной ONEC_IPC_TOKEN.

В первой статье было написано, что связь идёт «через локальный канал (stdio/IPC) - без отдельного сетевого порта». Это неверно: порт есть, пусть и только на localhost. Если порт 40241 уже кем-то занят, это надо учитывать.

Шаг 6. Записать .cursor/mcp.json

Cursor не поддерживает провайдер MCP-серверов VS Code, поэтому сервер подключается через файл .cursor/mcp.json в проекте. Писать его руками не нужно.

Откройте 1С: Инструменты → Команды → Навыки для AI → Настроить MCP для Cursor. Это обычный клик в дереве, палитра команд не нужна. Та же команда есть в палитре под именем «Настроить MCP для Cursor (.cursor/mcp.json)».

Рис. 6. Панель «1С: Инструменты» → «Команды»: 1 узел «Навыки для AI» и пункт «Настроить MCP для Cursor». Один клик - и файл .cursor/mcp.json записан.

Cursor покажет уведомление «Конфиг MCP для Cursor записан в …/.cursor/…». У нас получился такой файл (имя пользователя заменено):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
  "mcpServers": {
    "mcp-1c-platform-tools": {
      "disabled": false,
      "command": "node",
      "args": [
        "c:/Users/<user>/.cursor/extensions/yellow-hammer.mcp-1c-platform-tools-0.3.0-universal/out/src/index.js"
      ],
      "env": {
        "ONEC_IPC_HOST": "127.0.0.1",
        "ONEC_IPC_PORT": "40241",
        "ONEC_IPC_TOKEN": ""
      }
    }
  }
}

Обратите внимание на путь в args: в нём есть номер версии расширения (0.3.0). К этому вернёмся в разделе про грабли.

И на пустой ONEC_IPC_TOKEN. С пустым токеном расширение принимает команды от любого процесса на этой машине, о чём честно пишет в свой лог (Output → «1C Platform Tools»): «токен не задан: команды примет любой процесс этой машины, задайте 1c-platform-tools.ipc.token». Мы это проверили: скрипт проверки MCP-сервера (его текст - в шаге 7) без всякого токена запустил на стенде команду установки OneScript (её Cursor ещё переспросил, но далеко не все команды спрашивают). Среди команд есть и такие, что пересоздают базу. Токен ограничивает доступ к IPC для процессов, которые его не знают; он не защищает от процесса, способного прочитать настройки или mcp.json от имени того же пользователя.

Как закрыть:

1. В настройках Cursor (Ctrl+,) найдите 1c-platform-tools.ipc.token и впишите длинную случайную строку.
2. Ещё раз выполните «Настроить MCP для Cursor»: расширение возьмёт токен из этой настройки и запишет его в ONEC_IPC_TOKEN.
3. Не коммитьте .cursor/mcp.json: теперь в нём секрет, а ещё путь к профилю пользователя. Добавьте этот файл в .gitignore, а в репозиторий положите шаблон без токена, например .cursor/mcp.json.example:
   .cursor/mcp.json (шаблон для git)

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

   { "mcpServers": { "mcp-1c-platform-tools": { "disabled": false, "command": "node", "args": [ "c:/Users/<ПОЛЬЗОВАТЕЛЬ>/.cursor/extensions/yellow-hammer.mcp-1c-platform-tools-<ВЕРСИЯ>-universal/out/src/index.js" ], "env": { "ONEC_IPC_HOST": "127.0.0.1", "ONEC_IPC_PORT": "40241", "ONEC_IPC_TOKEN": "" } } } }

4. Снова включите сервер (шаг 7): после правки mcp.json Cursor его выключает.

Мы проверили это на стенде 25.09.26. Токен действует сразу, перезапуск не нужен: вызов без токена получает UNAUTHORIZED, и MCP-сервер показывает агенту только один служебный инструмент. После повторного «Настроить MCP для Cursor» токен попал в mcp.json, и все 108 инструментов вернулись.

Одна тонкость. На нашем стенде после перезапуска Cursor иногда оставался «1 tool enabled»: сервер стартовал раньше IPC, что подтверждала ошибка ECONNREFUSED 127.0.0.1:40241 в логе. Reload не помог, а после запроса «Покажи состояние окружения 1С» сервер переподключился и снова показал 108 инструментов. Само число «1» не определяет причину: проверьте лог, поскольку при неверном токене тоже остаётся один служебный инструмент.

Шаг 7. Включить сервер в Cursor

Настройки MCP в Cursor 3.x переехали. В Cursor Settings теперь висит баннер «Plugins, MCPs, Skills, and Rules have moved to Customize». Нажмите Open Customize → MCPs.

Сервер mcp-1c-platform-tools будет в списке в состоянии Disabled, хотя в mcp.json стоит "disabled": false. Так и задумано: по документации MCP-расширения «новый сервер Cursor добавляет выключенным». Именно на этом месте застрял автор комментария №11 к первой статье, а в ней об этом не было ни слова.

Как включить:

1. Щёлкните по строке сервера. Откроется «Configure mcp-1c-platform-tools».
2. Включите переключатель у источника .cursor/mcp.json.
3. Статус сменится на «Local: Connecting…», затем на Connected.

На нашем стенде после подключения Cursor показал 108 tools enabled. Число зависит от версий расширений: список инструментов собирается из команд расширения, так что у Вас оно может отличаться.

Рис. 7. Customize → MCPs: 1 сервер mcp-1c-platform-tools в состоянии Disabled, хотя в .cursor/mcp.json записано "disabled": false.

Рис. 8. «Configure mcp-1c-platform-tools»: 1 переключатель источника .cursor/mcp.json включён, 2 среда Local - Connected. Ниже - список инструментов, каждый можно отключить отдельно.

Скрипт запускает MCP-сервер так же, как Cursor, по параметрам из .cursor/mcp.json, и выводит список инструментов. С аргументом он вызывает один инструмент без параметров. Удобно, когда непонятно, кто виноват: Cursor или связка «MCP-сервер - расширение».

Сохраните его в проекте как tools/mcp-check.mjs и запускайте из корня проекта, пока проект открыт в Cursor и IPC включён (шаг 5). Нужен только Node.js, пакеты ставить не надо.

1
2

node tools/mcp-check.mjs
node tools/mcp-check.mjs env_status

Вызывайте так только безопасные инструменты вроде env_status: скрипт ничего не переспрашивает, а среди инструментов есть пересоздание базы.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

// Проверка MCP-сервера 1C: Platform Tools без Cursor.
// Запускает сервер по параметрам из .cursor/mcp.json, получает список инструментов
// и, если передан аргумент, вызывает один инструмент без параметров.
//
//   node tools/mcp-check.mjs              - список инструментов
//   node tools/mcp-check.mjs env_status   - вызвать env_status
//
// Нужен открытый в Cursor/VS Code проект с включённым IPC (1c-platform-tools.ipc.enabled).

import { spawn } from "node:child_process";
import { readFileSync } from "node:fs";

const cfg = JSON.parse(readFileSync(".cursor/mcp.json", "utf8")).mcpServers["mcp-1c-platform-tools"];
const server = spawn(cfg.command, cfg.args, { env: { ...process.env, ...cfg.env }, stdio: ["pipe", "pipe", "inherit"] });

let buf = "";
const waiting = new Map();
server.stdout.on("data", (chunk) => {
  buf += chunk;
  let i;
  while ((i = buf.indexOf("\n")) >= 0) {
    const line = buf.slice(0, i).trim();
    buf = buf.slice(i + 1);
    if (!line) continue;
    const msg = JSON.parse(line);
    waiting.get(msg.id)?.(msg);
  }
});

let nextId = 1;
function request(method, params) {
  const id = nextId++;
  server.stdin.write(JSON.stringify({ jsonrpc: "2.0", id, method, params }) + "\n");
  return new Promise((resolve) => waiting.set(id, resolve));
}

const init = await request("initialize", {
  protocolVersion: "2025-06-18",
  capabilities: {},
  clientInfo: { name: "mcp-check", version: "1.0.0" },
});
console.log(`Сервер: ${init.result.serverInfo.name} ${init.result.serverInfo.version}`);
server.stdin.write(JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" }) + "\n");

const tool = process.argv[2];
if (tool) {
  const res = await request("tools/call", { name: tool, arguments: {} });
  console.log(JSON.stringify(res.result ?? res.error, null, 2));
} else {
  const { result } = await request("tools/list", {});
  console.log(`Инструментов: ${result.tools.length}`);
  for (const t of result.tools) console.log(`${t.name}\t${(t.description ?? "").split("\n")[0]}`);
}
server.kill();

Шаг 8. Проверка: «Покажи состояние окружения 1С»

В первой статье проверкой был вопрос «Какие объекты есть в корне конфигурации?». Этот вопрос не проверяет MCP вообще: агент ответит на него, прочитав файлы проекта. Документация MCP-расширения предлагает другую проверку, и её мы и рекомендуем.

Откройте чат агента и напишите:

Покажи состояние окружения 1С

Агент должен сам вызвать инструмент env_status. По документации в ответе будут активный профиль запуска, версия платформы и путь к базе.

У нас агент вызвал env_status (в чате видно «1 tool») и вывел таблицу:

• профиль - default, схема настроек v2;
• env.json - файла нет;
• vanessa-runner - не определена;
• строки подключения нет;
• OData - автономный сервер не запущен.

Затем он предложил создать служебные файлы. Для чистого проекта без базы это правильная картина: MCP работает, а окружение ещё не настроено.

Если агент ответил без вызова инструмента, такая проверка ещё не подтверждает работу MCP. Попросите его явно вызвать env_status. Если инструмент недоступен, проверьте подключение по шагу 7.

Рис. 9. Проверка в чате: 1 под запросом видно «1 tool» - агент вызвал env_status, а не ответил по памяти. Таблица честно показывает пустое окружение: env.json нет, vanessa-runner не определена, OData не запущен. Путь к проекту на снимке заменён на <user>.

Грабли: MODULE_NOT_FOUND и два окна Cursor

MODULE_NOT_FOUND после обновления расширения

В .cursor/mcp.json записан путь к index.js, и в этом пути есть версия расширения (…mcp-1c-platform-tools-0.3.0-universal…). Когда расширение обновляется, каталог старой версии пропадает, и сервер падает с ошибкой MODULE_NOT_FOUND.

Начиная с версии 0.1.10 MCP-расширение чинит это само: при запуске оно переписывает путь, если тот ведёт на другую установку этого же расширения (так сказано в его README и видно в коде, out/src/cursorConfig.js). Путь, прописанный вручную, например на сборку из исходников, расширение не трогает, его придётся править руками.

Мы проверили это на стенде 25.09.26: вписали в путь версию 0.2.3 - с неё у нас начиналась установка, но её каталога после обновления уже нет - и перезапустили Cursor. Вот что произошло:

1. Первый запуск всё равно упал. Cursor стартовал сервер в 11:59:20, а расширение активировалось и переписало путь только в 11:59:33 (в его логе: «Конфиг Cursor обновлён»). Сервер к этому моменту уже упал с MODULE_NOT_FOUND.
2. Интерфейс ошибку почти не показывает. Сначала в списке висит зелёная точка и «0 tools enabled». Потом сервер уходит в группу «Needs Attention» и выключается: Cursor выключает сервер после любой правки .cursor/mcp.json, в том числе сделанной расширением. В окне сервера написано только «MCP error -32000: Connection closed», а причину видно лишь по кнопке Show Output.
3. Переключатель и Reload не помогли. Путь в файле уже был правильным, но переподключился сервер только после перезапуска Cursor.

Что делать, если после обновления расширения MCP-инструменты пропали:

1. Проверить путь в .cursor/mcp.json: номер версии должен совпадать с карточкой расширения. Если путь не исправился сам (например, вы писали его руками), выполните «Настроить MCP для Cursor» ещё раз.
2. Перезапустить Cursor.
3. Снова включить сервер, как в шаге 7.

Пока Cursor открыт, обновление ничего не ломает: уже запущенный процесс сервера продолжает работать. Ошибка появляется при следующем запуске.

Рис. 10. MODULE_NOT_FOUND в Cursor 3.19.7: 1 сервер попал в группу «Needs Attention» и выключен, 2 причина видна только в Output (кнопка Show Output в окне сервера): Cannot find module …mcp-1c-platform-tools-0.2…, code: 'MODULE_NOT_FOUND'. Имя пользователя в пути заменено на <user>.

Два окна Cursor с разными проектами

IPC-порт по умолчанию один на всех: 40241. Если открыть второй проект во втором окне Cursor, второе окно сообщит, что порт уже используется, а агент может попасть не в тот проект. Это видно по ошибке WORKSPACE_MISMATCH.

Лечение по документации: задать каждому проекту свой порт в .vscode/settings.json этого проекта. Порт, на который смотрит MCP-сервер, указан в .cursor/mcp.json в переменной ONEC_IPC_PORT. Точный рецепт - в docs/index.md репозитория yellow-hammer/mcp-1c-platform-tools, раздел «Несколько окон».

А как агенту увидеть метаданные?

Это был главный тезис первой статьи, и он был неверным. Там говорилось, что MCP-сервер передаёт агенту «полную объектную модель» и «сериализацию графа», а реквизиты справочника агент получает через MCP. Как показано выше, таких инструментов в MCP-сервере нет.

Метаданные агент читает сам, из файлов проекта. Выгрузка конфигурации в файлы - это XML-описания объектов и модули BSL рядом с ними, например:

• Catalogs/Номенклатура.xml - описание справочника: реквизиты, табличные части, свойства;
• Catalogs/Номенклатура/Ext/ObjectModule.bsl - модуль объекта.

Файлов с расширением .1c, о которых писала первая статья, в выгрузке нет. Файла Справочник.Номенклатура.bsl тоже нет.

Рис. 11. Метаданные - это обычные файлы: 1 Catalogs/Номенклатура.xml в дереве проекта, 2 описание реквизита «Артикул» (строка, 20 символов) внутри XML. Именно это агент и читает, без всякого MCP.

Для небольших вопросов («какие реквизиты у справочника Номенклатура») этого достаточно: агент откроет XML и прочитает. Для вопросов про связи (где используется объект, кто вызывает функцию, что сломается при изменении) чтения отдельных файлов мало. Для этого мы используем граф знаний конфигурации, про него есть отдельная статья об Analyzer 1C.

Что было не так в первой статье

Отдельно о цифре «15 минут» в заголовке первой статьи. Мы её не повторяем: время установки на стенде мы не замеряли, а обещать цифру без замера не будем.

Что дальше

После шага 8 MCP подключён, но агенту пока почти нечего делать: env_status сам сказал, что окружение пустое. Чтобы агент мог собирать конфигурацию и проверять свой код, нужны:

1. OneScript и vanessa-runner (ставятся из дерева «Зависимости»);
2. профиль запуска из узла «Служебные файлы»: env.json для vanessa-runner 2.x или autumn-properties.json для 3.x. В приведённом packagedef указан vanessa-runner 3.0.0, поэтому после его установки нужен второй формат;
3. информационная база из исходников (infobase_initFromSrc);
4. после этого - syntaxCheck_run и cf_compile прямо из чата.

Форматы профилей описаны в документации Platform Tools 0.9.6. Это тема следующей части. Её мы тоже пройдём на том же стенде и с теми же снимками экрана.

А у Вас MCP-сервер Platform Tools заработал с первого раза? На каком шаге застряли и какие версии Cursor и расширений у Вас стоят? Напишите в комментариях: если найдётся шаг, который у Вас выглядит иначе, мы добавим его в статью.

Теги: Cursor, MCP, Model Context Protocol, 1C: Platform Tools, yellow-hammer, ИИ-агент, 1С, BSL, packagedef, OneScript, opm, Open VSX, mcp.json, IPC, env_status, выгрузка конфигурации в XML, Analyzer 1C, AI для 1С, DevOps 1С