solidcraft-cli mcp é um servidor Model Context Protocol via stdio. Os agentes executam os mesmos comandos do motor que a barra de ferramentas, os scripts e a CLI — criar esboços e recursos, definir parâmetros, medir, tirar capturas de tela, exportar STEP/STL, desfazer/refazer — sem abrir diálogos.
solidcraft --control PORT, para você acompanhar tudo.# Headless
solidcraft-cli mcp
# Headless a partir de um projeto ou script
solidcraft-cli mcp --in part.solidcraft
# Conectado ao aplicativo em execução
solidcraft --control 7878 &
solidcraft-cli mcp --connect 127.0.0.1:7878
Em instalações via Snap, a CLI se chama solidcraft.cli.
SOLIDCRAFT_CONTROL_TOKEN em vez de --token — os argumentos de linha de comando aparecem na lista de processos (documentação oficial).solidcraft-cli para MCPO AppImage para Linux executa o binário da interface gráfica (solidcraft). Ele não expõe mcp como CLI. O servidor MCP fica como solidcraft-cli dentro do squashfs do AppImage — extraia-o ou use o .tar.gz/.deb, que trazem as duas ferramentas. Passos verificados, matriz de pacotes e configurações com caminho absoluto para Claude Code / Desktop / Cursor:
Guia de CLI e MCP no AppImage →
Conforme a documentação oficial de MCP:
claude mcp add solidcraft -- solidcraft-cli mcp
Ou no .mcp.json do projeto:
{
"mcpServers": {
"solidcraft": { "command": "solidcraft-cli", "args": ["mcp"] }
}
}
Exemplo oficial para o claude_desktop_config.json:
{
"mcpServers": {
"solidcraft": {
"command": "/path/to/solidcraft-cli",
"args": ["mcp", "--connect", "127.0.0.1:7878"]
}
}
}
Antes, inicie o aplicativo com solidcraft --control 7878.
~/.codex/config.toml (ou em .codex/config.toml do projeto, em projetos confiáveis), compartilhado pela CLI do Codex, pela extensão de IDE e pelo aplicativo desktop.Adicione o servidor headless com um único comando:
codex mcp add solidcraft -- solidcraft-cli mcp
codex mcp list # confere se foi registrado
Ou edite o ~/.codex/config.toml manualmente, por exemplo para se conectar a um aplicativo em execução e liberar uma pasta de projetos:
[mcp_servers.solidcraft]
command = "solidcraft-cli"
args = ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "/absolute/path/to/your/designs"]
Na interface de terminal do Codex, /mcp mostra os servidores ativos. Use o caminho completo do binário se o solidcraft-cli não estiver no PATH (Snap: solidcraft.cli; no AppImage, veja onde fica a CLI). Além disso, o painel Chat com agente do próprio SolidCraft pode rodar o Codex via npm install -g @agentclientprotocol/codex-acp (documentação oficial).
.cursor/mcp.json ou ~/.cursor/mcp.json). Depois de recarregar, confira se as ferramentas aparecem nas configurações de MCP do Cursor.{
"mcpServers": {
"solidcraft": {
"type": "stdio",
"command": "solidcraft-cli",
"args": ["mcp", "--allow-path", "/absolute/path/to/your/designs"]
}
}
}
Use o caminho completo do binário se o Cursor não encontrar o solidcraft-cli no PATH. No Snap: solidcraft.cli.
| Ferramenta | Função |
|---|---|
list_commands | Catálogo de comandos |
execute / batch | Executa comandos de modelagem (o batch pode reverter tudo em caso de erro) |
inspect_design / measure / body_topology | Lê a geometria e a linha do tempo |
set_parameter | Cria/altera parâmetros e recalcula |
screenshot | PNG do modelo ou da janela |
export | STEP, 3MF, STL, OBJ, URDF, … |
open / save / new_design | Ciclo de vida do documento |
undo / redo | Histórico |
crash_reports | Lista os relatórios de falha deste computador ou abre um pelo id (backtrace e comandos recentes) |
Ainda não está na 0.16.2: o branch principal (main) do projeto já documenta duas novidades que devem chegar com a próxima versão. Uma ferramenta somente leitura, describe_command, retorna a documentação dos parâmetros de um comando e, quando o comando tem um contrato tipado (por enquanto solid.box, solid.extrude e engine.describe), os esquemas JSON (JSON Schema) das suas entradas e do seu resultado. As sessões headless também ganham --param-check off|warn|strict: off é o padrão, warn executa a chamada, mas anexa avisos, como o de uma chave provavelmente digitada errado, e strict rejeita a chamada e deixa o projeto intacto. Chamadas encaminhadas ao aplicativo em execução ainda não são verificadas. Fonte: docs/mcp.md.
Skills opcionais para agentes ficam em skills/ no repositório (solidcraft-modeling, solidcraft-editing etc.).
Por padrão, as ferramentas só mexem em:
--allow-path DIR que você adicionar.solidcraft-cli mcp --allow-path ~/designs --allow-path ~/exports
--allow-any-path remove o limite (comportamento anterior) — use com cuidado.
Fluxo conceitual baseado na sessão de exemplo da documentação oficial:
batch: retângulo no esboço → extrusão → concordância → furomeasure: volume / áreascreenshot com view: "iso"export para um caminho dentro de uma pasta permitidaScripts de demonstração: examples/demo/enclosure_mcp.py monta um gabinete via MCP.
Veja também: comparativo de servidores MCP de CAD · guia de instalação · exemplos.