Usar o QCAD com o Claude Desktop

Introdução

O QCAD contém um servidor MCP (Model Context Protocol). O MCP é um padrão aberto que permite que assistentes de IA usem ferramentas fornecidas por outros aplicativos. Com o servidor MCP do QCAD, o aplicativo Claude Desktop pode trabalhar diretamente com o desenho que está aberto no QCAD no momento. Por exemplo, você pode pedir ao Claude para:

descrever um desenho desconhecido, suas camadas, blocos, cotas e textos
verificar se um desenho tem problemas como polilinhas não fechadas, entidades duplicadas ou geometria na camada 0
medir distâncias, comprimentos e áreas
criar uma lista de materiais a partir de referências de bloco
adicionar camadas, linhas, arcos, círculos, polilinhas, textos, cotas e hachuras
mover, girar, escalar, aparar, arredondar cantos ou criar paralelas de entidades existentes
exportar o desenho como PNG, PDF, SVG, DXF ou DWG

Este tutorial explica como conectar o QCAD ao Claude Desktop no Windows ou macOS.

Requisitos

QCAD com o plugin MCP, instalado e em execução no mesmo computador que o Claude Desktop
O aplicativo Claude Desktop para Windows ou macOS

A extensão do QCAD para o Claude Desktop acompanha o QCAD. É o arquivo qcad.mcpb na pasta mcp da sua instalação do QCAD, por exemplo:

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

No macOS, a pasta fica dentro do pacote do aplicativo e não é exibida pelo Finder quando você abre a pasta Applications. No QCAD, Miscelânea > MCP > Instalar no Claude Desktop abre ou mostra o arquivo para você (veja abaixo).

Não é necessário instalar o Node.js separadamente. O Claude Desktop traz tudo o que é necessário para executar a extensão.

Iniciar o servidor MCP no QCAD

O servidor MCP do QCAD não é iniciado automaticamente. Enquanto ele não for iniciado, o QCAD não aceita nenhuma conexão.

Inicie o QCAD.
Escolha Miscelânea > MCP > Iniciar.

A linha de comando na parte inferior da janela do QCAD confirma que o servidor está em execução:

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

O servidor continua em execução até que você escolha Miscelânea > MCP > Parar ou feche o QCAD. Ele precisa ser iniciado novamente toda vez que o QCAD for iniciado.

O menu Miscelânea > MCP também oferece:

Instalar no Claude Desktop: ajuda você a instalar a extensão do QCAD no Claude Desktop (veja abaixo)
Status: mostra na linha de comando se o servidor está em execução e em qual porta
Reiniciar: para e reinicia o servidor, por exemplo, depois de alterar sua porta

O servidor só aceita conexões do mesmo computador (endereço 127.0.0.1). Ele não pode ser acessado a partir de outros computadores da sua rede.

Instalar a extensão do QCAD no Claude Desktop

A extensão é instalada apenas uma vez. Antes de começar, certifique-se de que o Claude Desktop está instalado e de que você está conectado.

A extensão do QCAD é uma extensão local: o Claude Desktop a executa no seu computador, onde ela se conecta ao servidor MCP do QCAD. Não use Add custom connector no Claude para isso. Os conectores personalizados só aceitam servidores acessíveis pela internet por meio de um endereço https, por isso o endereço http://127.0.0.1:3907/mcp do QCAD não é aceito ali.

Windows

No QCAD, escolha Miscelânea > MCP > Instalar no Claude Desktop. O QCAD mostra o arquivo qcad.mcpb selecionado no Explorador de Arquivos. A linha de comando do QCAD também mostra os passos para instalá-lo.
No Claude Desktop, abra o menu no canto superior esquerdo da janela e escolha File > Settings.
Vá para Extensions, abra Advanced settings e clique em Install Extension.
Escolha o arquivo qcad.mcpb, por exemplo, C:\Program Files\QCAD\mcp\qcad.mcpb.

No Windows, não clique duas vezes no arquivo qcad.mcpb nem o arraste para a janela do Claude Desktop. Nenhuma das duas ações instala a extensão: o Claude Desktop não se registra para esse tipo de arquivo, então um clique duplo apenas faz o Windows perguntar com qual aplicativo abrir o arquivo.

macOS

No QCAD, escolha Miscelânea > MCP > Instalar no Claude Desktop. O QCAD abre o arquivo qcad.mcpb diretamente no Claude Desktop.
Se o Claude Desktop não for encontrado, o QCAD mostra o arquivo no Finder. Arraste-o para a janela do Claude Desktop ou escolha Claude > Settings na barra de menus do Claude Desktop, vá para Extensions, abra Advanced settings, clique em Install Extension e escolha o arquivo.

Concluir a instalação

O Claude Desktop mostra os detalhes da extensão do QCAD. Clique em Install e confirme.

Após a instalação, QCAD aparece na lista de extensões em Settings > Extensions. Certifique-se de que ela está ativada.

Configurações da extensão

A extensão do QCAD tem três configurações, que podem ser alteradas no Claude Desktop em Settings > Extensions > QCAD. Normalmente, não é necessário alterar os valores padrão:

QCAD host: o endereço do servidor MCP do QCAD. Mantenha-o em 127.0.0.1.
QCAD MCP port: a porta do servidor MCP do QCAD, por padrão 3907. Ela deve corresponder à porta configurada no QCAD.
Reply timeout (ms): quanto tempo o Claude espera por uma resposta do QCAD, por padrão 60000 ms (um minuto). Aumente esse valor se você trabalhar com desenhos muito grandes.

Trabalhar com o Claude e o QCAD

Abra um desenho no QCAD ou comece com um desenho novo.
Certifique-se de que o servidor MCP está em execução (Miscelânea > MCP > Status).
Abra um novo chat no Claude Desktop e peça o que precisa, por exemplo:

Descreva o desenho que está aberto no QCAD.

Verifique se o desenho no QCAD tem problemas e liste o que encontrar.

Crie uma lista de materiais a partir das referências de bloco do desenho.

Desenhe um retângulo de 100 x 50 mm em uma nova camada "Contorno" e arredonde todos os cantos com um raio de 5 mm.

O Claude decide quais ferramentas do QCAD usar. Na primeira vez que uma ferramenta é usada, o Claude Desktop pede sua permissão. Você pode permitir a ferramenta uma vez ou sempre.

O Claude sempre trabalha com o desenho que está ativo no QCAD no momento. Se vários desenhos estiverem abertos, mude para o desenho certo no QCAD antes de fazer seu pedido.

As alterações feitas pelo Claude aparecem imediatamente na janela do QCAD. Ferramentas que modificam ou excluem entidades existentes, renomeiam camadas ou eliminam camadas e blocos não utilizados apenas informam o que alterariam, a menos que o Claude peça explicitamente que apliquem a alteração. Se quiser revisar uma alteração primeiro, peça ao Claude que mostre o que faria antes de aplicá-la. Toda alteração pode ser desfeita no QCAD com Editar > Desfazer ou pedindo ao Claude que a desfaça.

O Claude também pode olhar o desenho: ele renderiza o desenho como uma imagem para verificar o que ele mostra ou para conferir o resultado de uma alteração.

Modo de voz

O MCP não está disponível no modo de voz do Claude Desktop. As ferramentas do QCAD só podem ser usadas em chats de texto. Para trabalhar com o QCAD, digite seus pedidos em vez de falá-los.

Privacidade

O servidor MCP do QCAD e a extensão só se comunicam entre si no seu próprio computador. No entanto, tudo o que o Claude lê do seu desenho, por exemplo nomes de camadas, textos, cotas e coordenadas, é enviado ao Claude como parte da conversa, como qualquer outro conteúdo que você compartilha em um chat. Não use o servidor MCP com desenhos que não podem sair do seu computador.

Solução de problemas

O Windows pergunta com qual aplicativo abrir qcad.mcpb

O Claude Desktop para Windows não consegue abrir arquivos .mcpb com clique duplo. Feche a caixa de diálogo e, em vez disso, instale o arquivo no Claude Desktop em File > Settings > Extensions > Advanced settings > Install Extension, conforme descrito acima.

O Claude não aceita o endereço do QCAD como conector

Add custom connector no Claude só funciona com servidores acessíveis pela internet. Em vez disso, o QCAD é conectado por meio da extensão do QCAD, conforme descrito acima.

O Claude informa “Cannot reach QCAD”

A extensão não consegue se conectar ao QCAD. Verifique se:

o QCAD está em execução
o servidor MCP foi iniciado com Miscelânea > MCP > Iniciar
a porta mostrada por Miscelânea > MCP > Status corresponde à porta nas configurações da extensão no Claude Desktop

Não é necessário iniciar o QCAD antes do Claude Desktop, nem reiniciar o Claude Desktop depois de iniciar o servidor MCP. No entanto, se o Claude não parecer conhecer as ferramentas do QCAD, inicie primeiro o QCAD e seu servidor MCP e depois abra um novo chat no Claude Desktop.

O servidor não pode ser iniciado

Se Miscelânea > MCP > Iniciar informar que o endereço já está em uso, outro programa ou outra janela do QCAD já está usando a porta 3907. Somente uma janela do QCAD pode executar o servidor MCP em uma determinada porta. Pare o servidor na outra janela do QCAD com Miscelânea > MCP > Parar e inicie-o na janela em que deseja trabalhar.

O Claude trabalha no desenho errado

O Claude sempre trabalha com o desenho ativo da instância do QCAD que executa o servidor MCP. No QCAD, clique na aba ou na janela do desenho com o qual você quer que o Claude trabalhe. Se várias instâncias do QCAD estiverem em execução, certifique-se de que o servidor MCP está em execução na instância que você está vendo.

Um pedido demora muito ou falha por tempo limite esgotado

O QCAD não pode responder enquanto houver uma caixa de diálogo aberta no QCAD. Feche todas as caixas de diálogo abertas no QCAD e pergunte novamente. Para desenhos muito grandes, aumente o Reply timeout nas configurações da extensão.