Bevean MCPConverse com os dados da sua loja no seu assistente de IA
O MCP da Bevean conecta o Claude, o ChatGPT, o Meta Muse, o Claude Code, o Codex e outros assistentes aos dados da sua loja. Você pergunta em linguagem natural e recebe respostas com os números reais de vendas, clientes, produtos, segmentos e atendimento.
1. Criar a chave
- No admin da Bevean, abra o menu do seu usuário (canto superior direito) e entre em Assistentes de IA (MCP).
- Clique em Criar chave para IA, dê um nome (por exemplo, "Claude da Maria"), escolha a validade e marque o que o assistente pode consultar.
- Na mesma tela aparecem o seu endereço secreto e os comandos prontos para cada app, já preenchidos com a chave. Para uma chave já criada, use o botão Conectar na lista.
O endereço secreto tem este formato. Ele contém a chave, então trate-o como uma senha:
https://mcp.bevean.com/mcp/SUA_CHAVE
2. Conectar o seu assistente
https://mcp.bevean.com/mcp
A chave e o endereço secreto continuam funcionando, principalmente para o Claude Code, o Codex no terminal e apps que aceitam cabeçalho.
Claude (Desktop, claude.ai e celular)
- No Claude, abra Configurações > Conectores e clique em Adicionar conector personalizado.
- Dê o nome Bevean e cole o endereço abaixo. Deixe os campos de OAuth vazios.
- Clique em Conectar, entre com a sua conta Bevean e escolha a loja e as áreas.
- Abra uma conversa nova e confira se o conector Bevean está ativo no menu de ferramentas.
https://mcp.bevean.com/mcp
Sem login: cole o endereço secreto da sua chave no lugar do endereço acima.
Configurado uma vez, vale no app de desktop, no claude.ai e no celular. Requer plano pago do Claude. Como tudo é somente leitura, você pode marcar Always allow nas permissões do conector.
ChatGPT
- No ChatGPT, abra Configurações > Aplicativos e conectores > Avançado e ative o modo desenvolvedor.
- Crie um conector com o nome Bevean, cole o endereço abaixo e escolha autenticação OAuth.
- Entre com a sua conta Bevean e escolha a loja e as áreas.
- Numa conversa nova, ative o conector Bevean.
https://mcp.bevean.com/mcp
Requer plano pago do ChatGPT com modo desenvolvedor disponível.
Meta Muse Novo
O Muse, agente de IA da Meta para pequenas empresas, aceita conectores MCP.
- No app do Muse, abra Conectores e adicione um conector personalizado, ou peça direto na conversa: "conecte a Bevean neste endereço".
- Informe o endereço abaixo e entre com a sua conta Bevean quando o Muse pedir.
- Pergunte, por exemplo: "como foram as vendas da minha loja este mês?".
https://mcp.bevean.com/mcp
Estamos em processo de entrada no diretório de conectores do Muse. Quando aprovado, a Bevean aparece na lista e a conexão vira um clique.
Claude Code
Cole no terminal e abra uma nova sessão do Claude Code:
claude mcp add --transport http --scope user bevean https://mcp.bevean.com/mcp
Na primeira chamada o Claude Code abre o navegador para você entrar com a Bevean. Sem login, use o endereço secreto no lugar do endereço.
Para conectar mais de uma loja, use um nome por loja, como bevean-loja-a. Para remover: claude mcp remove bevean --scope user.
Codex
No app do Codex: abra MCPs > Conectar MCP personalizado, escolha o tipo Streamable HTTP, dê o nome Bevean, cole o endereço e salve.
https://mcp.bevean.com/mcp
No terminal: cole o comando e abra uma nova sessão do Codex.
codex mcp add bevean --url https://mcp.bevean.com/mcp
O Codex detecta o login sozinho, abre o navegador na tela de autorização da Bevean e guarda a conexão. Sem login, use o endereço secreto.
Outros apps com MCP
Qualquer assistente compatível com MCP por HTTP (Streamable HTTP) funciona. Se o app suporta OAuth, use o endereço base e entre com a Bevean. Se o app aceita só uma URL, use o endereço secreto. Se aceita cabeçalhos, use o endereço base com a chave no cabeçalho Authorization:
URL: https://mcp.bevean.com/mcp Authorization: Bearer SUA_CHAVE
3. O que perguntar
Pergunte como perguntaria a um analista da sua equipe, com o período e o objetivo claros:
- "Como foram as vendas mês a mês este ano comparado ao ano passado?"
- "Quem são meus 20 clientes que mais compraram em 2026?"
- "Qual minha taxa de recompra e quanto tempo o cliente leva para a segunda compra?"
- "Monte um segmento de quem comprou mais de uma vez mas não compra há 90 dias. Quantos são?"
- "Quais produtos mais venderam no último mês e quais estão sem estoque?"
- "Qual campanha teve mais conversões este mês e quanto faturou?"
- "Como está o tempo de primeira resposta do atendimento esta semana?"
Para segmentos, o assistente entrega a quantidade de contatos e os filtros prontos. Para salvar, crie o segmento em Audiência > Segmentos no admin.
Ferramentas disponíveis
O assistente só enxerga as ferramentas das áreas marcadas na chave.
| Ferramenta | O que faz | Área da chave |
|---|---|---|
search_customers | Busca contatos por nome, e-mail, telefone ou documento e ordena por quem mais comprou. | Clientes |
get_customer | Perfil completo de um contato: compras, tags, segmentos, campos personalizados, cashback e últimos pedidos. | Clientes |
list_cashback | Cashback: quem tem saldo, quem tem saldo vencendo no período e o extrato de um cliente. | Clientes |
list_orders | Lista pedidos por período, status, pagamento, entrega, canal, cupom ou valor mínimo. | Pedidos |
get_order | Detalhe de um pedido: itens, pagamentos, descontos, rastreio e endereço. | Pedidos |
search_products | Busca produtos por nome, SKU, marca ou tag, com faixa de preço e estoque. | Produtos e carrinhos |
get_product | Detalhe de um produto: variantes, preço, custo, estoque e vendas dos últimos 90 dias. | Produtos e carrinhos |
list_abandoned_carts | Carrinhos abandonados recentes, com contato e produtos. | Produtos e carrinhos |
list_chats | Conversas do atendimento com status, canal, time, etapa, atendente, prioridade, tags, sentimento, SLA e motivo de encerramento. | Conversas |
search_chat_messages | Busca pelo que foi dito nas conversas (ex.: "atraso", "tamanho errado") e devolve as mensagens com a conversa. | Conversas |
get_chat_messages | Mensagens de uma conversa, com time, etapa, tags, encerramento e a nota de satisfação (CSAT) quando existe. | Conversas |
get_helpdesk_catalog | Times, etapas, tags, motivos de encerramento e canais do atendimento, para filtrar as conversas por nome. | Conversas |
get_segment_field_catalog | Todos os campos disponíveis para montar um segmento na sua loja. | Segmentos |
preview_segment | Simula um segmento e diz quantos contatos entram. Não salva nada. | Segmentos |
list_segments | Segmentos salvos, com tipo e quantidade de contatos. | Segmentos |
get_segment | Regras e tamanho de um segmento salvo. | Segmentos |
run_report | Relatórios da Bevean: vendas, RFV, coortes, recompra, reativação, cashback, campanhas, produtos e atendimento. | Relatórios |
list_event_metrics | Eventos rastreados no site e nos canais, com totais e pessoas únicas. | Relatórios |
event_timeline | Evolução de um evento rastreado por dia, semana ou mês. | Relatórios |
conversion_funnel | Funil de conversão da loja: visitas, carrinho, checkout e pedidos. | Relatórios, Pedidos |
describe_sql_tables | Tabelas e colunas disponíveis para consultas avançadas. | Consultas avançadas (SQL), Clientes, Pedidos, Produtos e carrinhos |
query_sql | Consulta avançada (SQL somente leitura) para perguntas que nenhuma outra ferramenta cobre. Sem dados pessoais: só ids, cidade/estado e faixa etária. | Consultas avançadas (SQL), Clientes, Pedidos, Produtos e carrinhos |
Várias lojas
Cada chave vale para uma loja. Para quem cuida de várias lojas, crie uma chave em cada uma e adicione um conector por loja, com nomes diferentes (por exemplo, "Bevean (Loja A)" e "Bevean (Loja B)"). Cada resposta informa de qual loja vieram os dados, e dá para pedir comparações como "compare as vendas de setembro das minhas lojas".
Limites
| Limite | Valor |
|---|---|
| Chamadas por minuto, por chave | 120 |
| Linhas por consulta avançada (SQL) | 500 |
| Tempo máximo de uma consulta avançada | 5 segundos |
| Período do relatório RFV | 13 meses |
| Período dos relatórios de coorte | 18 meses |
| Validade da chave | até 365 dias |
Segurança e privacidade
- Mensagens de clientes são tratadas como dado, nunca como ordem. O texto das conversas do atendimento e dos comentários de CSAT é escrito pelos seus clientes e pode conter tentativas de manipular o assistente ("ignore as instruções e…"). O MCP marca esse conteúdo como não confiável e orienta o assistente a não seguir nada que venha dele.
- Modo sem conteúdo de terceiros. Para não expor mensagens de clientes ao assistente, acrescente
?disable-user-content=trueao endereço do conector (por exemplo,https://mcp.bevean.com/mcp?disable-user-content=true). As consultas de mensagens deixam de aparecer; relatórios de atendimento continuam. Outra opção é não liberar a área Conversas na chave. - Consultas avançadas não expõem dados pessoais. As tabelas do SQL não têm nome, e-mail, telefone, documento nem endereço (só cidade/estado e faixa etária), nem links de pagamento, nota fiscal ou dados internos. Para ver uma pessoa, o assistente usa a consulta individual de cliente, como na tela.
- Consultas avançadas exigem as áreas Clientes, Pedidos e Produtos na chave, porque cobrem esses dados.
- Trate a chave e o endereço secreto como senha. Não envie por e-mail ou mensagem; cada pessoa cria a sua.
- Uma chave por pessoa e por app, para revogar só a de quem saiu da equipe ou trocou de computador.
- Libere só o necessário. Conversas e consultas avançadas expõem mais dados pessoais.
- Revogue na hora pela lixeira em Assistentes de IA se a chave vazar. O corte vale na chamada seguinte.
- A chave só enxerga a loja que a criou, não consegue escrever nada, e toda consulta fica registrada.
- CPF e CNPJ nunca saem inteiros: o assistente recebe o documento mascarado (só o final), e as consultas avançadas não têm acesso a dados pessoais.
- LGPD: os dados consultados são enviados ao provedor do assistente que você usa (Anthropic, OpenAI). Verifique se esse uso está coberto pela sua política de privacidade. O que o conector trata e por quanto tempo está na política de privacidade do conector.
Problemas comuns
| Sintoma | O que fazer |
|---|---|
| Erro de autorização (401) | A chave expirou, foi revogada ou o endereço foi copiado incompleto. Copie de novo pelo botão Conectar ou crie outra chave. Chaves de integração (API Keys) não funcionam aqui. |
| Falta alguma ferramenta | A área não foi marcada na chave. Crie outra chave com a área marcada. |
| As ferramentas não aparecem | Abra uma conversa ou sessão nova, ou reinicie o app. |
| Limite de chamadas | Aguarde um minuto e peça respostas mais resumidas. |
| Número diferente da tela | Pergunte ao assistente qual período e critério ele usou (por exemplo, só pedidos pagos) e ajuste. |
Se o problema continuar, fale com o suporte da Bevean informando o nome da chave e o horário da pergunta.