# Плагин `kompas` — КОМПАС-3D в Claude Code

Даёт Claude Code инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
с ними: навыки `kompas:kompas-3d` и `kompas:kompas-fdm-design`.

## Предпосылки

- Windows x64;
- установленный КОМПАС-3D (проверено на v24 Home) — сервер является COM-клиентом, а не автономным
  CAD-движком, и работает только на той же машине. Запускать заранее не нужно: сервер присоединится
  к открытому окну, а если его нет — запустит экземпляр сам;
- КОМПАС установлен **вместе с компонентом SDK**: interop-сборки принадлежат АСКОН, в поставку
  сервера не входят и берутся из установки (`SDK\Samples\CSharp.zip`, каталог `Common`). При первом
  запуске они распаковываются в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`; если SDK не установлен,
  укажите каталог с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`;
- [**.NET Runtime**](https://dotnet.microsoft.com/download/dotnet) **8 или новее, x64** — сервер
  поставляется framework-dependent, рантайм берётся с машины. Проверка: `dotnet --list-runtimes`
  показывает `Microsoft.NETCore.App 8.x` или новее;
- чекаут репозитория и рабочие файлы — вне синхронизируемых папок OneDrive.

## Установка

```
/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
/plugin install kompas@kompas-plugin
/kompas:doctor
```

Сервер (`bin/kompas-mcp.exe`) едет вместе с плагином — отдельно скачивать и устанавливать нечего.
`/kompas:doctor` проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение.

## Обновление

```
/plugin marketplace update kompas-plugin
/plugin update kompas@kompas-plugin
```

Если инструменты остались прежними — `/reload-plugins`.

## Разработка сервера

Переменная окружения `KOMPAS_MCP_EXE` подменяет поставленный бинарь своим:

```powershell
$env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"
```

Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.

## Другие харнессы (Codex, opencode)

Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/` и
`adapters/opencode/`. Это сниппеты конфигурации и инструкция, а не отдельные дистрибутивы:
контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.

## Прочее

Каталог `%LOCALAPPDATA%\kompas-mcp` (распакованные interop-сборки, при разработке — временные
файлы) не очищается при обновлении и удалении плагина — удаляется вручную.
