Integração

IA ligada à sua loja WordPress

WordPress AI MCP

Utilize o MCP da loja para editar projetos locais do Alter Product com IA. O ChatGPT pode mostrar o editor ao lado da conversa. O proprietário autorizado também pode ligar um editor já incorporado no site.

Os exemplos utilizam a loja fictícia shop.example. Não publique palavras-passe, tokens de acesso ou códigos de emparelhamento nas capturas ou nos guias.

Instalar o plugin WordPressWordPress com a Abilities API nativa, WooCommerce, plugin Alter Product e WordPress MCP Adapter oficial com as respetivas dependências.

Antes de começar

Prepare a loja e uma conta com as permissões necessárias.

WordPress + WooCommerce

Prepare a loja e uma conta com as permissões necessárias.

  • WordPress 6.9+ com a Abilities API nativa, WooCommerce, plugin Alter Product e WordPress MCP Adapter oficial com as respetivas dependências.
  • Loja HTTPS acessível publicamente e conta WordPress autorizada. A conta ou espaço ChatGPT deve permitir ligações MCP personalizadas. Um endereço apenas local não é acessível a partir da cloud.
  • Frontend do editor compatível com o transporte WordPress MCP. Atualizar o plugin PHP não atualiza um editor alojado separadamente.
  • Um plano Business, a API Alter Product ligada nas definições do plugin e os recursos necessários transferidos para o WordPress. O MCP não substitui a integração existente da loja com o Alter Product.
  • As definições MCP exigem um administrador WordPress. A criação de produtos requer permissões de gestão do WooCommerce e edição de produtos, normalmente dos perfis Administrator ou Shop Manager.

Que ficheiros são necessários?

Instale os plugins necessários no WordPress. A ligação manual no ChatGPT utiliza o URL do servidor da sua loja e OAuth.

  • WordPress: instale o plugin atualizado do Alter Product com MCP, OAuth e o editor visual, além do WordPress MCP Adapter oficial com as respetivas dependências. Os ZIP são carregados no WordPress, não no ChatGPT. O OAuth está incluído no Alter Product; não é necessário outro plugin OAuth.
  • ChatGPT: escolha Add custom MCP server e indique o URL. Esta ligação manual não exige ZIP de integração, JSON exportado, token de acesso ou segredo do cliente.

Ligue o WordPress ao ChatGPT

Configure a loja uma vez e autorize a sua conta WordPress no cliente de IA.

Ative o MCP no WordPress

No painel WordPress, abra Alter Product → MCP authoring.

  1. Ative MCP autenticado, acesso ao editor no navegador e OAuth. Guarde e confirme os componentes WordPress necessários.
  2. Copie o URL OAuth MCP apresentado pelo plugin. Utilize o endereço da sua loja; o exemplo abaixo é fictício.
URL OAuth MCP da sua loja
https://shop.example/wp-json/alter-wc/v1/mcp
Ative o MCP no WordPress
Ative MCP autenticado, acesso ao editor no navegador e OAuth. Guarde e confirme os componentes WordPress necessários.

Adicione a ligação no ChatGPT

Configure a loja uma vez e autorize a sua conta WordPress no cliente de IA.

  1. Abra Plugins no ChatGPT através do navegador, selecione o botão mais e escolha Add custom MCP server. A conta e o espaço de trabalho devem permitir esta opção.
  2. Introduza Alter Product WordPress como nome. A descrição é opcional.
  3. Em Connection, indique o URL MCP da loja, por exemplo https://shop.example/wp-json/alter-wc/v1/mcp, e escolha OAuth. Substitua shop.example pela sua loja.
  4. Leia o aviso e continue apenas se confiar no servidor da loja. Escolha Create as a plugin e instale o plugin privado se o ChatGPT o solicitar.
  5. Ligue o plugin, inicie sessão no seu site WordPress e aprove o acesso solicitado. Introduza a palavra-passe WordPress apenas nesse site.
  6. Regresse à conversa, selecione o plugin instalado com @ e peça a lista de projetos locais antes de efetuar alterações.

Trabalhe no editor visível

Abra o Designer ou Product Generator num cliente ChatGPT compatível para acompanhar as alterações.

Designer · Customizer · Configurator · Viewer · Product Generator

Abra o Designer ou Product Generator num cliente ChatGPT compatível para acompanhar as alterações.

  1. Peça à ferramenta ligada para abrir o Designer ou Product Generator e selecione o projeto local correto.
  2. Descreva uma pequena alteração, confirme a pré-visualização e utilize Anular/Refazer se necessário. Aguarde o carregamento completo do editor.
  3. Utilize Guardar no editor para gravar o rascunho no WordPress. Confirme o resultado antes de alterar o produto publicado.
MCP
alter-product-app-catalog
alter-product-open-editor
Designer ligado ao WordPress com t-shirt 3D e área UV 2D
Designer aberto através de WordPress MCP: a peça aparece em 3D ao lado da área UV 2D, da grelha e das réguas. Guardar continua a ser uma ação separada.

Utilize o editor no seu site

O proprietário pode ligar um editor incorporado compatível ao mesmo MCP WordPress.

WordPress → AI MCP

Para o espaço do proprietário no seu site, ative o MCP e o acesso ao editor no navegador. A ligação dentro do ChatGPT exige também OAuth; clientes locais compatíveis podem utilizar uma palavra-passe de aplicação do WordPress.

  1. Inicie sessão no WordPress da loja com a conta autorizada no cliente de IA. No produto incorporado localmente, escolha Editar com IA. Abrir gerador com IA também aparece quando o design tem um projeto local do Generator associado.
  2. O espaço separado do proprietário liga-se automaticamente ao MCP WordPress da loja. Num editor de administração já aberto, abra AI MCP e escolha a ligação WordPress do plugin.
  3. Na conversa, liste os editores ligados e selecione o projeto e o separador corretos. Mantenha esse separador aberto.
  4. Confirme a pré-visualização incorporada e desligue AI MCP no fim. Guardar continua a ser uma ação separada.

Onde ficam o trabalho e os dados

O WordPress trata os comandos MCP; a edição e os cálculos 3D decorrem no navegador ligado.

WordPress + Alter Product

O WordPress autentica, verifica permissões e encaminha tarefas e resultados limitados. Não executa a simulação de tecido.

Designs locais e documentos do gerador utilizam o armazenamento normal do plugin. JavaScript do editor, autorização da integração, recursos transferidos e serviços externos podem continuar a seguir a configuração habitual do Alter Product. Não se garante tráfego externo nulo nem funcionamento offline.

Diagrama de ligação - WordPress AI MCP
Diagrama de ligação. O WordPress trata os comandos MCP; a edição e os cálculos 3D decorrem no navegador ligado.

Gravação, permissões e revogação

OAuth utiliza os direitos do utilizador WordPress autenticado, sem atribuir um novo papel de administrador. Edições no navegador permitem Anular/Refazer; alterações de produto no servidor têm regras próprias de gravação e publicação. Revogue a autorização IA para terminar o acesso à conta e desligue o editor para terminar a sessão.

Se a ligação ou a pré-visualização falhar

Identifique a etapa com problemas antes de repetir um comando.

MCP · OAuth · MCP Apps

Identifique a etapa com problemas antes de repetir um comando.

  • Clientes na cloud precisam de um URL HTTPS público. Testes locais exigem um túnel HTTPS temporário configurado explicitamente; localhost não é o URL do servidor para o ChatGPT.
  • Se faltarem ferramentas, confirme MCP, OAuth, Abilities API nativa, adaptador oficial, URL exato e permissões WordPress.
  • Se as ferramentas funcionarem sem editor visível, confirme MCP Apps, versão do frontend e restrições de frames do cliente. Um wrapper WordPress não elimina essas regras.
  • Se a sessão estiver indisponível, reabra o editor correto do proprietário, ligue AI MCP e selecione a sessão. Leia o estado atual antes de repetir uma gravação com resultado incerto.