SmartBunny ← Voltar ao site

Servidor MCP · Documentação

Conecte seu assistente de IA ao SmartBunny.

O servidor MCP (Model Context Protocol) do SmartBunny permite que assistentes como o Claude e o ChatGPT leiam os seus próprios dados financeiros para responder perguntas, resumir gastos e projetar o seu fluxo de caixa. O acesso é somente leitura: nenhum dado é criado, alterado ou apagado.

🔒 Somente leitura ✅ Ativação opcional 🔑 Login seguro (OAuth) 🧾 Tudo auditado

Endpoint do servidor

Use este endereço ao adicionar o SmartBunny como conector MCP no seu assistente de IA.

Endpoint MCP https://api.smartbunny.com.br/mcp

A autenticação é feita por OAuth 2.0. Ao conectar, o assistente abre a tela de login do SmartBunny (gerenciada pela AWS Cognito) e você autoriza o acesso. Você não precisa copiar nem colar tokens manualmente.

O que o assistente consegue acessar

Todas as ferramentas são somente leitura e operam apenas sobre a sua conta. O assistente pode consultar, resumir e analisar — nunca movimentar dinheiro nem editar lançamentos.

Visão geral e contas

  • Visão geral financeira — saldos, receitas e despesas do período.
  • Contas — lista de contas com saldos e metadados.
  • Faturas de cartão — resumo das faturas de cartão de crédito.

Transações

  • Buscar transações — por texto, data, conta, categoria, comerciante ou tag.
  • Totais por assunto — quanto você gastou em uma categoria, comerciante ou tag.
  • Resumo de gastos — tendências e principais categorias e comerciantes.

Organização

  • Categorias — categorias de receita e despesa, com limites.
  • Tags e comerciantes — registros usados nos lançamentos.
  • Automações — regras de categorização e conciliação (leitura).

Planejamento e futuro

  • Projeção de fluxo de caixa — saldo realizado e projetado.
  • Orçamentos — limites ativos e configuração.
  • Metas — progresso das metas no período.

Agendamentos e recorrências

  • Séries recorrentes — assinaturas, salário, parcelamentos.
  • Ocorrências — lançamentos futuros, pagos e em atraso de uma série.
  • Resumo de recorrências — totais pendentes e realizados do período.

Importações e estado

  • Histórico de importações — extratos importados e sessões.
  • Detalhe de importação — linhas processadas e transações geradas.
  • Modo simulação — indica se a leitura é de dados simulados.

Pré-requisitos

  • Uma conta no SmartBunny — crie a sua aqui.
  • O acesso MCP ativado nas configurações da sua conta (passo abaixo).
  • Um assistente compatível com conectores MCP, como o Claude ou o ChatGPT.

Como ativar o acesso

Por segurança, o acesso MCP vem desativado. Você precisa ativá-lo explicitamente uma vez, dentro do SmartBunny.

  1. Entre na sua conta

    Acesse app.smartbunny.com.br e faça login.

  2. Abra Configurações → Integrações de IA

    Na área de integrações de IA, você verá a opção de acesso por MCP, com a explicação dos dados que ficam disponíveis (somente leitura).

  3. Ative o acesso MCP

    Ligue a opção para autorizar a leitura. Você pode desligá-la a qualquer momento — ao desativar, novas consultas do assistente passam a ser recusadas.

Como conectar

Adicione o SmartBunny como conector personalizado usando o endpoint https://api.smartbunny.com.br/mcp. Ao conectar, faça login no SmartBunny quando solicitado para concluir a autorização.

Claude

  1. Abra Configurações → Conectores.
  2. Escolha Adicionar conector personalizado.
  3. Cole o endpoint MCP do SmartBunny.
  4. Faça login no SmartBunny e autorize o acesso de leitura.
  5. Pronto: peça, por exemplo, “quanto gastei em mercado este mês?”.

ChatGPT

  1. Abra as configurações de conectores / aplicativos (MCP).
  2. Escolha adicionar um conector MCP personalizado.
  3. Cole o endpoint MCP do SmartBunny.
  4. Faça login no SmartBunny e autorize o acesso de leitura.
  5. Comece a perguntar sobre as suas finanças.

Privacidade e segurança

  • Somente leitura: o servidor MCP não cria, edita nem exclui nada na sua conta.
  • Ativação explícita: nada fica acessível até você ligar o acesso MCP nas configurações.
  • Login seguro: autenticação por OAuth 2.0 com a AWS Cognito; o assistente nunca vê a sua senha.
  • Apenas os seus dados: cada consulta retorna somente informações da sua própria conta.
  • Auditoria: toda chamada de ferramenta é registrada (ferramenta, horário, resultado).
  • Revogação: desligue o acesso MCP a qualquer momento para encerrar novas consultas.

Se a sua conta estiver em modo simulação, as respostas vêm marcadas como dados simulados — e o assistente avisa que aquele resultado não reflete os seus dados reais.

Solução de problemas e suporte

O assistente diz que o acesso MCP não está ativado

Entre em app.smartbunny.com.br, abra Configurações → Integrações de IA e ative o acesso MCP. Depois, tente a consulta novamente.

Falha de login ou autorização

Verifique se você está conectado com a mesma conta do SmartBunny. Remova e adicione o conector novamente para refazer o fluxo de login (OAuth) e reautorizar o acesso.

As respostas vêm vazias

Confirme se há dados no período consultado e se as contas/lançamentos estão importados. Tente ampliar o intervalo de datas da pergunta.

Recebi um aviso de “dados simulados”

Sua conta está em modo simulação. Saia do modo simulação no SmartBunny para consultar os seus dados reais.

Precisa de ajuda? Fale com a gente em suporte@smartbunny.com.br.