Como configurar o Servidor MCP da Webstore

O Servidor MCP da Webstore permite conectar os dados públicos da sua loja a agentes de Inteligência Artificial utilizados no atendimento ao cliente. Após configurar a conexão, o agente poderá consultar produtos, categorias, páginas institucionais, informações da loja e opções de frete, sem acessar dados de clientes, carrinho ou checkout.

Acessando o Servidor MCP

Para começar, acesse o painel administrativo da sua loja.

Em seguida, acesse “Aplicativos” > “Gestão” > “Servidor MCP”.

Ao acessar o aplicativo, você encontrará os dados necessários para conectar sua loja a um agente ou cliente compatível com MCP.

Entendendo o funcionamento da integração

O MCP (Model Context Protocol) é um protocolo que permite que agentes de Inteligência Artificial utilizem ferramentas e consultem informações disponibilizadas por sistemas externos.

No Servidor MCP da Webstore, cada loja possui um Token exclusivo. O Token é o código de autenticação utilizado para identificar sua loja durante a conexão.

Quando um agente utiliza esse Token, o servidor identifica automaticamente a loja correspondente. Dessa forma, o agente não precisa informar ou selecionar o identificador interno da loja.

O servidor permite apenas a leitura de informações públicas. Nenhum dado pode ser alterado por meio dessa conexão.

Copiando os dados de conexão

Na tela do aplicativo “Servidor MCP”, localize o Token da sua loja.

Copie o Token e armazene-o em um local seguro.

Depois, utilize os seguintes dados para configurar a conexão no agente de Inteligência Artificial:

Nome do servidor

webstore

URL do servidor

https://mcp-store.webstore.net.br/mcp

Tipo de transporte

MCP Streamable HTTP

Nome do Header

X-MCP-Key

Valor do Header

SEU_TOKEN_AQUI

Substitua SEU_TOKEN_AQUI pelo Token exibido no painel da sua loja.

O formato da configuração pode variar conforme o agente ou cliente MCP utilizado. Para realizar a conexão, a ferramenta escolhida precisa aceitar servidores MCP remotos por Streamable HTTP e permitir o envio de Headers personalizados.

Caso seu agente não permita validação via X-MCP-key, você pode usar por um parâmetro querystring.

https://mcp-store.webstore.net.br/mcp?token=SEU_TOKEN_AQUI

Configurando o servidor no agente de Inteligência Artificial

Acesse a área de configuração de servidores MCP do agente que será utilizado.

Em seguida, adicione um novo servidor MCP remoto.

No campo destinado ao nome do servidor, insira webstore.

Depois, insira a URL:

https://mcp-store.webstore.net.br/mcp

Na área de autenticação ou Headers personalizados, adicione o Header X-MCP-Key.

No valor do Header, cole o Token copiado anteriormente.

Por fim, salve a configuração e solicite que o agente estabeleça a conexão com o servidor.

Se os dados estiverem corretos, o agente identificará as ferramentas disponibilizadas pela Webstore.

Verificando as ferramentas disponíveis

Após concluir a conexão, verifique se o agente apresenta as ferramentas do Servidor MCP da Webstore.

As ferramentas podem ser utilizadas automaticamente pelo agente conforme as perguntas feitas pelo cliente.

Consultando as informações da loja

A ferramenta get_store_info retorna as principais informações públicas e comerciais da loja.

Ela pode fornecer dados como:

• Nome e informações de contato;
• Endereço;
• Redes sociais;
• Condições comerciais;
• Menu institucional da loja.

Essa ferramenta não exige o envio de parâmetros.

Buscando produtos

A ferramenta search_products permite buscar produtos por um termo livre ou listar os produtos pertencentes a uma categoria.

A busca pode utilizar os seguintes parâmetros:

• query: termo utilizado na busca;
• category_id: identificador da categoria;
• page: número da página;
• per_page: quantidade de produtos por página;
• sort: forma de ordenação dos resultados.

Você deve informar query ou category_id.

O parâmetro per_page utiliza 24 produtos como valor padrão e aceita, no máximo, 100 produtos por página.

As opções disponíveis para o parâmetro sort são:

• name_asc: nome em ordem crescente;
• name_desc: nome em ordem decrescente;
• price_asc: menor preço primeiro;
• price_desc: maior preço primeiro;
• newest: produtos mais recentes primeiro;
• relevance: produtos mais relevantes para a busca.

Consultando os detalhes de um produto

A ferramenta get_product retorna as informações completas de um produto.

Ela pode fornecer dados como:

• Nome;
• Preço;
• Estoque;
• Descrição;
• Imagens;
• Variações;
• Produtos relacionados.

Para localizar o produto, informe pelo menos um dos seguintes parâmetros:

• id: identificador do produto;
• sku: código de referência do produto;
• slug: endereço amigável do produto.

Consultando as categorias da loja

A ferramenta list_categories retorna a árvore de categorias públicas da loja.

Essa ferramenta não exige o envio de parâmetros.

O agente pode utilizá-la para identificar departamentos, categorias e subcategorias antes de realizar uma busca de produtos.

Consultando as páginas institucionais

A ferramenta list_pages retorna a relação de páginas institucionais ativas da loja.

Ela pode apresentar informações como:

• Identificador;
• Título;
• Slug;
• URL.

Essa ferramenta não exige o envio de parâmetros.

Consultando o conteúdo de uma página

A ferramenta get_page retorna o conteúdo completo de uma página institucional.

Ela pode ser utilizada para consultar páginas como:

• Sobre nós;
• Trocas e devoluções;
• Política de privacidade;
• Formas de pagamento;
• Informações de entrega.

Para localizar a página, informe pelo menos um dos seguintes parâmetros:

• id: identificador da página;
• slug: endereço amigável da página.

Calculando uma opção de frete

A ferramenta calculate_shipping calcula as opções de frete para um produto individual.

Para realizar o cálculo, informe os seguintes parâmetros:

• product_id: identificador do produto;
• zipcode: CEP de destino;
• qty: quantidade desejada.

O CEP deve possuir oito dígitos e pode ser informado com ou sem hífen.

O parâmetro qty é opcional. Quando ele não for informado, o servidor utilizará uma unidade como quantidade padrão.

Essa ferramenta calcula o frete somente para um produto individual. Ela não realiza cálculos de carrinho com diferentes produtos.

Testando a conexão

Após configurar o servidor, envie uma pergunta ao agente que exija a consulta de informações da loja.

Você pode utilizar perguntas como:

• Quais produtos estão disponíveis na categoria de camisetas?
• Qual é o preço do produto com o SKU informado?
• Quais são as formas de pagamento da loja?
• Qual é a política de trocas e devoluções?
• Qual é o valor do frete deste produto para o CEP informado?

Durante o teste, verifique se o agente consulta as ferramentas do servidor antes de apresentar a resposta.

Se a conexão estiver funcionando corretamente, o agente utilizará os dados públicos e atualizados da sua loja.

Protegendo o Token da loja

O Token do Servidor MCP é exclusivo da sua loja.

Não compartilhe esse Token publicamente.

Não insira o Token em páginas, códigos ou repositórios que possam ser acessados por terceiros.

Qualquer aplicação que utilizar o Token poderá consultar as informações públicas disponibilizadas pelo servidor da sua loja.

Caso seja necessário trocar o Token, gere um novo código pelo aplicativo “Servidor MCP” e atualize a configuração em todos os agentes conectados.

Entendendo os limites de uso

O Servidor MCP possui um limite padrão de 120 requisições por minuto para cada Token.

Quando esse limite for excedido, o servidor retornará uma mensagem de limite de uso excedido.

Após a redução do volume de requisições, o agente poderá voltar a consultar as ferramentas normalmente.

O servidor também retornará uma mensagem legível quando um parâmetro obrigatório não for informado ou quando um produto ou página não for localizado.

Se o Token estiver ausente ou for inválido, a conexão será recusada antes que qualquer ferramenta seja executada.

Entendendo quais informações não são disponibilizadas

O Servidor MCP da Webstore permite apenas a consulta de informações públicas da loja.

Por segurança, o servidor não disponibiliza:

• Carrinho de compras;
• Checkout;
• Login de clientes;
• Dados de clientes autenticados;
• Dados pessoais;
• Preços B2B;
• Tabelas de preços específicas;
• Informações de outras lojas;
• Ferramentas para cadastrar, editar ou excluir dados.

Cada Token está vinculado a uma única loja. Por isso, um agente não pode utilizar o servidor para consultar informações pertencentes a outra loja.

Confirmando a configuração

Ao concluir a configuração, envie uma nova pergunta de teste ao agente.

Confirme se ele consegue buscar um produto, consultar uma página institucional ou calcular o frete para um produto.

Se as informações forem apresentadas corretamente, o Servidor MCP estará conectado e poderá ser utilizado pelo agente de Inteligência Artificial no atendimento aos clientes da sua loja.