Quem: Mariusz Szatkowski, programador WordPress desde 2006, autor do servidor MCP que funciona neste site e de um servidor MCP de código aberto para WooCommerce. Trabalho sozinho, programo eu próprio o código da integração e não passo os seus acessos a ninguém.
O quê: servidores Model Context Protocol com ferramentas restritas, autorização conforme a especificação MCP, ligação a WordPress, WooCommerce, Shopify e conteúdo de headless CMS, registo de chamadas e testes antes de entrar em produção.
Onde: remotamente a partir de Gdynia, na Polónia, uma hora à frente de Lisboa. Tudo se combina por e-mail, em documentos e no repositório. Antes de aceder a dados pessoais assinamos um acordo de subcontratação nos termos do artigo 28.º do RGPD.
Quanto: cada integração tem orçamento próprio, conforme o número de sistemas e ferramentas e se alguma escreve dados. Recebe uma proposta escrita com os pressupostos em que assenta.
Integração MCP e IA para lojas e sites WordPress
Model Context Protocol dá a um assistente de IA uma lista de ferramentas bem descritas em vez de uma palavra-passe de administrador colada no chat. Ligo essas ferramentas aos sistemas que já tem e limito-as para que o assistente veja apenas o que aprovar.
O serviço passo a passo está na página de desenvolvimento de servidor MCP. Aqui trato das decisões de arquitetura e dos pontos em que uma integração pode causar estragos.
Um assistente no apoio ao cliente poupa tempo, mas cada atalho pode expor dados pessoais ou contradizer o stock real. Por isso começo por um mapa de dados. O histórico de encomendas pode muitas vezes ser mostrado ao modelo como categoria de produto, estado e escalão de valor, sem nome, morada nem telefone. Os campos de que só o envio precisa ficam na loja.
Como escolher processos para um piloto MCP
Envie-me a lista de tarefas em que está a pensar: consultar o estado de uma encomenda, explicar a política de devoluções, pesquisar na documentação técnica. Cada tarefa recebe um de três níveis. A ferramenta atua sozinha, a ferramenta precisa da confirmação de uma pessoa, ou a tarefa fica fora do assistente.
Pelo caminho registo identificadores de produto, moedas por mercado e exceções fiscais, como as taxas de IVA diferentes no continente, na Madeira e nos Açores. Sem esse mapa o modelo faz médias e troca preços. Os casos limite vêm de pedidos reais da sua ferramenta de suporte: devolução parcial, encomenda dividida em duas embalagens, reclamação fora de prazo.
O que o MCP faz por dentro
O MCP assenta em JSON-RPC 2.0. Uma aplicação de IA (o host, como o Claude ou o ChatGPT) liga-se através de um cliente a um servidor que oferece ferramentas que o modelo pode chamar, recursos com dados e modelos de prompt. A especificação em vigor tem data de 28 de julho de 2026 e define dois transportes padrão: stdio, para um servidor lançado localmente como processo, e Streamable HTTP, para um servidor remoto em que cada mensagem é um POST separado para um único endpoint (especificação). A mesma especificação lembra que uma ferramenta equivale a executar código arbitrário, que uma pessoa deve poder recusar qualquer chamada e que as descrições vindas de servidores não fiáveis se tratam como não fiáveis.
Como desenhar um servidor MCP seguro
Ferramentas
Cada ferramenta tem nome, descrição e um esquema de entrada em JSON Schema, e um esquema de saída quando devolve dados estruturados. Prefiro operações determinísticas como “obter resumo da encomenda por ID” a um vago “corrigir encomenda”. As correções fazem-se no painel de administração.
Os erros separam-se como a especificação prevê: erro de protocolo perante uma ferramenta desconhecida ou um pedido mal formado, erro de execução com isError: true perante uma data errada, um registo inexistente ou falta de permissões. Assim o modelo recebe algo que consegue corrigir.
Este site já funciona assim. O servidor em https://wppoland.com/mcp oferece ferramentas só de leitura, entre elas check_services e request_quote, sem chave de API. A arquitetura está no guia do servidor MCP ao vivo da WPPoland. A versão para lojas é o meu servidor MCP de WooCommerce no GitHub: só de leitura, com ferramentas como get_product, list_orders e sales_report.
Autenticação, tokens e âmbitos no MCP
Para servidores por HTTP, a especificação assenta a autorização em OAuth 2.1. Um servidor MCP protegido é um servidor de recursos: publica metadados segundo o RFC 9728, só aceita tokens emitidos para ele e não os reencaminha. O cliente identifica o servidor com o parâmetro resource do RFC 8707. Um servidor local por stdio obtém as credenciais a partir de variáveis de ambiente (autorização na especificação MCP).
Defino os âmbitos de forma a poder desligar uma ferramenta durante um incidente sem parar o assistente inteiro. Onde o WordPress ou o WooCommerce já têm permissões, replico-as em vez de criar uma lista de acessos paralela que acaba por divergir.
Que dados um servidor MCP deve devolver ao modelo
A resposta da ferramenta não leva dados pessoais desnecessários. Leva a data e hora da fonte, a moeda e a língua, para que o modelo não misture mercados. O conteúdo do CMS vai identificado à parte dos números da loja. Num site multilingue a ferramenta devolve o código de língua, para que o assistente não cite a um cliente do Porto uma descrição em português do Brasil.
Limites de tráfego MCP em picos de vendas
A especificação exige que o servidor valide entradas, controle acessos, limite chamadas e limpe as saídas. O limite tem uma razão prática: um assistente faz pedidos mais depressa do que uma pessoa e a mesma API da loja serve compradores reais. Defino limites diferentes para as ferramentas de encomendas e para as de conteúdo de marketing, para que uma campanha de e-mail não esgote os recursos da gestão de devoluções. O que pode estar ligeiramente desatualizado vem da cache.
Antes do lançamento repito em staging um teste de carga para confirmar as novas tentativas com espera. Se uma ferramenta depende de um webhook síncrono para o ERP, registo o tempo de espera. Caso contrário, o assistente indica um estado de encomenda que o ERP ainda não conhece.
Integração MCP com WordPress e WooCommerce
O WordPress 6.9 introduziu a Abilities API. Com wp_register_ability() regista-se uma operação com descrição, esquemas de entrada e saída e permission_callback, e o WordPress expõe-na na REST API em wp-abilities/v1 (anúncio em make.wordpress.org). O MCP Adapter, parte da iniciativa AI Building Blocks for WordPress, transforma essas abilities em ferramentas, recursos e prompts MCP, acessíveis através do WP-CLI por stdio ou por HTTP. Uma ability é privada para MCP até ser marcada como pública, e a verificação por omissão do servidor é apenas is_user_logged_in(), por isso acrescento eu o controlo de permissões de cada operação.
Se está a decidir entre o WordPress.com Agent com MCP write e um adaptador próprio no seu servidor, essa comparação ajuda a escolher antes de começar.
O que vigio na prática:
- Uma ferramenta que tem de mostrar o stock real contorna a cache da página e consulta um endpoint com dados de vida curta.
- Com HPOS, o WooCommerce guarda as encomendas em tabelas próprias, por isso os relatórios usam a API de encomendas e não consultas a postmeta.
- Em multisite a ferramenta recebe o ID do site como argumento, para que o modelo não misture catálogos de marcas diferentes.
- O acesso por HTTP usa palavras-passe de aplicação do WordPress ou OAuth, com a rotação descrita na documentação.
Integração MCP com Shopify e lojas multiplataforma
No Shopify aplicam-se os limites da plataforma. A GraphQL Admin API calcula o custo de cada consulta e, quando o limite é ultrapassado, devolve um erro de limitação e pede para esperar (limites do Shopify). A ferramenta avisa então o assistente de que a resposta vai demorar, em vez de inventar dados. O país ou mercado é um argumento explícito, para que o preço no chat coincida com o checkout. Em lojas B2B com contas de empresa, cada conjunto de âmbitos da Admin API tem as suas ferramentas, de modo que a pergunta de um consumidor não revela preços de revenda.
Quando o WooCommerce e um headless CMS partilham o mesmo assistente, fica escrita a regra de prioridade: stock e preços da plataforma de comércio, descrições do CMS. A regra está no código do servidor.
Quem fica responsável pelo servidor MCP depois da entrega
O código, o repositório e a documentação são seus. Entrego por escrito a descrição de cada ferramenta, as instruções para desligar uma ferramenta ou o servidor inteiro e o conjunto de testes com as respostas esperadas. Com isso, o seu responsável de apoio ao cliente ou outro programador pode continuar sem me perguntar nada. Se preferir que eu mantenha o servidor, combinamos isso por escrito, com as mesmas atualizações testadas em staging que uso na manutenção de WordPress.
Como publicar um servidor MCP no ChatGPT e no Claude?
Atualização, . Os dois assistentes têm diretórios públicos de servidores MCP, por isso um servidor criado para o apoio ao cliente de uma loja também pode ser oferecido aos clientes dessa loja.
O diretório de plugins do ChatGPT
A OpenAI mantém um único diretório de plugins partilhado pelo ChatGPT e pelo Codex. Segundo o registo de alterações do Apps SDK, o ChatGPT é totalmente compatível com a especificação MCP Apps desde 22 de fevereiro de 2026. Antes de publicar:
- a submissão tem de vir de uma pessoa ou organização verificada,
- o plugin precisa de uma política de privacidade publicada e de um contacto de suporte,
- o pacote ZIP passa por verificações automáticas e depois por revisão, e após a aprovação é o próprio que decide quando o disponibilizar,
- por agora o comércio limita-se a bens físicos, com pagamento no seu próprio domínio (o Instant Checkout só está disponível para parceiros selecionados),
- a disponibilidade pode ser restringida com uma lista de países no campo
publication.countries, - após a publicação, a OpenAI analisa diariamente o servidor MCP alojado.
Fontes: diretrizes, submissão.
O Connectors Directory do Claude
- submissão em claude.ai/directory/manage como conector MCP; pode fazê-la qualquer pessoa com um plano pago do Claude,
- servidor remoto por HTTPS; um servidor local só dentro de um plugin,
- OAuth 2.0 para ferramentas que atuam na conta de um utilizador, sem autenticação para dados públicos,
- cada ferramenta com título e a anotação
readOnlyHintoudestructiveHint, - URL da documentação, URL da política de privacidade, contacto de suporte, ícone e uma conta de teste completa para a revisão,
- análise automática de políticas após a submissão e etiqueta Community por omissão; servidores com URL específicos por cliente precisam da etiqueta Verified.
As entradas como extensão de ambiente de trabalho (MCPB) foram descontinuadas. Fonte: documentação da Anthropic.
O que preparo antes da submissão
Uma ferramenta marcada com readOnlyHint não altera dados de facto, em linha com a separação entre leitura e escrita descrita acima. A política de privacidade explica o que o servidor envia ao fornecedor do modelo e cumpre o dever de informação do artigo 13.º do RGPD. A conta de teste usa dados de exemplo, nunca encomendas reais. Uma loja que queira aparecer no ChatGPT sem plugin próprio começa pelo feed de produtos e pelos dados estruturados, como explico na página sobre preparação da loja para o comércio com IA.
Como testo uma integração MCP
Tenho um conjunto fixo de perguntas com respostas esperadas e corro-o após cada alteração às ferramentas e cada mudança de modelo no fornecedor. Inclui tentativas de prompt injection e cenários em que o endpoint do modelo ou a API da loja devolvem erros. Meço a exatidão dos dados, a latência das ferramentas e quantas vezes uma pessoa tem de assumir a conversa.
Se o consumo de tokens cresce mais depressa do que a qualidade, simplifico as ferramentas ou encurto o contexto. Quando o modelo tenta várias vezes seguidas contornar as regras de uma ferramenta, procuro a causa.
Que documentos ficam depois do projeto
| Documento | Para quê | Quem prepara |
|---|---|---|
| Descrição das ferramentas MCP | Aprovação pela sua área jurídica ou de segurança | Eu |
| Acordo de subcontratação | Artigo 28.º do RGPD, incluindo o fornecedor do modelo | O cliente e eu |
| Instruções para desligar | Cortar o assistente sem tirar a loja do ar | Eu |
| Resultados dos testes | Histórico da qualidade das respostas | Eu, no repositório |
Respostas MCP e dados estruturados para GEO e AEO
Se a página de produto usa sku, gtin13 ou priceSpecification em schema.org, a ferramenta MCP devolve os mesmos identificadores e valores. Uma diferença entre a página e a resposta do chat é um cliente a ver dois preços diferentes. Em páginas novas e alterações de oferta atualizo os dois na mesma publicação.
MCP como parte da implementação de IA na empresa
Os servidores MCP são uma peça de uma implementação de IA para empresas mais ampla, a par da automação de conteúdo e operações e de chatbots de apoio ao cliente com validação humana.
Como começar um projeto de integração MCP
Envie-me a lista de API a que o assistente deve aceder, uma descrição das tarefas e aquilo que nunca deve fazer. Recebe por escrito um plano com ferramentas, testes em staging e divisão de responsabilidades antes de qualquer token de produção ser ativado. Convém começar com um grupo pequeno da sua própria equipa antes de os clientes verem o assistente.
