O que é o MCP?

O MCP (Model Context Protocol) permite que assistentes de IA como Claude, Codex e Cursor acessem seus dados financeiros no Visor de forma segura. Com essa conexão, você pode conversar com a IA e pedir coisas como:

• "Quanto gastei com alimentação este mês?"
• "Crie uma categoria para assinaturas"
• "Qual meu saldo previsto para o final do mês?"
• "Mostre meus gastos por categoria"

A IA acessa seus dados em tempo real e pode até criar transações, categorias, metas e regras de categorização para você.

Requisitos

• Plano Pro do Visor
• Um cliente MCP compatível (Claude Code, Codex, Cursor, Claude Desktop ou outro)

Como conectar

Opção 1: Claude Code (CLI)

No terminal, execute:

claude mcp add visor --transport http https://mcp.visorfinance.app

Opção 2: Codex (CLI)

No terminal, execute:

codex mcp add visor -- npx mcp-remote https://mcp.visorfinance.app

> Requer Node.js instalado (o mcp-remote funciona como ponte entre o cliente e o servidor).

Opção 3: Cursor

Edite o arquivo ~/.cursor/mcp.json e adicione:

{ "mcpServers": { "visor": { "url": "https://mcp.visorfinance.app" } } }

Opção 4: Claude Desktop ou outros clientes

Para clientes que usam configuração JSON (como Claude Desktop), adicione ao bloco mcpServers:

{ "mcpServers": { "visor": { "command": "npx", "args": ["mcp-remote", "https://mcp.visorfinance.app"] } } }

> Requer Node.js instalado.

Autenticação

Na primeira vez que o cliente MCP tentar se conectar, uma janela do navegador vai abrir automaticamente para você fazer login no Visor. Depois de autenticar, a conexão fica ativa e você não precisa fazer login novamente.

O transporte usa HTTP com OAuth 2.0 - um padrão seguro de autorização. Seus dados nunca são compartilhados sem seu consentimento.

O que a IA pode fazer com o MCP?

Consultar seus dados

• Ver resumo financeiro (saldo, receitas, despesas)
• Listar transações com filtros
• Ver gastos por categoria
• Consultar projeção de saldo
• Acompanhar ritmo de gastos
• Ver contas fixas, receitas recorrentes e parcelamentos
• Listar metas e acompanhar progresso
• Consultar limites do orçamento

Criar e editar

• Criar categorias e regras de categorização
• Adicionar transações manuais e contas manuais
• Criar e editar contas fixas e receitas recorrentes
• Definir limites de orçamento
• Criar metas financeiras
• Adicionar e gerenciar tags
• Gerar gráficos dos seus dados

Onde encontrar as instruções no Visor

Você também pode copiar os comandos de instalação diretamente no Visor:

1. Abra o Visor no navegador
2. Vá em Configurações
3. Na seção Apps conectados, você encontra o card do servidor MCP com os comandos prontos para copiar

Problemas comuns

A janela de login não abre

Verifique se o navegador padrão está configurado corretamente. Alguns terminais podem bloquear a abertura automática - nesse caso, copie a URL que aparece no terminal e cole no navegador.

Erro de autenticação

Certifique-se de que você está logado no Visor com uma conta do plano Pro. O MCP não está disponível no plano gratuito.

Comando npx não encontrado

Instale o Node.js (versão 18 ou superior) em nodejs.org.

O cliente não reconhece o servidor

Reinicie o cliente MCP depois de adicionar a configuração. A maioria dos clientes precisa ser reiniciada para carregar novos servidores.