Servidor MCP no Magento 2: conectar um agente sem abrir a loja inteira

Instale só as ferramentas que o agente vai usar

O módulo base sobe o endpoint POST /mcp e um punhado de ferramentas de sistema. Tudo que é domínio — pedido, catálogo, estoque, cliente, CMS — mora em sub-módulos separados. Isso é a favor de quem quer superfície pequena:

composer require magebitcom/magento2-mcp-module
php bin/magento module:enable Magebit_Mcp
php bin/magento setup:upgrade

Para o caso deste artigo — consultar pedido e estoque — bastam dois pacotes a mais:

composer require magebitcom/magento2-mcp-order-tools
composer require magebitcom/magento2-mcp-inventory-tools
php bin/magento setup:upgrade

Existe um meta-pacote que instala os nove de uma vez. Eu não uso em produção: ele traz catálogo, cliente, CMS, marketing e imposto junto, e a documentação do próprio módulo avisa que o setup:upgrade habilita módulo que ele ainda não viu. Você acaba com uma superfície maior do que pediu.

Sobre o título desta dica: o módulo de consulta SQL crua existe, chama-se Magebit_McpDbTools, é instalado à parte e não entra no meta-pacote. Ele nasce desligado e sem tabela nenhuma liberada. Deixe assim — as ferramentas de domínio respondem as mesmas perguntas sem dar leitura em massa da base de clientes.

As três travas antes de conectar qualquer coisa

Aqui está a parte que a maioria pula. As configurações ficam em Stores > Configuration > Magebit > MCP Server, e os padrões são de ambiente de desenvolvimento, não de produção.

1. Escrita. O Allow Write Tools nasce em Yes. Ele é o interruptor global: nenhum token consegue escrever com ele desligado, mesmo que o token tenha a permissão. Desligue.

php bin/magento config:set magebit_mcp/general/allow_writes 0

2. Rate limit. Nasce desligado. Um agente em loop consegue fazer muita chamada em pouco tempo — e cada chamada é uma consulta ao seu banco.

php bin/magento config:set magebit_mcp/rate_limiting/enabled 1
php bin/magento cache:flush config

3. ACL. Toda ferramenta MCP passa pela permissão de role do admin, sob o recurso Magebit_Mcp::tools. Isso significa que o agente nunca consegue fazer o que aquele admin não poderia fazer pela tela. Crie um usuário de admin exclusivo para o agente, com uma role que só marque as ferramentas de leitura de pedido e estoque, e nada mais.

Vale conferir também o Allowed Origins, que já vem com uma lista dos principais clientes de IA, e a retenção do log de auditoria, que nasce em 90 dias e é limpa pelo cron magebit_mcp_audit_purge. O log grava toda requisição, inclusive tentativa não autenticada, com os argumentos passados por um redator de PII antes de serem gravados.

O token e a conexão

Com as travas no lugar, emita o token pela CLI. Repare no que não está no comando:

php bin/magento magebit:mcp:tools:list

php bin/magento magebit:mcp:token:create \
  --admin-user agente-atendimento \
  --name "Claude - atendimento" \
  --expires "+30 days" \
  -s sales.order.get

Sem --allow-writes, o token é de leitura. O -s repete uma vez por ferramenta liberada — rode o tools:list antes para pegar os nomes exatos das que os sub-módulos registraram. E o --expires não é opcional na minha cabeça: token de IA sem validade é token que fica ativo até alguém lembrar dele.

O texto do token aparece uma vez só e não é recuperável. Guarde no gerenciador de segredos, não no chat.

Do lado do cliente, são dois campos: a URL https://sualoja.com.br/mcp e o header Authorization: Bearer com o token. Para clientes hospedados que pedem consentimento do operador, o módulo também implementa OAuth 2.1 com PKCE, e os clientes conhecidos entram como preset.

Depois de conectar, faça a checagem que importa: peça ao agente para alterar alguma coisa. Um pedido de mudança de preço tem que voltar recusado. Se voltar feito, alguma das três travas ficou aberta.

php bin/magento magebit:mcp:token:list
php bin/magento magebit:mcp:token:revoke 3

Guarde esses dois comandos junto do procedimento de desligamento. Revogar preserva o rastro na auditoria, que é o que você vai querer ler se um dia algo estranho aparecer.