1C: Platform Tools MCP

MCP-сервер даёт агенту Cursor или VS Code доступ к командам расширения 1C: Platform Tools: тесты, профили запуска, сборка конфигурации, работа с базой.

Установка

1. Установите 1C: Platform Tools: Marketplace, Open VSX
2. Установите 1C: Platform Tools MCP: Marketplace, Open VSX
3. Откройте проект 1С (папка с packagedef).

Подключение

VS Code больше ничего не требует: расширение регистрирует MCP-сервер само.

Cursor не поддерживает провайдер MCP-серверов VS Code, поэтому сервер подключается через .cursor/mcp.json проекта. Файл создаёт и обновляет расширение:

1. Палитра команд (F1) → 1C: Platform Tools MCP: Настроить MCP для Cursor, либо в дереве Инструменты 1С → Навыки для AI → Настроить MCP для Cursor.
2. Перезагрузите окно.
3. Включите сервер mcp-1c-platform-tools в настройках MCP: новый сервер Cursor добавляет выключенным.

Команда пишет путь к серверу и параметры IPC; другие серверы в файле сохраняются. Путь содержит версию расширения, поэтому после обновления запись устаревает и сервер падает с MODULE_NOT_FOUND. Расширение чинит это при запуске: обновляет путь, если он ведёт на другую установку этого же расширения. Путь, прописанный вручную (например, на сборку из исходников), остаётся как есть.

Проверка

Напишите агенту «покажи состояние окружения 1С». В ответе будут активный профиль запуска, версия платформы и путь к базе. Дальше можно просить прогон тестов, переключение профиля, сборку конфигурации.

Документация

Каталог docs публикуется на сайте 1C: Platform Tools разделом MCP-сервер: установка и подключение, параметры инструментов, что писать агенту.

Настройка вручную

Нужна, только если конфиг заводится без расширения. Настройка 1c-platform-tools.ipc.enabled должна быть включена, значения ONEC_IPC_* берутся из 1c-platform-tools.ipc.*:

{
  "mcpServers": {
    "mcp-1c-platform-tools": {
      "command": "node",
      "args": ["<путь к каталогу расширения>/out/src/index.js"],
      "env": {
        "ONEC_IPC_HOST": "127.0.0.1",
        "ONEC_IPC_PORT": "40241",
        "ONEC_IPC_TOKEN": ""
      }
    }
  }
}

Каталог расширения: %USERPROFILE%\.cursor\extensions\yellow-hammer.mcp-1c-platform-tools-<версия>-universal (Windows) или ~/.cursor/extensions/... (macOS, Linux). После каждого обновления расширения такой путь придётся править руками.

Глобальный конфиг (%USERPROFILE%\.cursor\mcp.json) работает так же, но его расширение не обновляет: для нескольких проектов надёжнее проектный файл.