Использование QCAD с Claude Desktop

Введение

QCAD содержит MCP-сервер (Model Context Protocol). MCP — это открытый стандарт, который позволяет ИИ-ассистентам использовать инструменты, предоставляемые другими приложениями. Благодаря MCP-серверу QCAD приложение Claude Desktop может напрямую работать с чертежом, который в данный момент открыт в QCAD. Например, вы можете попросить Claude:

• описать незнакомый чертёж, его слои, блоки, размеры и текст
• проверить чертёж на наличие проблем, таких как незамкнутые полилинии, дублирующиеся объекты или геометрия на слое 0
• измерить расстояния, длины и площади
• составить спецификацию по вставкам блоков
• добавить слои, линии, дуги, окружности, полилинии, текст, размеры и штриховки
• переместить, повернуть, масштабировать, обрезать, скруглить или сместить существующие объекты
• экспортировать чертёж в формате PNG, PDF, SVG, DXF или DWG

В этом руководстве описано, как подключить QCAD к Claude Desktop в Windows или macOS.

Требования

• QCAD с подключаемым модулем MCP, установленный и запущенный на том же компьютере, что и Claude Desktop
• Приложение Claude Desktop для Windows или macOS

Расширение QCAD для Claude Desktop поставляется вместе с QCAD. Это файл qcad.mcpb в папке mcp вашей установки QCAD, например:

• Windows: C:\Program Files\QCAD\mcp\qcad.mcpb
• macOS: /Applications/QCAD-Pro.app/Contents/Resources/mcp/qcad.mcpb

В macOS папка находится внутри пакета приложения и не отображается в Finder, когда вы открываете папку Applications. Команда Разное > MCP > Установить в Claude Desktop в QCAD сама откроет или покажет этот файл (см. ниже).

Устанавливать Node.js отдельно не требуется. Claude Desktop содержит всё необходимое для работы расширения.

Запуск MCP-сервера в QCAD

MCP-сервер в QCAD не запускается автоматически. Пока он не запущен, QCAD не принимает никаких подключений.

• Запустите QCAD.
• Выберите Разное > MCP > Запустить.

Командная строка в нижней части окна QCAD подтверждает, что сервер работает:

MCP: MCP server running on port 3907 (http://127.0.0.1:3907/mcp)

Сервер работает до тех пор, пока вы не выберете Разное > MCP > Остановить или не закроете QCAD. Его необходимо запускать заново при каждом запуске QCAD.

Меню Разное > MCP также содержит:

• Установить в Claude Desktop: помогает установить расширение QCAD в Claude Desktop (см. ниже)
• Состояние: показывает в командной строке, работает ли сервер и на каком порту
• Перезапустить: останавливает и снова запускает сервер, например после изменения его порта

Сервер принимает подключения только с того же компьютера (адрес 127.0.0.1). С других компьютеров в вашей сети он недоступен.

Установка расширения QCAD в Claude Desktop

Расширение устанавливается только один раз. Перед началом убедитесь, что Claude Desktop установлен и вы вошли в свою учётную запись.

Расширение QCAD является локальным: Claude Desktop запускает его на вашем компьютере, и оттуда оно подключается к MCP-серверу в QCAD. Не используйте для этого функцию Add custom connector в Claude. Пользовательские коннекторы принимают только серверы, доступные из интернета по адресу https, поэтому адрес QCAD http://127.0.0.1:3907/mcp там не принимается.

Windows

• В QCAD выберите Разное > MCP > Установить в Claude Desktop. QCAD показывает файл qcad.mcpb, выделенный в Проводнике. Кроме того, в командной строке QCAD отображаются шаги по его установке.
• В Claude Desktop откройте меню в левом верхнем углу окна и выберите File > Settings.
• Перейдите в Extensions, откройте Advanced settings и нажмите Install Extension.
• Выберите файл qcad.mcpb, например C:\Program Files\QCAD\mcp\qcad.mcpb.

В Windows не открывайте файл qcad.mcpb двойным щелчком и не перетаскивайте его в окно Claude Desktop. Ни то, ни другое не устанавливает расширение: Claude Desktop не регистрируется как программа для этого типа файлов, поэтому при двойном щелчке Windows лишь спросит, с помощью какого приложения открыть файл.

macOS

• В QCAD выберите Разное > MCP > Установить в Claude Desktop. QCAD открывает файл qcad.mcpb непосредственно в Claude Desktop.
• Если найти Claude Desktop не удаётся, QCAD вместо этого показывает файл в Finder. Перетащите его в окно Claude Desktop или выберите Claude > Settings в строке меню Claude Desktop, перейдите в Extensions, откройте Advanced settings, нажмите Install Extension и выберите файл.

Завершение установки

Claude Desktop показывает сведения о расширении QCAD. Нажмите Install и подтвердите.

После установки QCAD появляется в списке расширений в разделе Settings > Extensions. Убедитесь, что оно включено.

Настройки расширения

У расширения QCAD есть три настройки, которые можно изменить в Claude Desktop в разделе Settings > Extensions > QCAD. Как правило, значения по умолчанию менять не нужно:

• QCAD host: адрес MCP-сервера QCAD. Оставьте значение 127.0.0.1.
• QCAD MCP port: порт MCP-сервера QCAD, по умолчанию 3907. Он должен совпадать с портом, настроенным в QCAD.
• Reply timeout (ms): как долго Claude ждёт ответа от QCAD, по умолчанию 60000 мс (одна минута). Увеличьте это значение, если вы работаете с очень большими чертежами.

Работа с Claude и QCAD

• Откройте чертёж в QCAD или начните с нового чертежа.
• Убедитесь, что MCP-сервер работает (Разное > MCP > Состояние).
• Откройте новый чат в Claude Desktop и попросите то, что вам нужно, например:

Опиши чертёж, открытый в QCAD.

Проверь чертёж в QCAD на наличие проблем и перечисли, что ты нашёл.

Составь спецификацию по вставкам блоков в чертеже.

Нарисуй прямоугольник 100 x 50 мм на новом слое "Контур" и скругли все углы радиусом 5 мм.

Claude сам решает, какие инструменты QCAD использовать. При первом использовании инструмента Claude Desktop запрашивает ваше разрешение. Вы можете разрешить инструмент один раз или всегда.

Claude всегда работает с чертежом, который в данный момент активен в QCAD. Если открыто несколько чертежей, перед запросом переключитесь в QCAD на нужный чертёж.

Изменения, внесённые Claude, сразу же появляются в окне QCAD. Инструменты, которые изменяют или удаляют существующие объекты, переименовывают слои или удаляют неиспользуемые слои и блоки, только сообщают, что они изменили бы, если только Claude явно не попросит их применить изменение. Если вы хотите сначала просмотреть изменение, попросите Claude показать, что он сделает, прежде чем применять его. Любое изменение можно отменить в QCAD с помощью Правка > Отменить или попросив Claude отменить его.

Claude также может посмотреть на чертёж: он визуализирует чертёж в виде изображения, чтобы проверить, что на нём изображено, или проверить результат изменения.

Голосовой режим

MCP недоступен в голосовом режиме Claude Desktop. Инструменты QCAD можно использовать только в текстовых чатах. Чтобы работать с QCAD, вводите запросы с клавиатуры, а не произносите их.

Конфиденциальность

MCP-сервер QCAD и расширение обмениваются данными друг с другом только на вашем собственном компьютере. Однако всё, что Claude считывает из вашего чертежа, например имена слоёв, текст, размеры и координаты, отправляется Claude как часть беседы, как и любое другое содержимое, которым вы делитесь в чате. Не используйте MCP-сервер с чертежами, которые не должны покидать ваш компьютер.

Устранение неполадок

Windows спрашивает, с помощью какого приложения открыть qcad.mcpb

Claude Desktop для Windows не может открывать файлы .mcpb двойным щелчком. Закройте диалоговое окно и вместо этого установите файл в Claude Desktop через File > Settings > Extensions > Advanced settings > Install Extension, как описано выше.

Claude не принимает адрес QCAD в качестве коннектора

Функция Add custom connector в Claude работает только с серверами, доступными из интернета. QCAD подключается иначе — через расширение QCAD, как описано выше.

Claude сообщает “Cannot reach QCAD”

Расширение не может подключиться к QCAD. Проверьте, что:

• QCAD запущен
• MCP-сервер был запущен с помощью Разное > MCP > Запустить
• порт, отображаемый командой Разное > MCP > Состояние, совпадает с портом в настройках расширения в Claude Desktop

QCAD не обязательно запускать раньше Claude Desktop, и Claude Desktop не нужно перезапускать после запуска MCP-сервера. Однако если кажется, что Claude не знает об инструментах QCAD, сначала запустите QCAD и его MCP-сервер, а затем откройте новый чат в Claude Desktop.

Не удаётся запустить сервер

Если Разное > MCP > Запустить сообщает, что адрес уже используется, значит, порт 3907 уже занят другой программой или другим окном QCAD. Только одно окно QCAD может запускать MCP-сервер на заданном порту. Остановите сервер в другом окне QCAD с помощью Разное > MCP > Остановить и запустите его в окне, в котором вы хотите работать.

Claude работает не с тем чертежом

Claude всегда работает с активным чертежом того экземпляра QCAD, в котором запущен MCP-сервер. Щёлкните в QCAD по вкладке или окну чертежа, с которым должен работать Claude. Если запущено несколько экземпляров QCAD, убедитесь, что MCP-сервер работает в том экземпляре, на который вы смотрите.

Запрос выполняется долго или завершается по тайм-ауту

QCAD не может отвечать, пока в QCAD открыто диалоговое окно. Закройте все открытые диалоговые окна в QCAD и задайте вопрос снова. Для очень больших чертежей увеличьте Reply timeout в настройках расширения.