Компас 3D MCP: три сервера и подключение к Claude, Codex и Cursor

cad-lab-ai/kompas-mcp· Проверено 12.11.2026· 8на GitHub

Подключает агента к КОМПАС-3D на вашем компьютере: строить и править детали и сборки, чертить по ЕСКД, проверять модель снимками вида и выгружать результат в STEP, DXF и PDF.

3 реализации:

Работает в открытой модели этапами: каждый шаг агента снимается одним Ctrl+Z, после шага агент проверяет перестроение, пересечения тел и ваши условия; установщик сам прописывает сервер в Claude, Codex, Cursor и другие клиенты.

Как подключить

Что сделать до подключения

Windows 10/11 x64, КОМПАС-3D v19 или новее (x64) и .NET Framework 4.8

Скачать KompasAgent-<версия>.zip со страницы релизов, распаковать и запустить powershell -ExecutionPolicy Bypass -File install.ps1

В каждой сессии КОМПАС: меню библиотеки «Агент КОМПАС (MCP)» → «Запустить агента»

Если клиент не раскрывает %LOCALAPPDATA%, впишите в command полный путь

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio kompas-3d \
  -- '%LOCALAPPDATA%\Programs\KompasAgent\python\python.exe' -m kompas_mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.kompas-3d]
command = "%LOCALAPPDATA%\\Programs\\KompasAgent\\python\\python.exe"
args = ["-m", "kompas_mcp"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "kompas-3d": {
      "command": "%LOCALAPPDATA%\\Programs\\KompasAgent\\python\\python.exe",
      "args": ["-m", "kompas_mcp"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "kompas-3d": {
      "type": "stdio",
      "command": "%LOCALAPPDATA%\\Programs\\KompasAgent\\python\\python.exe",
      "args": ["-m", "kompas_mcp"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "kompas-3d": {
      "command": "%LOCALAPPDATA%\\Programs\\KompasAgent\\python\\python.exe",
      "args": ["-m", "kompas_mcp"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "kompas-3d": {
      "command": "%LOCALAPPDATA%\\Programs\\KompasAgent\\python\\python.exe",
      "args": ["-m", "kompas_mcp"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "kompas-3d": {
        "type": "local",
        "command": [
          "%LOCALAPPDATA%\\Programs\\KompasAgent\\python\\python.exe",
          "-m",
          "kompas_mcp"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "kompas-3d": {
      "command": "%LOCALAPPDATA%\\Programs\\KompasAgent\\python\\python.exe",
      "args": ["-m", "kompas_mcp"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "kompas-3d": {
      "command": "%LOCALAPPDATA%\\Programs\\KompasAgent\\python\\python.exe",
      "args": ["-m", "kompas_mcp"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

kompas_healthпроверяет связь с КОМПАС

project_overviewпоказывает состав проекта

model_overviewописывает открытую модель

findищет объекты модели

inspectчитает свойства объекта

impactпоказывает, что зависит от объекта

where_usedищет, где используется деталь

variablesчитает переменные модели

drawing_readчитает чертёж

change_beginоткрывает этап правки

code_execвыполняет код правки

change_endзакрывает этап с проверкой

change_undoоткатывает этап

test_execпробует правку с автооткатом

validateпроверяет модель

assert_registerзадаёт условие проверки

view_captureснимает вид модели

selection_getчитает выделение пользователя

export_shapeвыгружает в STEP, IGES, STL

export_drawingвыгружает чертёж в PDF, DXF, PNG

Показано 20 из 55.

Готовый kompas-mcp.exe без исходников, доступ по config.json с сайта активации kompasmcp.ru; есть сценарии CAD-as-Code и skill для Codex.

Как подключить

Что сделать до подключения

Windows и установленный КОМПАС-3D на этой же машине

Скачать архив из Releases и распаковать, например в C:\Programs\kompasmcp

Получить config.json на kompasmcp.ru по коду приглашения и положить в %USERPROFILE%\.kompasmcp\config.json

Для Codex по желанию скопировать skills\kompas-mcp-operator в %USERPROFILE%\.codex\skills

config.json

kompasmcp.ru → активация по коду приглашения из README → файл в %USERPROFILE%\.kompasmcp

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio kompas-3d-mcp-bin \
  -- '<папка распаковки>/kompas-mcp.exe'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.kompas-3d-mcp-bin]
command = "<папка распаковки>/kompas-mcp.exe"
args = []

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "kompas-3d-mcp-bin": {
      "command": "<папка распаковки>/kompas-mcp.exe",
      "args": []
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "kompas-3d-mcp-bin": {
      "type": "stdio",
      "command": "<папка распаковки>/kompas-mcp.exe",
      "args": []
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "kompas-3d-mcp-bin": {
      "command": "<папка распаковки>/kompas-mcp.exe",
      "args": []
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "kompas-3d-mcp-bin": {
      "command": "<папка распаковки>/kompas-mcp.exe",
      "args": []
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "kompas-3d-mcp-bin": {
        "type": "local",
        "command": ["<папка распаковки>/kompas-mcp.exe"]
      }
    }
  }
}

{
  "mcpServers": {
    "kompas-3d-mcp-bin": {
      "command": "<папка распаковки>/kompas-mcp.exe",
      "args": []
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "kompas-3d-mcp-bin": {
      "command": "<папка распаковки>/kompas-mcp.exe",
      "args": []
    }
  }
}

Инструменты сервера

execute_tdcad_scriptстроит модель сценарием CAD-as-Code

execute_geometry_scriptвыполняет геометрический сценарий

scenario_runnerповторяет сохранённые цепочки

78 инструментов под машиностроение: зубчатые и червячные передачи, пружины, крепёж по ГОСТ, расчёты, сборочный чертёж со спецификацией; в комплекте чат «Давинчи» в окне КОМПАС.

Как подключить

Что сделать до подключения

Windows 10/11 x64, КОМПАС-3D v22 с папкой SDK и .NET Framework 4.8

Релизов на GitHub нет: соберите KompasMcp.exe командой powershell -ExecutionPolicy Bypass -File build.ps1

Interop-сборки КОМПАС сформируйте скриптом interop.ps1: лицензия ASCON запрещает класть их в архив

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio kompas-mcp \
  -- '<папка сервера>/KompasMcp.exe'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.kompas-mcp]
command = "<папка сервера>/KompasMcp.exe"
args = []

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "kompas-mcp": {
      "command": "<папка сервера>/KompasMcp.exe",
      "args": []
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "kompas-mcp": {
      "type": "stdio",
      "command": "<папка сервера>/KompasMcp.exe",
      "args": []
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "kompas-mcp": {
      "command": "<папка сервера>/KompasMcp.exe",
      "args": []
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "kompas-mcp": {
      "command": "<папка сервера>/KompasMcp.exe",
      "args": []
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "kompas-mcp": {
        "type": "local",
        "command": ["<папка сервера>/KompasMcp.exe"]
      }
    }
  }
}

{
  "mcpServers": {
    "kompas-mcp": {
      "command": "<папка сервера>/KompasMcp.exe",
      "args": []
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "kompas-mcp": {
      "command": "<папка сервера>/KompasMcp.exe",
      "args": []
    }
  }
}

Инструменты сервера

kompas_startзапускает свой экземпляр КОМПАС

create_drawingсоздаёт чертёж нужного формата

lin_dimставит линейный размер

hatchштрихует контур

fill_stampзаполняет основную надпись

tech_demandsпишет технические требования

export_dxfвыгружает чертёж в DXF

create_partсоздаёт 3D-деталь

sketchрисует эскиз на плоскости

extrude_bossвыдавливает эскиз

holeделает сквозное отверстие

mass_propertiesсчитает массу и габариты

render_png_3dснимает деталь в PNG

std_partставит крепёж и подшипники по ГОСТ

gear_pairсобирает пару зубчатых колёс

worm_checkпроверяет червячную передачу

fit_calcсчитает посадку по ЕСДП

part_drawingделает чертёж по 3D-модели

assembly_drawingделает сборочный чертёж

spec_drawingсобирает спецификацию по ГОСТ 2.106

Показано 20 из 78.

Что попросить агента

«Сделай фланец Ø120 с шестью отверстиями под M8 на Ø95»Агент CAD Lab откроет этап change_begin, построит деталь через code_exec, закроет этап change_end с проверкой и снимет вид view_capture

«Покажи, из чего состоит сборка, и что зависит от эскиза основания»Агент вызовет project_overview, model_overview и impact

«Проверь чертёж: пустые графы штампа, размеры без допусков»Агент прочитает чертёж через drawing_read и прогонит validate

«Выгрузи сборку в STEP»Агент вызовет export_shape с форматом STEP

«Сделай червячную передачу m=5, z1=2, q=10, z2=40, проверь при моменте 400 Н·м и выпусти чертежи и сборочный чертёж со спецификацией»kompas-mcp вызовет worm_check, worm_drawing, worm_wheel_drawing, worm_pair и assembly_drawing и сложит файлы в папку mcp-out

Для каких задач

Построить деталь по размерам: фланец, основание с отверстиями, втулку

Показать, из чего состоит сборка и что сломается при смене размера

Проверить зазор между деталями и пустые графы штампа на чертеже

Сделать разрез и снимок вида для проверки геометрии

Выпустить чертёж по модели и сборочный чертёж со спецификацией

Выгрузить сборку в STEP, чертёж в DXF или PDF

Ограничения

Все три сервера работают только на Windows и только с КОМПАС-3D, установленным на той же машине

Вариант CAD Lab появился 28.10.2026 и у него 8 звёзд; исходники пока не выложены, коммерческое использование запрещено без отдельного разрешения

KOMPAS-3D MCP закрыт: только exe, доступ через активацию на kompasmcp.ru по коду приглашения, последний релиз v1.0.22 от 10.06.2026

kompas-mcp от Alexey Izilianov проверен только на КОМПАС-3D v22, у него 6 звёзд, нет релизов и лицензии; резьба не моделируется, спецификация до 25 строк

Если не работает

Агент не видит инструментов kompas

Перезапустите агента после установки и проверьте, что сервер прописан: claude mcp list или ~\.codex\config.toml.

kompas_health отвечает, что КОМПАС недоступен

В КОМПАС не запущен агент: меню библиотеки «Агент КОМПАС (MCP)» → «Запустить агента».

kompas-mcp сообщает 0x80040154 (класс не зарегистрирован)

Так бывает после переустановки КОМПАС: один раз запустите КОМПАС вручную.

В Claude Code сервер не стартует, путь к KompasMcp.exe искажён

Пишите путь после -- с прямыми слэшами: обратные слэши там теряются. Проверьте, что claude mcp list показывает ✔ Connected.

Клиент видит KOMPAS-3D MCP, но инструменты не работают

Откройте КОМПАС-3D вручную и повторите запрос: для 2D нужен активный чертёж или фрагмент, для 3D — активная деталь или сборка.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
КОМПАС-3D: агент в вашей модели	CAD Lab	8	локально	не нужен	55	9 ноября 2026
KOMPAS-3D MCP	dwnmf	46	локально	не нужен	3	22 августа 2026
kompas-mcp	Alexey Izilianov	6	локально	не нужен	78	10 октября 2026

Частые вопросы

Какой из трёх серверов выбрать?

Для работы в своей модели и сборке подойдёт вариант CAD Lab: ставится установщиком, правит этапами и проверяет результат. kompas-mcp от Alexey Izilianov заточен под передачи, пружины и крепёж по ГОСТ, но его нужно собрать самому. KOMPAS-3D MCP поставляется готовым exe по активации.

Можно отменить то, что сделал агент?

В варианте CAD Lab каждый этап агента записывается в отмену КОМПАС одной записью: всё, что он сделал за шаг, снимается одним Ctrl+Z. Откатить последний шаг можно и просьбой к агенту, он вызовет change_undo.

Модель уходит куда-то с компьютера?

У варианта CAD Lab связь агента с КОМПАС локальная, через 127.0.0.1 с токеном сессии; модель и кадры видит только ваш агент и провайдер его модели. Отзывы разработчикам уходят только с вашего согласия в чате, выключаются флагом install.ps1 -Feedback off или KOMPAS_FEEDBACK=0.

Какая версия КОМПАС-3D нужна?

Вариант CAD Lab работает с КОМПАС-3D v19 и новее (x64). kompas-mcp от Alexey Izilianov проверен на v22 и требует папку SDK из стандартной установки.

Что такое MCP-сервер для Компас 3D?

Это программа на вашем компьютере, через которую агент вроде Claude или Codex управляет открытым КОМПАС-3D: строит детали, читает чертежи, проверяет модель и выгружает файлы. На странице три таких сервера с инструкциями.

Как подключить Компас 3D к LLM без Claude?

Подойдёт любой клиент с поддержкой MCP: установщик CAD Lab сам прописывает сервер в Gemini CLI и LM Studio. В kompas-mcp есть чат «Давинчи» в окне КОМПАС, нейросеть для него выбирается в настройках: Claude Code, Ollama на компьютере или другой Anthropic-совместимый API.

Kompas MCP подключается к Codex?

Да. Установщик CAD Lab прописывает сервер в ~\.codex\config.toml с увеличенным таймаутом. Для KOMPAS-3D MCP добавьте в config.toml блок [mcp_servers.kompas_3d] с путём к exe, startup_timeout_sec = 30 и tool_timeout_sec = 300.

Работает ли сервер из России?

Серверы запускаются на вашем компьютере рядом с КОМПАС-3D, зарубежные аккаунты для них не нужны; KOMPAS-3D MCP требует активации на kompasmcp.ru.

Компас 3D MCP: три сервера и подключение к Claude, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы