A QCAD használata a Claude Desktoppal

Bevezetés

A QCAD tartalmaz egy MCP- (Model Context Protocol) kiszolgálót. Az MCP egy nyílt szabvány, amely lehetővé teszi, hogy az MI-asszisztensek más alkalmazások által biztosított eszközöket használjanak. A QCAD MCP-kiszolgálóval a Claude Desktop alkalmazás közvetlenül dolgozhat a QCAD-ben éppen megnyitott rajzzal. Például megkérheti Claude-ot, hogy:

• írjon le egy ismeretlen rajzot, annak rétegeit, blokkjait, méretezéseit és szövegeit
• ellenőrizze a rajzot olyan hibákra, mint a nem zárt vonalláncok, a duplikált elemek vagy a 0-s rétegen lévő geometria
• mérjen távolságokat, hosszakat és területeket
• készítsen anyagjegyzéket a blokkhivatkozásokból
• adjon hozzá rétegeket, vonalakat, íveket, köröket, vonalláncokat, szöveget, méretezéseket és sraffozásokat
• mozgassa, forgassa, méretezze, vágja, kerekítse le vagy tolja el a meglévő elemeket
• exportálja a rajzot PNG, PDF, SVG, DXF vagy DWG formátumba

Ez az oktatóanyag bemutatja, hogyan csatlakoztathatja a QCAD-et a Claude Desktophoz Windows vagy macOS alatt.

Követelmények

• A QCAD az MCP-bővítménnyel, telepítve és futtatva ugyanazon a számítógépen, mint a Claude Desktop
• A Claude Desktop alkalmazás Windowsra vagy macOS-re

A Claude Desktophoz készült QCAD-bővítményt a QCAD tartalmazza. Ez a QCAD-telepítés mcp mappájában található qcad.mcpb fájl, például:

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

macOS alatt a mappa az alkalmazáscsomagon belül található, és a Finder nem jeleníti meg, amikor megnyitja az Applications mappát. A QCAD Egyéb > MCP > Telepítés a Claude Desktopba menüpontja megnyitja vagy megjeleníti Önnek a fájlt (lásd alább).

A Node.js-t nem kell külön telepíteni. A Claude Desktop mindent tartalmaz, ami a bővítmény futtatásához szükséges.

Az MCP-kiszolgáló indítása a QCAD-ben

A QCAD MCP-kiszolgálója nem indul el magától. Amíg nincs elindítva, a QCAD nem fogad kapcsolatokat.

• Indítsa el a QCAD-et.
• Válassza az Egyéb > MCP > Indítás menüpontot.

A QCAD ablakának alján lévő parancssor megerősíti, hogy a kiszolgáló fut:

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

A kiszolgáló addig fut, amíg ki nem választja az Egyéb > MCP > Leállítás menüpontot, vagy ki nem lép a QCAD-ből. A QCAD minden indításakor újra el kell indítani.

Az Egyéb > MCP menü a következőket is kínálja:

• Telepítés a Claude Desktopba: segít telepíteni a QCAD-bővítményt a Claude Desktopba (lásd alább)
• Állapot: megjeleníti a parancssorban, hogy fut-e a kiszolgáló, és melyik porton
• Újraindítás: leállítja és újraindítja a kiszolgálót, például a portjának módosítása után

A kiszolgáló csak ugyanarról a számítógépről fogad kapcsolatokat (127.0.0.1 cím). A hálózat más számítógépeiről nem érhető el.

A QCAD-bővítmény telepítése a Claude Desktopba

A bővítményt csak egyszer kell telepíteni. Mielőtt hozzákezd, győződjön meg arról, hogy a Claude Desktop telepítve van, és Ön be van jelentkezve.

A QCAD-bővítmény helyi bővítmény: a Claude Desktop az Ön számítógépén futtatja, ahol a bővítmény a QCAD MCP-kiszolgálójához csatlakozik. Ehhez ne használja a Claude Add custom connector funkcióját. Az egyéni csatlakozók csak olyan kiszolgálókat fogadnak el, amelyek az internetről https címen keresztül elérhetők, ezért a QCAD http://127.0.0.1:3907/mcp címét ott nem fogadják el.

Windows

• A QCAD-ben válassza az Egyéb > MCP > Telepítés a Claude Desktopba menüpontot. A QCAD kijelölve megjeleníti a qcad.mcpb fájlt a Fájlkezelőben. A QCAD parancssora a telepítés lépéseit is megjeleníti.
• A Claude Desktopban nyissa meg az ablak bal felső sarkában lévő menüt, és válassza a File > Settings pontot.
• Lépjen az Extensions részre, nyissa meg az Advanced settings elemet, és kattintson az Install Extension gombra.
• Válassza ki a qcad.mcpb fájlt, például: C:\Program Files\QCAD\mcp\qcad.mcpb.

Windows alatt ne kattintson duplán a qcad.mcpb fájlra, és ne is húzza a Claude Desktop ablakába. Egyik sem telepíti a bővítményt: a Claude Desktop nem regisztrálja magát ehhez a fájltípushoz, ezért dupla kattintásra a Windows csak megkérdezi, melyik alkalmazással nyissa meg a fájlt.

macOS

• A QCAD-ben válassza az Egyéb > MCP > Telepítés a Claude Desktopba menüpontot. A QCAD közvetlenül a Claude Desktopban nyitja meg a qcad.mcpb fájlt.
• Ha a Claude Desktop nem található, a QCAD ehelyett a Finderben jeleníti meg a fájlt. Húzza a fájlt a Claude Desktop ablakába, vagy válassza a Claude Desktop menüsorában a Claude > Settings pontot, lépjen az Extensions részre, nyissa meg az Advanced settings elemet, kattintson az Install Extension gombra, és válassza ki a fájlt.

A telepítés befejezése

A Claude Desktop megjeleníti a QCAD-bővítmény részleteit. Kattintson az Install gombra, és erősítse meg.

A telepítés után a QCAD megjelenik a bővítmények listájában a Settings > Extensions alatt. Győződjön meg arról, hogy engedélyezve van.

A bővítmény beállításai

A QCAD-bővítménynek három beállítása van, amelyek a Claude Desktopban a Settings > Extensions > QCAD alatt módosíthatók. Az alapértelmezett értékeket általában nem kell módosítani:

• QCAD host: a QCAD MCP-kiszolgáló címe. Hagyja 127.0.0.1 értéken.
• QCAD MCP port: a QCAD MCP-kiszolgáló portja, alapértelmezés szerint 3907. Ennek meg kell egyeznie a QCAD-ben beállított porttal.
• Reply timeout (ms): mennyi ideig vár Claude a QCAD válaszára, alapértelmezés szerint 60000 ms (egy perc). Növelje ezt az értéket, ha nagyon nagy rajzokkal dolgozik.

Munka Claude-dal és a QCAD-del

• Nyisson meg egy rajzot a QCAD-ben, vagy kezdjen egy új rajzot.
• Győződjön meg arról, hogy az MCP-kiszolgáló fut (Egyéb > MCP > Állapot).
• Nyisson egy új csevegést a Claude Desktopban, és kérje, amire szüksége van, például:

Írd le a QCAD-ben megnyitott rajzot.

Ellenőrizd a QCAD-ben lévő rajzot, hogy vannak-e benne hibák, és sorold fel, amit találsz.

Készíts anyagjegyzéket a rajzban lévő blokkhivatkozásokból.

Rajzolj egy 100 x 50 mm-es téglalapot egy új "Körvonal" rétegre, és kerekítsd le az összes sarkát 5 mm-es sugárral.

Claude dönti el, hogy mely QCAD-eszközöket használja. Amikor egy eszközt először használ, a Claude Desktop engedélyt kér Öntől. Az eszközt egyszer vagy mindig engedélyezheti.

Claude mindig a QCAD-ben éppen aktív rajzzal dolgozik. Ha több rajz is meg van nyitva, a kérés előtt váltson a megfelelő rajzra a QCAD-ben.

A Claude által végrehajtott módosítások azonnal megjelennek a QCAD ablakában. Azok az eszközök, amelyek meglévő elemeket módosítanak vagy törölnek, rétegeket neveznek át, vagy eltávolítják a nem használt rétegeket és blokkokat, csak jelentik, mit módosítanának, hacsak Claude kifejezetten nem kéri tőlük a módosítás végrehajtását. Ha először át szeretné tekinteni a módosítást, kérje meg Claude-ot, hogy mutassa meg, mit tenne, mielőtt végrehajtja. Minden módosítás visszavonható a QCAD-ben a Szerkesztés > Visszavonás paranccsal, vagy úgy, hogy megkéri Claude-ot a visszavonásra.

Claude meg is tudja nézni a rajzot: képként jeleníti meg, hogy ellenőrizze, mit ábrázol, vagy hogy ellenőrizze egy módosítás eredményét.

Hangalapú mód

Az MCP nem érhető el a Claude Desktop hangalapú módjában. A QCAD-eszközök csak szöveges csevegésekben használhatók. Ha a QCAD-del szeretne dolgozni, gépelje be a kéréseit ahelyett, hogy kimondaná őket.

Adatvédelem

A QCAD MCP-kiszolgáló és a bővítmény csak egymással kommunikál, az Ön saját számítógépén. Azonban mindaz, amit Claude a rajzából beolvas, például a rétegnevek, szövegek, méretezések és koordináták, a beszélgetés részeként elküldésre kerül Claude-nak, ugyanúgy, mint bármely más tartalom, amelyet egy csevegésben megoszt. Ne használja az MCP-kiszolgálót olyan rajzokkal, amelyek nem hagyhatják el a számítógépét.

Hibaelhárítás

A Windows megkérdezi, melyik alkalmazással nyissa meg a qcad.mcpb fájlt

A windowsos Claude Desktop nem tudja dupla kattintással megnyitni a .mcpb fájlokat. Zárja be a párbeszédablakot, és helyette telepítse a fájlt a Claude Desktopban a File > Settings > Extensions > Advanced settings > Install Extension alatt, a fent leírtak szerint.

Claude nem fogadja el a QCAD címét csatlakozóként

A Claude Add custom connector funkciója csak az internetről elérhető kiszolgálókkal működik. A QCAD ehelyett a QCAD-bővítményen keresztül csatlakozik, a fent leírtak szerint.

Claude a “Cannot reach QCAD” hibát jelzi

A bővítmény nem tud csatlakozni a QCAD-hez. Ellenőrizze, hogy:

• a QCAD fut-e
• az MCP-kiszolgáló el lett-e indítva az Egyéb > MCP > Indítás menüponttal
• az Egyéb > MCP > Állapot által mutatott port megegyezik-e a Claude Desktop bővítménybeállításaiban szereplő porttal

A QCAD-et nem kell a Claude Desktop előtt elindítani, és a Claude Desktopot sem kell újraindítani az MCP-kiszolgáló elindítása után. Ha azonban úgy tűnik, hogy Claude nem tud a QCAD-eszközökről, először indítsa el a QCAD-et és annak MCP-kiszolgálóját, majd nyisson egy új csevegést a Claude Desktopban.

A kiszolgáló nem indítható el

Ha az Egyéb > MCP > Indítás azt jelzi, hogy a cím már használatban van, akkor egy másik program vagy egy másik QCAD-ablak már használja a 3907-es portot. Egy adott porton csak egy QCAD-ablak futtathatja az MCP-kiszolgálót. Állítsa le a kiszolgálót a másik QCAD-ablakban az Egyéb > MCP > Leállítás menüponttal, és indítsa el abban az ablakban, amelyben dolgozni szeretne.

Claude rossz rajzon dolgozik

Claude mindig annak a QCAD-példánynak az aktív rajzával dolgozik, amelyik az MCP-kiszolgálót futtatja. Kattintson a QCAD-ben annak a rajznak a fülére vagy ablakára, amellyel Claude-nak dolgoznia kell. Ha több QCAD-példány fut, győződjön meg arról, hogy az MCP-kiszolgáló abban a példányban fut, amelyet éppen néz.

Egy kérés sokáig tart, vagy időtúllépéssel meghiúsul

A QCAD nem tud válaszolni, amíg egy párbeszédablak nyitva van a QCAD-ben. Zárja be a QCAD-ben az összes nyitott párbeszédablakot, és kérdezzen újra. Nagyon nagy rajzok esetén növelje a bővítmény beállításaiban a Reply timeout értékét.