Conecte seu CAD às ferramentas de IA.

MCP · CLI v0.22.0 · 2026-10-28

Uma conexão MCP sem interface verificada

Um cliente Node.js JSON-RPC criou na CLI oficial um bloco de 40 × 30 × 10 mm (12.000 mm³). Com part_length = 50 mm, o volume passou a 15.000 mm³. O parâmetro permaneceu editável após reabrir o nativo; o STEP reaberto manteve dimensões e volume.

A configuração usa CLI v0.22.0 com --headless explícito. Nessa versão, mcp sozinho pode se conectar automaticamente ao aplicativo desktop aberto. A ponte desktop usa --connect. Em CLIs antigas, confira mcp --help antes de usar a opção.

CLI v0.22.0 · GitHub Release ↗

As seis verificações usam um bloco na CLI v0.22.0 no macOS x64. O parâmetro do arquivo nativo foi alterado após a reabertura. STEP foi reaberto na mesma CLI: verifica-se a geometria desse bloco, não o histórico original nem uma migração com Fusion, FreeCAD ou SOLIDWORKS. Interfaces Claude e ponte desktop não foram testadas.

Criar, alterar, salvar e exportar um modelo real

Inicie uma sessão headless separada com a CLI indicada, inicialize MCP e liste as ferramentas. Crie uma pasta dedicada e autorize-a com --allow-path na configuração do servidor. Substitua <practice-folder> pelo caminho absoluto da pasta. Os JSON são argumentos de tools/call, não configurações do servidor nem prompts em linguagem natural.

1. 1. Criar um bloco com part_length = 40 mm

   40 × 30 × 10 mm · 12.000 mm³

   Mostrar chamadas de ferramentas utilizadas

   [
     {
       "name": "execute",
       "arguments": {
         "command": "file.new",
         "params": {
           "name": "MCP practice"
         }
       }
     },
     {
       "name": "set_parameter",
       "arguments": {
         "name": "part_length",
         "value": "40 mm"
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "solid.box",
         "params": {
           "length": "part_length",
           "width": 30,
           "height": 10
         }
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

2. 2. Alterar part_length para 50 mm e medir

   50 × 30 × 10 mm · 15.000 mm³

   Mostrar chamadas de ferramentas utilizadas

   [
     {
       "name": "set_parameter",
       "arguments": {
         "name": "part_length",
         "value": "50 mm"
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

3. 3. Salvar o nativo, criar novo projeto e reabrir

   50 × 30 × 10 mm · 15.000 mm³

   Mostrar chamadas de ferramentas utilizadas

   [
     {
       "name": "execute",
       "arguments": {
         "command": "file.save",
         "params": {
           "path": "<practice-folder>/mcp-box.solidcraft"
         }
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "file.new",
         "params": {
           "name": "Reopen check"
         }
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "doc.open",
         "params": {
           "path": "<practice-folder>/mcp-box.solidcraft"
         }
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

4. 4. Alterar o parâmetro reaberto e conferir a geometria

   40 × 30 × 10 mm · 12.000 mm³

   Mostrar chamadas de ferramentas utilizadas

   [
     {
       "name": "set_parameter",
       "arguments": {
         "name": "part_length",
         "value": "40 mm"
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

5. 5. Restaurar 50 mm e medir

   50 × 30 × 10 mm · 15.000 mm³

   Mostrar chamadas de ferramentas utilizadas

   [
     {
       "name": "set_parameter",
       "arguments": {
         "name": "part_length",
         "value": "50 mm"
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

6. 6. Salvar, exportar STEP e reabrir em novo projeto

   50 × 30 × 10 mm · 15.000 mm³

   Mostrar chamadas de ferramentas utilizadas

   [
     {
       "name": "execute",
       "arguments": {
         "command": "file.save",
         "params": {
           "path": "<practice-folder>/mcp-box.solidcraft"
         }
       }
     },
     {
       "name": "export",
       "arguments": {
         "path": "<practice-folder>/mcp-box.step",
         "format": "step"
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "file.new",
         "params": {
           "name": "STEP reopen check"
         }
       }
     },
     {
       "name": "execute",
       "arguments": {
         "command": "doc.open",
         "params": {
           "path": "<practice-folder>/mcp-box.step"
         }
       }
     },
     {
       "name": "inspect_design",
       "arguments": {
         "measure": true,
         "sketches": false
       }
     }
   ]

Referência MCP oficial · versão verificada ↗

Se a conexão não iniciar

1. Execute mcp --help. Use o caminho absoluto do executável se o cliente não o encontrar.
2. Confira a inicialização e tools/list antes dos comandos de modelagem. Respostas de protocolo vão para stdout; diagnósticos, para stderr.
3. Para salvar, crie uma pasta específica e passe --allow-path com o caminho absoluto. O teste só permite acesso à sua própria pasta temporária.