Visio MCP: como conectar o Codex aos dados da Visio

Para donos, franqueados e gerentes de loja que usam o Codex, da OpenAI, 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 Codex, o assistente da OpenAI 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 Codex 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 Codex.

Usa o Claude Code ou o Claude.ai? Cada um tem o seu guia nesta mesma seção.

Antes de começar

Tenha o Codex instalado e com o login da OpenAI feito. Se ainda não tem, instale pela página oficial, developers.openai.com/codex.
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 Codex 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 Codex está instalado, digite o comando abaixo e aperte Enter:

codex --version

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

Passo 2 — Conecte o Codex à Visio

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

codex mcp add visio-data --url https://mcp.visio.ai/mcp --oauth-client-id mcp-visio

Esse comando avisa o Codex de que existe uma fonte de dados chamada visio-data e onde ela fica. A conexão vale para qualquer pasta em que você abrir o Codex.

Copie exatamente como está: o valor mcp-visio precisa ser esse para o login da Visio funcionar.

Passo 3 — Entre com o seu login da Visio

Logo depois do comando, 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.
No terminal, aparece a mensagem Successfully logged in (login concluído).

Se o navegador não abrir sozinho, digite o comando abaixo e aperte Enter:

codex mcp login visio-data

Você só faz isso uma vez. O Codex renova o acesso sozinho.

Passo 4 — Confira se está conectado

Digite o comando abaixo e aperte Enter:

codex mcp list

Você vai saber que deu certo quando, na linha do visio-data, a coluna Auth mostrar OAuth. Se aparecer Not logged in (sem login), repita o Passo 3 com o comando codex mcp login visio-data.

Faça a sua primeira pergunta

No terminal, digite codex e aperte Enter para abrir o Codex. Agora é só conversar. Escreva a pergunta do seu jeito, por exemplo:

Use a Visio e mostre 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 Codex mostrar o que existe na Visio. 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 `codex mcp remove visio-data`, aperte Enter e repita os Passos 2 e 3.
O navegador não abre depois do comando	Digite `codex mcp login visio-data` e aperte Enter.
visio-data não aparece no `codex mcp list`	O comando do Passo 2 não foi aceito. Cole o comando de novo e confira se ele ficou inteiro, numa linha só.
O Codex diz que você não está autenticado	O acesso expirou. Digite `codex mcp login visio-data` e entre de novo.
O Codex responde sem usar os dados da Visio	Peça de forma explícita: "use a Visio para responder".
Conecta, mas o Codex 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 Codex 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.