Používání QCAD s Claude Desktop

Úvod

QCAD obsahuje server MCP (Model Context Protocol). MCP je otevřený standard, který umožňuje asistentům umělé inteligence používat nástroje poskytované jinými aplikacemi. Díky serveru MCP v QCAD může aplikace Claude Desktop pracovat přímo s výkresem, který je právě otevřený v QCAD. Můžete například Clauda požádat, aby:

• popsal neznámý výkres, jeho hladiny, bloky, kóty a texty
• zkontroloval výkres, zda neobsahuje problémy, jako jsou neuzavřené křivky, duplicitní prvky nebo geometrie v hladině 0
• změřil vzdálenosti, délky a plochy
• vytvořil kusovník z referencí bloků
• přidal hladiny, úsečky, oblouky, kružnice, křivky, texty, kóty a šrafy
• přesunul, otočil, změnil měřítko, ořízl, zaoblil nebo odsadil existující prvky
• exportoval výkres jako PNG, PDF, SVG, DXF nebo DWG

Tento návod vysvětluje, jak propojit QCAD s Claude Desktop ve Windows nebo macOS.

Požadavky

• QCAD s pluginem MCP, nainstalovaný a spuštěný na stejném počítači jako Claude Desktop
• Aplikace Claude Desktop pro Windows nebo macOS

Rozšíření QCAD pro Claude Desktop je dodáváno s QCAD. Jedná se o soubor qcad.mcpb ve složce mcp vaší instalace QCAD, například:

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

V systému macOS se složka nachází uvnitř balíčku aplikace a Finder ji při otevření složky Applications nezobrazuje. Příkaz Různé > MCP > Instalovat do Claude Desktop v QCAD vám soubor otevře nebo zobrazí (viz níže).

Node.js není třeba instalovat zvlášť. Claude Desktop obsahuje vše, co je ke spuštění rozšíření potřeba.

Spuštění serveru MCP v QCAD

Server MCP v QCAD se nespouští sám. Dokud není spuštěn, QCAD nepřijímá žádná připojení.

• Spusťte QCAD.
• Zvolte Různé > MCP > Spustit.

Příkazový řádek v dolní části okna QCAD potvrdí, že server běží:

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

Server běží, dokud nezvolíte Různé > MCP > Zastavit nebo neukončíte QCAD. Při každém spuštění QCAD je nutné jej spustit znovu.

Nabídka Různé > MCP dále nabízí:

• Instalovat do Claude Desktop: pomůže vám nainstalovat rozšíření QCAD do Claude Desktop (viz níže)
• Stav: zobrazí na příkazovém řádku, zda server běží a na kterém portu
• Restartovat: zastaví a znovu spustí server, například po změně jeho portu

Server přijímá pouze připojení ze stejného počítače (adresa 127.0.0.1). Z jiných počítačů ve vaší síti není dostupný.

Instalace rozšíření QCAD do Claude Desktop

Rozšíření se instaluje pouze jednou. Než začnete, ujistěte se, že je Claude Desktop nainstalován a že jste přihlášeni.

Rozšíření QCAD je lokální rozšíření: Claude Desktop ho spouští na vašem počítači, kde se připojuje k serveru MCP v QCAD. Nepoužívejte k tomu v Claude funkci Add custom connector. Vlastní konektory přijímají pouze servery dostupné z internetu přes adresu https, takže adresa http://127.0.0.1:3907/mcp QCAD tam není přijata.

Windows

• V QCAD zvolte Různé > MCP > Instalovat do Claude Desktop. QCAD zobrazí soubor qcad.mcpb vybraný v Průzkumníku souborů. Příkazový řádek v QCAD navíc zobrazí postup instalace.
• V Claude Desktop otevřete nabídku vlevo nahoře v okně a zvolte File > Settings.
• Přejděte do Extensions, otevřete Advanced settings a klikněte na Install Extension.
• Vyberte soubor qcad.mcpb, například C:\Program Files\QCAD\mcp\qcad.mcpb.

Ve Windows na soubor qcad.mcpb nepoklepávejte a nepřetahujte jej do okna Claude Desktop. Ani jedním z těchto způsobů se rozšíření nenainstaluje: Claude Desktop se pro tento typ souboru neregistruje, takže se systém Windows po poklepání pouze zeptá, kterou aplikací má být soubor otevřen.

macOS

• V QCAD zvolte Různé > MCP > Instalovat do Claude Desktop. QCAD otevře soubor qcad.mcpb přímo v Claude Desktop.
• Pokud Claude Desktop nelze najít, QCAD místo toho zobrazí soubor ve Finderu. Přetáhněte jej do okna Claude Desktop, nebo na řádku nabídek Claude Desktop zvolte Claude > Settings, přejděte do Extensions, otevřete Advanced settings, klikněte na Install Extension a vyberte soubor.

Dokončení instalace

Claude Desktop zobrazí podrobnosti o rozšíření QCAD. Klikněte na Install a potvrďte.

Po instalaci se QCAD zobrazí v seznamu rozšíření v Settings > Extensions. Ujistěte se, že je povoleno.

Nastavení rozšíření

Rozšíření QCAD má tři nastavení, která lze změnit v Claude Desktop v části Settings > Extensions > QCAD. Výchozí hodnoty obvykle není třeba měnit:

• QCAD host: adresa serveru MCP v QCAD. Ponechte hodnotu 127.0.0.1.
• QCAD MCP port: port serveru MCP v QCAD, výchozí hodnota je 3907. Musí odpovídat portu nastavenému v QCAD.
• Reply timeout (ms): jak dlouho Claude čeká na odpověď od QCAD, výchozí hodnota je 60000 ms (jedna minuta). Pokud pracujete s velmi velkými výkresy, tuto hodnotu zvyšte.

Práce s Claudem a QCAD

• Otevřete výkres v QCAD nebo začněte s novým výkresem.
• Ujistěte se, že server MCP běží (Různé > MCP > Stav).
• Otevřete v Claude Desktop nový chat a požádejte o to, co potřebujete, například:

Popiš výkres, který je otevřený v QCAD.

Zkontroluj výkres v QCAD, zda neobsahuje problémy, a vypiš, co najdeš.

Vytvoř kusovník z referencí bloků ve výkresu.

Nakresli obdélník 100 x 50 mm v nové hladině "Obrys" a zaobli všechny rohy poloměrem 5 mm.

Claude rozhoduje, které nástroje QCAD použije. Při prvním použití nástroje vás Claude Desktop požádá o svolení. Nástroj můžete povolit jednou nebo vždy.

Claude vždy pracuje s výkresem, který je v QCAD právě aktivní. Pokud je otevřeno více výkresů, přepněte se před zadáním požadavku v QCAD na správný výkres.

Změny provedené Claudem se okamžitě zobrazí v okně QCAD. Nástroje, které upravují nebo mažou existující prvky, přejmenovávají hladiny nebo odstraňují nepoužívané hladiny a bloky, pouze oznámí, co by změnily, pokud je Claude výslovně nepožádá o provedení změny. Pokud si chcete změnu nejprve zkontrolovat, požádejte Clauda, aby vám před jejím provedením ukázal, co by udělal. Každou změnu lze v QCAD vrátit zpět pomocí Upravit > Zpět nebo tak, že o to Clauda požádáte.

Claude se také může na výkres podívat: vykreslí výkres jako obrázek, aby zkontroloval, co zobrazuje, nebo ověřil výsledek změny.

Hlasový režim

MCP není v hlasovém režimu Claude Desktop k dispozici. Nástroje QCAD lze používat pouze v textových chatech. Chcete-li pracovat s QCAD, požadavky pište, místo abyste je vyslovovali.

Ochrana soukromí

Server MCP v QCAD a rozšíření spolu komunikují pouze na vašem vlastním počítači. Vše, co Claude z vašeho výkresu přečte, například názvy hladin, texty, kóty a souřadnice, se však odesílá Claudovi jako součást konverzace, stejně jako jakýkoli jiný obsah, který v chatu sdílíte. Nepoužívejte server MCP s výkresy, které nesmějí opustit váš počítač.

Řešení problémů

Systém Windows se ptá, jakou aplikací otevřít qcad.mcpb

Claude Desktop pro Windows neumí otevírat soubory .mcpb poklepáním. Zavřete dialog a místo toho nainstalujte soubor v Claude Desktop přes File > Settings > Extensions > Advanced settings > Install Extension, jak je popsáno výše.

Claude nepřijímá adresu QCAD jako konektor

Add custom connector v Claude funguje pouze se servery dostupnými z internetu. QCAD se místo toho připojuje prostřednictvím rozšíření QCAD, jak je popsáno výše.

Claude hlásí “Cannot reach QCAD”

Rozšíření se nemůže připojit k QCAD. Zkontrolujte, zda:

• QCAD běží
• server MCP byl spuštěn pomocí Různé > MCP > Spustit
• port zobrazený příkazem Různé > MCP > Stav odpovídá portu v nastavení rozšíření v Claude Desktop

QCAD není nutné spouštět před Claude Desktop a Claude Desktop není nutné po spuštění serveru MCP restartovat. Pokud se však zdá, že Claude o nástrojích QCAD neví, spusťte nejprve QCAD a jeho server MCP a poté otevřete v Claude Desktop nový chat.

Server nelze spustit

Pokud Různé > MCP > Spustit hlásí, že adresa je již používána, port 3907 již používá jiný program nebo jiné okno QCAD. Server MCP může na daném portu provozovat pouze jedno okno QCAD. Zastavte server v druhém okně QCAD pomocí Různé > MCP > Zastavit a spusťte jej v okně, ve kterém chcete pracovat.

Claude pracuje s nesprávným výkresem

Claude vždy pracuje s aktivním výkresem té instance QCAD, ve které běží server MCP. Klikněte v QCAD na kartu nebo okno výkresu, se kterým má Claude pracovat. Pokud běží více instancí QCAD, ujistěte se, že server MCP běží v instanci, na kterou se díváte.

Požadavek trvá dlouho nebo selže kvůli vypršení časového limitu

QCAD nemůže odpovědět, dokud je v QCAD otevřené dialogové okno. Zavřete všechna otevřená dialogová okna v QCAD a zeptejte se znovu. U velmi velkých výkresů zvyšte v nastavení rozšíření hodnotu Reply timeout.