Como conectar o OlaClick a um assistente de IA (servidor MCP)

Como conectar seu assistente de IA ao OlaClick

Conecte o Claude, o Cursor ou outro assistente compatível diretamente à sua conta e pergunte sobre suas vendas, pedidos e clientes em linguagem natural, sem exportar nada manualmente.

O que é essa conexão

O OlaClick disponibiliza um servidor MCP (Model Context Protocol), um padrão aberto que permite que assistentes de IA acessem sistemas externos de forma segura.

Na prática: em vez de entrar no painel e aplicar filtros, você pergunta ao seu assistente "quanto vendi esta semana em comparação com a anterior?" e ele consulta os dados da sua conta para responder.

Nada é instalado no seu computador. O servidor é hospedado pelo OlaClick, e a conexão é feita com um token de acesso que você mesmo gera e pode revogar quando quiser.

Disponibilidade: o acesso por API está disponível para negócios com os planos Premium, Elite e Infinity.

Assistentes compatíveis

O painel oferece configuração assistida para:

Assistente	Tipo de configuração
Claude (web e desktop)	Guiado
Claude Code (terminal)	Guiado
Cursor (editor de código)	1 clique
VS Code (Copilot)	1 clique
Kiro (IDE agêntico)	1 clique
Qualquer outro cliente compatível com MCP	Guiado

1 clique abre o aplicativo e configura tudo sozinho. Guiado mostra os passos com botões de copiar, porque esses clientes não aceitam links de instalação.

O que o assistente consegue consultar

Depois de conectado, o assistente tem acesso às informações que você liberar no momento da configuração:

Vendas e pedidos: pedidos com filtros por status, tipo de serviço, origem, período e forma de pagamento, além de estatísticas de produtos mais vendidos.
Clientes: lista de clientes com filtros por nome, telefone, pontos de fidelidade e comportamento de compra.
Cardápio: categorias, produtos, variantes, preços e disponibilidade.
Negócio: dados da empresa, horários de funcionamento e se está aberto no momento.
Relatórios: dados consolidados da sua operação.

Como conectar

Passo 1: Abra a tela de conexão

No painel do OlaClick, vá ao menu lateral em Integrações > API Keys e clique em CONECTAR COM IA.

Passo 2: Escolha seu assistente

Selecione o assistente que você usa. O painel gera a chave e monta a configuração para aquele cliente específico.

Passo 3: Defina as permissões

Você escolhe o que o assistente pode fazer com seus dados:

Somente leitura (recomendado): o assistente consulta seus dados, mas não altera nada.
Leitura e edição de cardápio: além de consultar, pode alterar nomes e descrições de produtos.

Com somente leitura, o assistente não consegue alterar preços, cancelar pedidos nem mexer no seu cardápio. É a opção recomendada para começar.

Nessa mesma tela você define o vencimento da chave (90 dias é o padrão recomendado) e o nome da chave, para reconhecê-la depois na lista de tokens.

Clique em GERAR CHAVE E CONECTAR.

Passo 4: Conclua no seu assistente

Para clientes de 1 clique (Cursor, VS Code, Kiro), o painel abre o aplicativo e a configuração é aplicada automaticamente.

Para o Claude, siga os passos exibidos na tela:

No Claude, abra Personalizar > Connectors, toque em Add e escolha Add custom connector.
Dê um nome ao conector (por exemplo, OlaClick) e cole a URL do servidor MCP fornecida na tela. Toque em Continue.
Em Authentication, escolha None.
Em Request headers, escolha authorization na lista de nomes e cole o valor fornecido pelo painel, mantendo a palavra Bearer no início.
Salve. Em qualquer conversa, toque em + > Connectors e ative o OlaClick.

Atenção ao passo 3. O Claude vem com Always required pré-selecionado, porque detecta que o servidor pede autenticação. É preciso mudar para None: o OlaClick usa uma chave de acesso, não OAuth. Se ficar em "Always required", a conexão falha.

Como testar se funcionou

Com a conexão ativa, faça uma pergunta simples ao assistente:

"Quanto vendi esta semana em comparação com a anterior?"
"Quais são meus 5 produtos mais vendidos neste mês?"
"Quais clientes não compram há 30 dias?"
"Mostre os pedidos de delivery cancelados de ontem."
"Meu restaurante está aberto agora? Qual é o horário de hoje?"

Se o assistente responder com dados do seu negócio, está tudo certo.

Como gerenciar e revogar o acesso

Todos os tokens gerados ficam listados em Integrações > API Keys, com nome, permissões, data de criação, último uso e status. No botão VER de cada linha você encontra:

Detalhe: informações da chave, incluindo permissões, data de criação, último uso e vencimento.
Editar permissões: altera o que o assistente pode acessar. A mudança vale imediatamente.
Revogar: encerra o acesso na hora.

A revogação não pode ser desfeita. Quem estava usando aquele token perde o acesso imediatamente e passa a receber erros. Para restabelecer a conexão, é preciso gerar um novo token e configurá-lo novamente.

Segurança

O token aparece uma única vez, no momento em que é criado. Guarde em local seguro.
Conceda apenas as permissões necessárias. Se você só quer consultar dados, use somente leitura.
Defina um vencimento. Chaves com prazo reduzem o risco em caso de vazamento.
Trate o token como uma senha: não compartilhe em grupos, documentos abertos ou capturas de tela.
Se suspeitar que o token foi exposto, revogue e gere outro.

Perguntas frequentes

Preciso instalar algum programa? Não. O servidor é hospedado pelo OlaClick. A configuração acontece dentro do assistente que você já usa.

O assistente pode alterar dados do meu restaurante? Só se você conceder permissão de edição. Na opção somente leitura, ele apenas consulta.

Conectei e o assistente não responde. O que verificar? No Claude, o erro mais comum é deixar Authentication em "Always required". Precisa ser None. Confirme também se o header authorization foi colado por inteiro, incluindo a palavra Bearer.

Perdi o token. Consigo vê-lo de novo? Não. O valor completo é exibido apenas na criação. Gere um novo token e revogue o anterior.

O que acontece quando o token vence? A conexão deixa de funcionar. Gere um novo token e refaça a configuração no assistente.

Onde encontro a documentação técnica? Em https://developers.olaclick.app/docs/mcp, com a lista completa de ferramentas e parâmetros.

Última atualização: 15/09/2026 · por Pedro B.