Conectar o Claude Desktop ou o Codex via MCP
Atualizado em 16 de nov. de 2026 · 4 min de leitura
Deixe o Claude Desktop ou o Codex pesquisar a sua biblioteca de modelos 3D via MCP: ative em Settings → Integrations, escolha o que cada um enxerga e cole a configuração dele.
O Meshory tem um servidor MCP integrado, então um assistente de IA neste computador pode pesquisar a sua biblioteca de modelos 3D e responder perguntas sobre ela: o que você tem, quais modelos ainda não têm tags, o que está em uma lista de impressão. O Claude Desktop e o Codex são os apps que as configurações citam. Cada assistente recebe a própria conexão, que enxerga só as fontes, pastas e coleções que você compartilha, e nada que ele sugira altera a sua biblioteca até você aprovar.
As conexões de assistentes chegam na versão do Meshory depois da 1.13.0. Elas exigem uma licença ativada, e o Meshory precisa estar aberto enquanto o assistente o usa.
Adicionar uma conexão
- 1Abra Settings → Integrations e escolha a aba Local.
- 2Ative Enable MCP. Ele vem desativado por padrão.
- 3Digite um nome, como Claude Desktop, em New connection name e clique em Add connection. Adicione uma conexão por app, para que cada um tenha o próprio acesso.
- 4Em Shared sources, folders and collections, escolha o que o assistente pode ver. As seleções se combinam, e uma pasta inclui todas as pastas dentro dela.
- 5Em What it can do, marque o que o assistente pode ler e o que ele pode propor. Library details (model names, descriptions and tags) é a base de que toda conexão precisa.
- 6Ative Enable connection e clique em Save connection.
- 7Em Set up in your app, clique em Copy configuration e depois adicione a configuração ao assistente, como descrito abaixo.
Claude Desktop
No Claude Desktop, abra Settings → Developer e clique em Edit Config, que abre o claude_desktop_config.json. Cole a configuração JSON que o Meshory copiou. Se o arquivo já lista outros servidores, adicione a entrada meshory dentro do bloco mcpServers existente, sem substituir o arquivo. Salve, saia do Claude Desktop e abra-o de novo.
Codex
Mude a configuração para Codex TOML, clique em Copy configuration e cole no config.toml da sua pasta .codex (~/.codex/config.toml no macOS e no Linux), criando o arquivo se ele não existir. Inicie uma nova sessão do Codex para carregá-lo.
Nos dois casos, a configuração inicia o meshory-bridge, um pequeno auxiliar instalado com o Meshory. O assistente o executa neste computador, e ele fala direto com o app Meshory em execução, não pela internet.
Status da conexão
- Connected: o assistente está usando a conexão agora.
- Ready: configurada e à espera. O Meshory precisa estar aberto quando o assistente o chamar.
- Needs setup: selecione um escopo disponível e ative o compartilhamento de metadados, por exemplo depois que uma pasta compartilhada foi removida.
- Setup failed: salve a conexão de novo para tentar outra vez.
- Disabled: a conexão está desligada.
O que um assistente pode fazer
What it can do tem duas colunas. Can read deixa o assistente ver algo; Can propose deixa que ele sugira uma alteração que fica esperando por você. Deixe todas as caixas de Can propose vazias e a conexão será somente leitura.
- Library details: pesquisar os modelos compartilhados por palavra-chave, inclusive os que estão dentro de arquivos compactados, e ler nomes, descrições e tags. Com Allow proposed changes, ele pode sugerir tags e coleções.
- Favourites: ver quais modelos são favoritos e sugerir alterações.
- Print lists: ler as listas que você escolher e sugerir novas listas ou edições. Criar uma lista nunca inicia uma impressão.
- Conversions: ler perfis de conversão e sugerir a conversão de um projeto 3MF em um novo 3MF, gravado somente nas pastas de saída que você permitir.
- Slicer: sugerir a abertura de um arquivo convertido no seu fatiador. Isso precisa de aprovação própria e nunca inicia a impressão.
- Jobs: ler o status de conversões e envios ao fatiador e pedir o cancelamento de um deles.
- Reports: ler insights da biblioteca, resumos de integridade e estimativas de impressão salvas. Os relatórios nunca escaneiam arquivos nem iniciam o fatiamento.
Toda sugestão fica em Settings → Integrations → Approvals até você aprovar ou rejeitar: veja Aprovar o que um assistente sugere. Conversões e envios ao fatiador estão em Jobs de assistentes.
O que sai do seu computador
O Meshory dá ao assistente detalhes dos modelos, nunca os arquivos: nomes, descrições e tags do que você compartilhou, além dos favoritos, listas de impressão e relatórios que você permitiu. O assistente repassa o que lê ao serviço de IA por trás dele, a Anthropic no Claude Desktop e a OpenAI no Codex, sob os termos desse serviço. O Meshory não envia nada a esses serviços por conta própria.
O compartilhamento restringe o que uma conexão enxerga por meio do Meshory. Não é um sandbox: outros programas executados como você neste computador ainda podem acessar os seus arquivos locais.
Alterar ou remover uma conexão
As edições valem quando você clica em Save connection, e restringir o que está compartilhado vale na hora. Remove connection… encerra o acesso na hora; para usar esse app de novo, adicione uma nova conexão e cole a nova configuração. Você pode ter até 32 conexões locais.
Próximos passos
Ainda com problemas? Pergunte no Discord