Visio MCP: como conectar o Claude Code aos dados da Visio

Para donos, franqueados e gerentes de loja que usam o Claude Code no terminal.

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 Code, a versão do Claude que roda no terminal, aos dados da sua operação na Visio. O terminal é a janela onde você digita comandos para o computador. Depois de conectado, você pergunta em português, do jeito que perguntaria a um colega, e o Claude Code busca a resposta nos seus números.

Em uma frase: você cola um comando, entra com o seu login da Visio e passa a perguntar sobre vendas e faturamento direto no Claude Code.

Usa o Claude no navegador ou no aplicativo do computador? Siga o guia do Claude.ai, nesta mesma seção. É mais simples e não usa o terminal.

Antes de começar

Tenha o Claude Code instalado. Se ainda não tem, instale pela página oficial, claude.com/product/claude-code.
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 Code 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.

Passo 1 — Abra o terminal

No Mac: aperte Command + Espaço, digite Terminal e aperte Enter.
No Windows: clique no menu Iniciar, digite PowerShell e abra o aplicativo.

Para conferir que o Claude Code está instalado, digite o comando abaixo e aperte Enter:

claude --version

Se aparecer um número de versão, está tudo certo. Se aparecer uma mensagem de "comando não encontrado", instale o Claude Code pela página oficial antes de seguir.

Passo 2 — Conecte o Claude Code à Visio

Copie o comando abaixo inteiro, numa linha só, cole no terminal e aperte Enter:

claude mcp add --scope user --transport http visio-data https://mcp.visio.ai/mcp --client-id mcp-visio --callback-port 51510

Esse comando avisa o Claude Code de que existe uma fonte de dados chamada visio-data e onde ela fica. Com ele, a conexão vale para qualquer pasta em que você abrir o Claude Code.

Copie exatamente como está: os valores mcp-visio e 51510 precisam ser esses para o login da Visio funcionar.

Passo 3 — Entre com o seu login da Visio

No terminal, digite claude e aperte Enter para abrir o Claude Code.
Na caixa de conversa, digite /mcp e aperte Enter.
Na lista que aparece, escolha visio-data com as setas do teclado e aperte Enter.
Escolha Authenticate.
O navegador abre na tela de login da Visio. Entre com o seu e-mail e senha da Visio.
Quando o navegador avisar que deu certo, volte para o terminal.

Você só faz isso uma vez. O Claude Code renova o acesso sozinho, sem você precisar entrar de novo.

Passo 4 — Confira se está conectado

Digite /mcp de novo. Você vai saber que deu certo quando aparecer connected (conectado) ao lado de visio-data.

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 Code 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	O comando do Passo 2 não foi copiado inteiro. No terminal, digite `claude mcp remove visio-data`, aperte Enter e repita os Passos 2 e 3.
visio-data não aparece na lista do `/mcp`	O comando do Passo 2 não foi aceito. Feche o Claude Code (digite `/exit`), cole o comando de novo no terminal e confira se ele ficou inteiro, numa linha só.
Ao lado de visio-data aparece needs authentication	O login não foi concluído. Repita o Passo 3.
O navegador abre, você entra, mas o terminal não reage	No terminal, digite `claude mcp remove visio-data` e aperte Enter. Depois repita os Passos 2 e 3.
O Claude Code diz que você não está autenticado	O acesso expirou. Entre de novo pelo `/mcp`, como no Passo 3.
Conecta, mas o Claude Code 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 Code 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.