Używanie QCAD z Claude Desktop

Wprowadzenie

QCAD zawiera serwer MCP (Model Context Protocol). MCP to otwarty standard, który pozwala asystentom AI korzystać z narzędzi udostępnianych przez inne aplikacje. Dzięki serwerowi MCP QCAD aplikacja Claude Desktop może pracować bezpośrednio z rysunkiem, który jest aktualnie otwarty w QCAD. Możesz na przykład poprosić Claude, aby:

• opisał nieznany rysunek, jego warstwy, bloki, wymiary i teksty
• sprawdził rysunek pod kątem problemów, takich jak niezamknięte polilinie, zduplikowane obiekty lub geometria na warstwie 0
• zmierzył odległości, długości i pola powierzchni
• utworzył zestawienie materiałów na podstawie wstawień bloków
• dodał warstwy, linie, łuki, okręgi, polilinie, teksty, wymiary i kreskowania
• przesunął, obrócił, przeskalował, przyciął, zaokrąglił lub odsunął istniejące obiekty
• wyeksportował rysunek jako PNG, PDF, SVG, DXF lub DWG

Ten samouczek wyjaśnia, jak połączyć QCAD z Claude Desktop w systemie Windows lub macOS.

Wymagania

• QCAD z wtyczką MCP, zainstalowany i uruchomiony na tym samym komputerze co Claude Desktop
• Aplikacja Claude Desktop dla systemu Windows lub macOS

Rozszerzenie QCAD dla Claude Desktop jest dostarczane razem z QCAD. Jest to plik qcad.mcpb w folderze mcp instalacji QCAD, na przykład:

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

W systemie macOS folder znajduje się wewnątrz pakietu aplikacji i nie jest wyświetlany przez Findera po otwarciu folderu Applications. Polecenie Różne > MCP > Zainstaluj w Claude Desktop w QCAD otwiera lub pokazuje ten plik automatycznie (patrz niżej).

Node.js nie trzeba instalować osobno. Claude Desktop zawiera wszystko, co jest potrzebne do uruchomienia rozszerzenia.

Uruchamianie serwera MCP w QCAD

Serwer MCP w QCAD nie uruchamia się samoczynnie. Dopóki nie zostanie uruchomiony, QCAD nie przyjmuje żadnych połączeń.

• Uruchom QCAD.
• Wybierz Różne > MCP > Uruchom.

Wiersz poleceń u dołu okna QCAD potwierdza, że serwer działa:

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

Serwer działa, dopóki nie wybierzesz Różne > MCP > Zatrzymaj lub nie zamkniesz QCAD. Trzeba go uruchamiać ponownie przy każdym uruchomieniu QCAD.

Menu Różne > MCP oferuje również:

• Zainstaluj w Claude Desktop: pomaga zainstalować rozszerzenie QCAD w Claude Desktop (patrz niżej)
• Status: wyświetla w wierszu poleceń, czy serwer działa i na którym porcie
• Uruchom ponownie: zatrzymuje i ponownie uruchamia serwer, na przykład po zmianie jego portu

Serwer przyjmuje połączenia tylko z tego samego komputera (adres 127.0.0.1). Nie jest dostępny z innych komputerów w Twojej sieci.

Instalowanie rozszerzenia QCAD w Claude Desktop

Rozszerzenie instaluje się tylko raz. Zanim zaczniesz, upewnij się, że Claude Desktop jest zainstalowany i że jesteś zalogowany.

Rozszerzenie QCAD jest rozszerzeniem lokalnym: Claude Desktop uruchamia je na Twoim komputerze, gdzie łączy się ono z serwerem MCP w QCAD. Nie używaj do tego opcji Add custom connector w Claude. Niestandardowe konektory akceptują tylko serwery dostępne z internetu pod adresem https, dlatego adres http://127.0.0.1:3907/mcp QCAD nie zostanie tam zaakceptowany.

Windows

• W QCAD wybierz Różne > MCP > Zainstaluj w Claude Desktop. QCAD pokazuje zaznaczony plik qcad.mcpb w Eksploratorze plików. Wiersz poleceń w QCAD wyświetla również kroki instalacji.
• W Claude Desktop otwórz menu w lewym górnym rogu okna i wybierz File > Settings.
• Przejdź do Extensions, otwórz Advanced settings i kliknij Install Extension.
• Wybierz plik qcad.mcpb, na przykład C:\Program Files\QCAD\mcp\qcad.mcpb.

W systemie Windows nie klikaj dwukrotnie pliku qcad.mcpb i nie przeciągaj go do okna Claude Desktop. Żaden z tych sposobów nie instaluje rozszerzenia: Claude Desktop nie rejestruje się dla tego typu plików, więc po dwukrotnym kliknięciu Windows jedynie pyta, za pomocą której aplikacji otworzyć plik.

macOS

• W QCAD wybierz Różne > MCP > Zainstaluj w Claude Desktop. QCAD otwiera plik qcad.mcpb bezpośrednio w Claude Desktop.
• Jeśli nie można znaleźć Claude Desktop, QCAD pokazuje zamiast tego plik w Finderze. Przeciągnij go do okna Claude Desktop albo wybierz Claude > Settings z paska menu Claude Desktop, przejdź do Extensions, otwórz Advanced settings, kliknij Install Extension i wybierz plik.

Kończenie instalacji

Claude Desktop wyświetla szczegóły rozszerzenia QCAD. Kliknij Install i potwierdź.

Po instalacji QCAD pojawia się na liście rozszerzeń w Settings > Extensions. Upewnij się, że jest włączone.

Ustawienia rozszerzenia

Rozszerzenie QCAD ma trzy ustawienia, które można zmienić w Claude Desktop w sekcji Settings > Extensions > QCAD. Zazwyczaj nie trzeba zmieniać wartości domyślnych:

• QCAD host: adres serwera MCP QCAD. Pozostaw wartość 127.0.0.1.
• QCAD MCP port: port serwera MCP QCAD, domyślnie 3907. Musi on być zgodny z portem skonfigurowanym w QCAD.
• Reply timeout (ms): jak długo Claude czeka na odpowiedź od QCAD, domyślnie 60000 ms (jedna minuta). Zwiększ tę wartość, jeśli pracujesz z bardzo dużymi rysunkami.

Praca z Claude i QCAD

• Otwórz rysunek w QCAD lub zacznij od nowego rysunku.
• Upewnij się, że serwer MCP działa (Różne > MCP > Status).
• Otwórz nowy czat w Claude Desktop i poproś o to, czego potrzebujesz, na przykład:

Opisz rysunek, który jest otwarty w QCAD.

Sprawdź rysunek w QCAD pod kątem problemów i wypisz, co znajdziesz.

Utwórz zestawienie materiałów na podstawie wstawień bloków w rysunku.

Narysuj prostokąt 100 x 50 mm na nowej warstwie "Obrys" i zaokrąglij wszystkie narożniki promieniem 5 mm.

Claude decyduje, których narzędzi QCAD użyć. Przy pierwszym użyciu narzędzia Claude Desktop prosi o Twoją zgodę. Możesz zezwolić na użycie narzędzia jednorazowo lub zawsze.

Claude zawsze pracuje z rysunkiem, który jest aktualnie aktywny w QCAD. Jeśli otwartych jest kilka rysunków, przed zadaniem pytania przełącz się w QCAD na właściwy rysunek.

Zmiany wprowadzone przez Claude pojawiają się natychmiast w oknie QCAD. Narzędzia, które modyfikują lub usuwają istniejące obiekty, zmieniają nazwy warstw lub usuwają nieużywane warstwy i bloki, jedynie informują, co by zmieniły, chyba że Claude wyraźnie poprosi je o zastosowanie zmiany. Jeśli chcesz najpierw przejrzeć zmianę, poproś Claude, aby przed jej zastosowaniem pokazał, co zamierza zrobić. Każdą zmianę można cofnąć w QCAD za pomocą Edytuj > Cofnij lub prosząc Claude o jej cofnięcie.

Claude może również obejrzeć rysunek: renderuje go jako obraz, aby sprawdzić, co przedstawia, lub zweryfikować wynik zmiany.

Tryb głosowy

MCP nie jest dostępny w trybie głosowym Claude Desktop. Narzędzi QCAD można używać tylko w czatach tekstowych. Aby pracować z QCAD, wpisuj swoje polecenia zamiast je wypowiadać.

Prywatność

Serwer MCP QCAD i rozszerzenie komunikują się ze sobą wyłącznie na Twoim komputerze. Jednak wszystko, co Claude odczyta z Twojego rysunku, na przykład nazwy warstw, teksty, wymiary i współrzędne, jest wysyłane do Claude jako część rozmowy, tak jak każda inna treść udostępniana w czacie. Nie używaj serwera MCP z rysunkami, które nie mogą opuścić Twojego komputera.

Rozwiązywanie problemów

Windows pyta, jaką aplikacją otworzyć qcad.mcpb

Claude Desktop dla systemu Windows nie potrafi otwierać plików .mcpb dwukrotnym kliknięciem. Zamknij okno dialogowe i zamiast tego zainstaluj plik w Claude Desktop w File > Settings > Extensions > Advanced settings > Install Extension, jak opisano powyżej.

Claude nie akceptuje adresu QCAD jako konektora

Add custom connector w Claude działa tylko z serwerami dostępnymi z internetu. QCAD łączy się natomiast przez rozszerzenie QCAD, jak opisano powyżej.

Claude zgłasza “Cannot reach QCAD”

Rozszerzenie nie może połączyć się z QCAD. Sprawdź, czy:

• QCAD jest uruchomiony
• serwer MCP został uruchomiony za pomocą Różne > MCP > Uruchom
• port wyświetlany przez Różne > MCP > Status jest zgodny z portem w ustawieniach rozszerzenia w Claude Desktop

QCAD nie musi być uruchomiony przed Claude Desktop, a Claude Desktop nie trzeba uruchamiać ponownie po uruchomieniu serwera MCP. Jeśli jednak Claude zdaje się nie wiedzieć o narzędziach QCAD, najpierw uruchom QCAD i jego serwer MCP, a następnie otwórz nowy czat w Claude Desktop.

Nie można uruchomić serwera

Jeśli Różne > MCP > Uruchom zgłasza, że adres jest już w użyciu, port 3907 jest już używany przez inny program lub inne okno QCAD. Tylko jedno okno QCAD może uruchomić serwer MCP na danym porcie. Zatrzymaj serwer w drugim oknie QCAD za pomocą Różne > MCP > Zatrzymaj i uruchom go w oknie, w którym chcesz pracować.

Claude pracuje na niewłaściwym rysunku

Claude zawsze pracuje z aktywnym rysunkiem tej instancji QCAD, w której działa serwer MCP. Kliknij w QCAD kartę lub okno rysunku, z którym ma pracować Claude. Jeśli uruchomionych jest kilka instancji QCAD, upewnij się, że serwer MCP działa w instancji, którą masz przed sobą.

Żądanie trwa długo lub kończy się przekroczeniem limitu czasu

QCAD nie może odpowiedzieć, gdy w QCAD jest otwarte okno dialogowe. Zamknij wszystkie otwarte okna dialogowe w QCAD i zapytaj ponownie. W przypadku bardzo dużych rysunków zwiększ wartość Reply timeout w ustawieniach rozszerzenia.