Como conectar o Servidor MCP da Webstore ao Claude
O Claude é um assistente de Inteligência Artificial que permite conectar servidores MCP (Model Context Protocol) externos por meio de conectores personalizados, utilizando, dentro da conversa, todas as ferramentas que esses servidores disponibilizam. Ao conectar o Servidor MCP da Webstore, você habilita o Claude a consultar produtos, categorias, páginas institucionais e opções de frete da sua loja diretamente no chat, com acesso completo ao conjunto de ferramentas oferecido pelo servidor.
Antes de começar
Para concluir esta configuração, você precisa do Token exclusivo da sua loja. Caso ainda não tenha copiado esse dado, veja o tutorial de [como configurar o Servidor MCP da Webstore] antes de continuar.
Conectores personalizados estão disponíveis em contas Free, Pro, Max, Team e Enterprise do Claude. Contas do plano Free podem adicionar apenas um conector personalizado.
⚠️ Atenção: A interface do Claude pode exibir o caminho de configuração como “Settings” > “Connectors” ou como “Customize” > “Connectors”, dependendo da versão da plataforma. Caso não localize um dos caminhos indicados neste tutorial, procure a seção “Connectors” (Conectores) diretamente no menu de configurações da sua conta.
Entendendo o conector personalizado
Um conector personalizado é a forma como o Claude se conecta a um servidor MCP que não está listado no diretório oficial de conectores, como é o caso do Servidor MCP da Webstore. Diferentemente de alguns outros clientes MCP, o Claude não exige a ativação de um modo de desenvolvedor separado: o conector personalizado já concede acesso completo às ferramentas do servidor conectado, incluindo search_products, get_product e calculate_shipping.
Ao utilizar uma ferramenta pela primeira vez em uma conversa, o Claude solicita a sua aprovação antes de executá-la. Como o Servidor MCP da Webstore permite apenas leitura de dados públicos, essa aprovação não representa risco às informações da sua loja.
Adicionando o conector do Servidor MCP
Para começar, acesse o Claude pelo navegador, pelo aplicativo desktop ou pelo aplicativo mobile.
Em seguida, acesse “Settings” > “Connectors” (Configurações > Conectores).
Clique no botão “+”, ao lado de “Connectors”.
Selecione “Add custom connector” (Adicionar conector personalizado).
No campo de nome, insira webstore.
Depois, informe a URL do servidor.
Configurando a URL e a autenticação
No momento, o Claude não oferece, na tela de conector personalizado, um campo para o envio do Header “X-MCP-Key” utilizado pelo Servidor MCP da Webstore. Por isso, utilize o Token diretamente na URL, por meio do parâmetro de querystring.
No campo de URL, insira o endereço do servidor já com o Token incluído:
https://mcp-store.webstore.net.br/mcp?token=SEU_TOKEN_AQUI
Substitua SEU_TOKEN_AQUI pelo Token exibido no painel da sua loja.
Não é necessário preencher os campos de “Advanced settings” (Configurações avançadas), já que o Servidor MCP da Webstore não utiliza OAuth.
Por fim, clique em “Add” (Adicionar) para concluir a criação do conector.
Na lista de conectores, clique em “Connect” (Conectar) para validar a conexão com o servidor.
Se os dados estiverem corretos, o Claude identificará as ferramentas disponibilizadas pelo Servidor MCP da Webstore.
Ativando o conector em uma conversa
Para utilizar o conector, abra uma conversa no Claude.
Em seguida, clique no ícone “+”, exibido no canto inferior esquerdo do campo de mensagem.
Passe o cursor sobre “Connectors” (Conectores).
Ative o conector webstore por meio do alternador (toggle) exibido ao lado do nome.
Ao concluir esses passos, o conector estará disponível para uso nessa conversa.
Testando a conexão
Após ativar o conector, envie uma pergunta 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?
Ao identificar a necessidade de uma consulta, o Claude solicitará a sua aprovação para executar a ferramenta correspondente.
Clique em “Allow once” (Permitir uma vez) ou em “Allow always” (Sempre permitir) para autorizar a execução.
Se a conexão estiver funcionando corretamente, o Claude apresentará dados públicos e atualizados da sua loja, extraídos diretamente do Servidor MCP da Webstore.
Solucionando problemas comuns
Caso o Claude não consiga se conectar ao servidor, verifique se o Servidor MCP da Webstore está acessível pela internet pública, já que o Claude se conecta a partir da infraestrutura da Anthropic, e não do seu dispositivo local.
Caso a conexão seja recusada, verifique se o Token foi copiado corretamente e se a URL não contém espaços ou caracteres adicionais.
Caso você utilize o plano Free e não consiga adicionar o conector da Webstore, verifique se já existe outro conector personalizado ativo na sua conta, já que esse plano permite apenas um.
Caso o conector apareça na lista, mas as ferramentas não sejam utilizadas na conversa, confirme se ele foi ativado pelo caminho “+” > “Connectors”, já que essa ativação é feita por conversa.
Protegendo o Token da loja
O Token utilizado nesta conexão é o mesmo Token do Servidor MCP da sua loja. Para instruções completas sobre como proteger esse Token e sobre os limites de uso do servidor, veja o tutorial de [como configurar o Servidor MCP da Webstore].
Como o Token é enviado pela URL nesta configuração, evite compartilhar prints de tela ou links que exibam a URL completa do conector. Caso desconfie de exposição do Token, gere um novo código pelo aplicativo “Servidor MCP” e atualize a configuração no Claude.
Confirmando a configuração
Ao concluir a configuração, envie uma nova pergunta de teste na conversa.
Confirme se o Claude consegue buscar um produto, consultar uma página institucional ou calcular o frete de um produto.
Se as informações forem apresentadas corretamente, o Servidor MCP da Webstore estará conectado ao Claude e poderá ser utilizado no atendimento aos clientes da sua loja.