MCP do Configurador de Produtos: conecte Claude, Cursor e VS Code ao Simplio3D

Pergunte hoje a um assistente de IA sobre o seu configurador de produtos e ele responderá com base no que você colar no chat: uma captura de ecrã, uma lista de opções, um preço que você digitou. Os conectores MCP eliminam essa etapa. Um conector dá ao assistente uma ligação direta e autorizada à sua conta Simplio3D, para que ele leia o projeto real (os blocos de opções, as regras condicionais, a fórmula de preços, os nomes das peças no modelo 3D) e responda com base nisso.

Este guia explica o que é um conector MCP, o que um agente conectado pode e não pode fazer no Simplio3D, como as alterações de risco permanecem sob o seu controlo e como conectar Claude, Cursor ou VS Code.

O que são conectores MCP?

O Model Context Protocol (MCP) é um padrão aberto para conectar assistentes de IA a ferramentas e dados externos. Tem dois lados. Um cliente MCP é a ferramenta de IA que você já utiliza, como Claude, Cursor ou VS Code. Um servidor MCP é o sistema ao qual o assistente se conecta: ele disponibiliza uma lista de ferramentas, cada uma com uma descrição e um esquema, que o assistente pode chamar quando uma pergunta precisa delas.

Um conector é a ligação entre os dois: o endereço do servidor, juntamente com uma credencial que define quem está a conectar-se e ao que pode aceder. Claude chama-lhe um conector personalizado; outros clientes chamam-lhe uma entrada de servidor MCP. Para Simplio3D, são sempre as mesmas duas coisas:

• O endpoint: https://app.simplio3d.ai/mcp
• Uma credencial: um início de sessão OAuth que você aprova num ecrã de consentimento Simplio3D, ou um token de ligação que você cria em Painel → Integrações → Ligações de IA.

Depois de conectado, o assistente vê as ferramentas do Simplio3D juntamente com as suas próprias e decide quando chamá-las com base no que você pedir.

O que um agente conectado pode fazer no Simplio3D

O servidor MCP Simplio3D disponibiliza 123 ferramentas: 52 de leitura, 68 de escrita num modelo de escrita controlada e 3 que executam fluxos de trabalho de agentes. Juntas, abrangem projetos, inspeção de modelos 3D, materiais, blocos de opções, lógica condicional, preços, formulários, pedidos de orçamento e ligações a lojas. Na prática, um agente conectado pode:

• Ler um projeto real: os seus modelos, blocos de opções e variantes, materiais, regras condicionais, blocos e fórmulas de preços e campos de formulários.
• Analisar o modelo 3D: nomes e hierarquia das peças, para verificar se cada opção continua a apontar para uma malha existente.
• Auditar um configurador: alvos de peças em falta, materiais eliminados, regras que nunca podem ser acionadas e variantes sem preço.
• Explicar a lógica e calcular o preço de uma configuração: qual regra oculta uma opção e quanto custa um determinado conjunto de seleções, com cálculo no servidor.
• Criar e editar: criar projetos, blocos de opções, variantes, materiais, regras condicionais e campos de formulários, e organizar o que já existe.
• Executar fluxos de trabalho de agentes: iniciar uma tarefa de várias etapas, como uma auditoria de projeto ou uma reparação segura, responder às suas perguntas e acompanhar o progresso. Os fluxos de trabalho pausam para a sua aprovação e nunca publicam.
• Resumir contactos: ler os pedidos de orçamento recebidos e o que cada cliente configurou.
• Responder a perguntas sobre produtos com base na documentação: pesquisar a documentação oficial do Simplio3D e citar a página, em vez de responder de memória.

Todas as ferramentas, incluindo o âmbito de que necessitam e se leem ou escrevem, estão listadas na referência de ferramentas MCP.

O que não pode fazer

Algumas ações permanecem inacessíveis, independentemente dos âmbitos que conceda. Um agente conectado não pode publicar um projeto, criar uma ligação de partilha nem alterar as definições de incorporação. Não pode carregar ficheiros nem eliminar um projeto. Não pode ligar ou desligar uma loja Shopify ou WooCommerce, nem ler as credenciais dessa loja. E nunca recebe acesso à base de dados, chaves API, segredos de webhook ou palavras-passe de visualizações partilhadas: as ferramentas devolvem resumos selecionados, não registos em bruto.

Âmbitos: dê a cada ligação apenas o que ela precisa

Uma ligação só pode ver e chamar as ferramentas abrangidas pelos seus âmbitos. Comece apenas com leitura e adicione um âmbito de escrita de cada vez, conforme a tarefa exigir.

Várias ligações pequenas são mais seguras do que uma única que pode fazer tudo. Dê ao assistente que analisa preços a sua própria ligação com âmbitos de leitura mais escrita de preços, e ao que cria projetos outra ligação. Assim, revogar uma nunca interrompe a outra.

Como as alterações permanecem sob o seu controlo

Permitir que uma IA edite um configurador ativo só funciona se uma edição incorreta não puder chegar aos seus clientes. O Simplio3D processa cada escrita em três etapas: propor, confirmar, criar instantâneo.

• Edições de baixo risco avançam sem aguardar por você, como renomear um bloco ou adicionar uma variante.
• Alterações de alto risco produzem sempre apenas uma proposta: preços, SKUs, eliminações, edições em massa, materiais partilhados e ligações a produtos da loja. A proposta aguarda em Alterações de IA pendentes na página Ligações de IA e lista todas as alterações que faria. Você seleciona Aplicar ou rejeita-a. Nenhum agente pode aprovar a sua própria proposta, e esta regra não pode ser desativada.
• É criado um instantâneo de cada alteração aplicada, para que possa ser desfeita, depois novamente validada e registada num registo de auditoria.

As propostas têm curta duração. Se o projeto tiver sido alterado desde que o agente propôs algo, a proposta antiga é recusada em vez de substituir as suas edições mais recentes; peça novamente ao agente.

Além disso, uma chamada de ferramenta só é bem-sucedida quando quatro verificações são aprovadas: o endereço de e-mail da conta está verificado, o plano do proprietário do espaço de trabalho está ativo, a função do utilizador permite a ação e a ligação possui o âmbito necessário. Prevalece sempre a permissão mais restritiva. Por exemplo, um utilizador com função de Visualizador nunca pode fazer ou confirmar uma alteração, independentemente dos âmbitos da sua ligação.

Ligar o Claude sem um token. Simplio3D está listado no diretório de conectores do Claude. No Claude, abra Personalizar → Conectores, procure Simplio3D e clique em Ligar ou escolha Adicionar conector personalizado e cole https://app.simplio3d.ai/mcp. Em ambos os casos, o Claude abre o início de sessão do Simplio3D e um ecrã de consentimento onde escolhe o espaço de trabalho e os âmbitos, com o acesso só de leitura já selecionado. A ligação surge então na mesma lista de Ligações de IA, identificada como Aplicação OAuth, e pode alterná-la ou revogá-la aí, como qualquer outra.

Prompts para experimentar primeiro

Indique o nome do projeto e peça evidências: “qual regra o oculta?” produz uma resposta mais precisa do que “porque está oculto?”.

Limites que vale a pena conhecer antes de confiar nele

• Os agentes leem dados guardados. O editor guarda automaticamente alguns segundos após cada alteração, por isso uma edição feita há instantes pode ainda não estar visível. Guarde e volte a perguntar.
• Os preços e a lógica no lado do servidor têm ressalvas. O cálculo de preços e a avaliação de regras abrangem os casos mais comuns, mas não todos os comportamentos do configurador publicado, como a definição de preços por unidade para Number Input. Cada resultado indica o que não foi avaliado, e a Pré-visualização e a vista partilhada publicada continuam a ser a referência final.
• Limites de taxa. Cada ligação pode fazer 300 pedidos a cada cinco minutos. Um espaço de trabalho aceita 30 alterações de IA aplicadas a cada dez minutos, partilhadas entre todos os agentes ligados e o assistente integrado.
• Respostas extensas são resumidas e assinaladas. Um resultado com mais de aproximadamente 60 KB é resumido e marcado como truncado, para que o agente não confunda parte de uma lista com a totalidade dela.
• O que o agente lê é enviado para o seu fornecedor de IA. Os pedidos de orçamento incluem nomes e dados de contacto dos clientes, por isso conceda o âmbito de Orçamentos de forma consciente.
• Os tokens expiram após 90 dias. Rode um imediatamente se tiver sido colado num chat, num pedido de suporte ou numa partilha de ecrã. A rotação invalida o token antigo de imediato.

Uma camada de ferramentas por trás de todas as interfaces de IA

O servidor MCP não é um produto separado acrescentado à parte. O assistente de IA integrado do Simplio3D, o endpoint de ferramentas autenticado REST para as suas próprias automatizações e os clientes MCP externos chamam todos o mesmo registo de ferramentas, sob a mesma autenticação, permissões e registo de auditoria. Uma capacidade comporta-se da mesma forma, independentemente de onde é chamada, e um âmbito ou função que a bloqueie num local bloqueia-a em todo o lado.

É também assim que o MCP difere do REST API e SDK. O SDK é um cliente tipado para o seu próprio código, autenticado com uma chave API, e essa chave nunca é aceite no endpoint MCP. O MCP destina-se a agentes de IA, autenticados através de uma ligação cujo âmbito é definido por ferramenta.