Visio MCP: como conectar o Claude.ai aos dados da Visio

Para donos, franqueados e gerentes de loja que usam o Claude no navegador (claude.ai) ou no aplicativo do computador.

Disponível nos planos do Visio OS. Para contratar, fale com o responsável da sua conta. A liberação da conexão depois da adesão pode levar algumas horas; para acelerar, avise o responsável da sua conta.

Estamos trabalhando para disponibilizar esta conexão como plugin, para a instalação ficar mais simples. Por enquanto, siga os passos abaixo.

Sobre

Este guia mostra como ligar o Claude, o assistente de IA da Anthropic, aos dados da sua operação na Visio. Depois de conectado, você pergunta em português, do jeito que perguntaria a um colega, e o Claude busca a resposta nos seus números.

Em uma frase: você conecta uma vez, entra com o seu login da Visio e passa a perguntar sobre vendas e faturamento direto na conversa.

Usa o Claude Code ou o Codex, no terminal? Cada um tem o seu guia nesta mesma seção.

Prefere ver em vídeo?

Se o vídeo não carregar, assista no YouTube.

Antes de começar

Tenha uma conta no Claude. Funciona em qualquer plano, inclusive o gratuito, que permite um conector.
Tenha em mãos o seu login da Visio, o mesmo e-mail e senha que você usa na plataforma.
Você não precisa de senha ou código extra. A conexão usa o seu login da Visio, feito uma vez pelo navegador.
O Claude só vê o que você já vê na Visio. Se o seu usuário tem acesso a três lojas, as respostas trazem só essas três.

Leva cerca de 5 minutos.

Os nomes dos menus abaixo estão como aparecem no Claude em inglês. Se o seu Claude estiver em português, eles aparecem traduzidos, no mesmo lugar.

Passo 1 — Adicione o conector da Visio

Abra o Claude e vá em Customize > Connectors.
Clique em + Add e escolha Add custom connector.
Em nome, escreva Visio.
No endereço do servidor, cole: https://mcp.visio.ai/mcp
Clique em Continue e, na tela seguinte, em Continue de novo.
Em Authentication, escolha Sign in now.
Em OAuth client, escolha Use your own OAuth client e, no campo Client ID, escreva mcp-visio. Deixe o campo de senha (Client Secret) em branco.
Clique em Add.

Se a sua empresa usa o Claude nos planos Team ou Enterprise: quem adiciona o conector é o administrador do Claude na sua empresa, em Organization settings > Connectors, com os mesmos dados acima. Depois disso, você só abre Customize > Connectors, encontra o Visio e clica em Connect.

Passo 2 — Entre com o seu login da Visio

O navegador abre a tela de login da Visio. Entre com o seu e-mail e senha da Visio.

Você vai saber que deu certo quando voltar para o Claude e o conector Visio aparecer como conectado. Você só faz isso uma vez.

Passo 3 — Ligue o conector na conversa

Abra uma conversa nova.
Clique no +, no canto inferior esquerdo da caixa de mensagem.
Escolha Connectors e deixe o Visio ligado.

Faça a sua primeira pergunta

Agora é só conversar. Escreva a pergunta do seu jeito, por exemplo:

Quais métricas de vendas estão disponíveis?
Qual foi o faturamento dos últimos 7 dias, por loja?
Compare o faturamento desta semana com o da semana passada na loja do shopping.

Dica: na primeira vez, peça para o Claude mostrar o que existe ("quais métricas existem no domínio de vendas?"). Assim você descobre o que dá para perguntar.

Dica: quando a pergunta for sobre um período, diga as datas ("de 1º a 24 de agosto de 2026"). A resposta fica mais precisa.

Se algo não funcionar

O que acontece	O que fazer
O login da Visio mostra uma mensagem de erro logo ao abrir	Confira se o Client ID é exatamente `mcp-visio`. Remova o conector e adicione de novo.
O Claude responde sem usar os dados da Visio	Confira se o Visio está ligado em + > Connectors na conversa.
O Claude diz que você não está autenticado	O acesso expirou. Entre de novo em Customize > Connectors > Visio.
Conecta, mas o Claude diz que não encontrou nenhum dado	O seu usuário da Visio ainda não tem dados liberados. Fale com o responsável da sua conta Visio.
O Claude reclama da data	Diga o período com início e fim, por exemplo "de 1º a 24 de agosto de 2026".

Esta conexão está liberada sem custo adicional, para um uso justo dentro da proposta do Visio OS.