Използване на 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, затова адресът http://127.0.0.1:3907/mcp на QCAD не се приема там.

Windows

• В QCAD изберете Разни > MCP > Инсталиране в Claude Desktop. QCAD показва файла qcad.mcpb маркиран във File Explorer. Командният ред в 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 ms (една минута). Увеличете тази стойност, ако работите с много големи чертежи.

Работа с Claude и QCAD

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

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

Провери чертежа в QCAD за проблеми и изброй какво откриваш.

Създай спецификация на материалите от референциите към блокове в чертежа.

Начертай правоъгълник 100 x 50 mm на нов слой "Контур" и закръгли всички ъгли с радиус 5 mm.

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 > Стартиране съобщи, че адресът вече се използва, друга програма или друг прозорец на QCAD вече използва порт 3907. Само един прозорец на QCAD може да изпълнява MCP сървъра на даден порт. Спрете сървъра в другия прозорец на QCAD с Разни > MCP > Спиране и го стартирайте в прозореца, в който искате да работите.

Claude работи с грешния чертеж

Claude винаги работи с активния чертеж на онзи екземпляр на QCAD, в който работи MCP сървърът. Щракнете в QCAD върху раздела или прозореца на чертежа, с който искате Claude да работи. Ако работят няколко екземпляра на QCAD, уверете се, че MCP сървърът работи в екземпляра, който гледате.

Заявката отнема много време или завършва с изтичане на времето за изчакване

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