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 e atualizem os seus próprios dados financeiros: respondem perguntas, criam e editam lançamentos, categorias e regras, e conduzem a importação de extratos do começo ao fim. Você controla o que cada assistente pode fazer com escopos de permissão.

🧰 43 ferramentas 🔁 Leitura e escrita 🔑 OAuth 2.1 com escopos 🧾 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.1. Ao conectar, o assistente abre a tela de login do SmartBunny (gerenciada pela AWS Cognito) e você autoriza os escopos de acesso que quiser conceder. Você não precisa copiar nem colar tokens manualmente.

O que o assistente consegue fazer

As 43 ferramentas cobrem leitura e escrita, sempre limitadas à sua conta e aos escopos que você autorizou. O assistente pode consultar, resumir, criar e editar — mas nunca movimentar dinheiro: o SmartBunny não executa pagamentos nem transferências.

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 — consultar regras, criar novas e aplicá-las aos lançamentos.

Planejamento e futuro

  • Projeção de fluxo de caixa — saldo realizado e projetado.
  • Orçamentos — status, ritmo de gastos, quanto ainda dá para gastar por dia e comparações entre períodos.
  • 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.

Lançamentos e organização (escrita)

  • Transações — criar, editar e excluir lançamentos.
  • Contas, categorias, tags e comerciantes — criar e atualizar registros.
  • Orçamentos, investimentos e recorrências — gerenciar pela conversa.

Importação de extratos

  • Fluxo completo — iniciar o rascunho, escolher a conta de destino.
  • Revisão — resolver duplicidades e conciliar com o que já existe.
  • Conclusão — confirmar (ou descartar) a importação com segurança.

Pré-requisitos

  • Uma conta no SmartBunny — crie a sua aqui.
  • Um assistente compatível com conectores MCP, como o Claude ou o ChatGPT.

Permissões e escopos

O acesso MCP vem habilitado para todas as contas — mas nada acontece até você conectar um assistente e autorizá-lo pelo login OAuth. Na autorização, o acesso é dividido em escopos, e o assistente só consegue usar as ferramentas dos escopos concedidos.

  1. smartbunny/mcp.read

    Consultas: visão geral, transações, projeções, orçamentos, metas, recorrências e histórico de importações.

  2. smartbunny/mcp.import

    Importação de extratos: iniciar rascunhos, resolver duplicidades, conciliar e confirmar.

  3. smartbunny/mcp.accounts.write

    Contas: criar e atualizar contas bancárias e de cartão.

  4. smartbunny/mcp.transactions.write

    Lançamentos e organização: transações, categorias, tags, comerciantes, orçamentos, automações e recorrências.

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 os escopos desejados.
  5. Pronto: peça, por exemplo, “quanto gastei em mercado este mês?”.

ChatGPT

  1. Acesse chatgpt.com/plugins e clique em Adicionar (Add).
  2. Escolha Criar servidor MCP personalizado (Create custom MCP server).
  3. Na aba URL do servidor, cole o endpoint MCP do SmartBunny, marque a caixa de ciência e clique em Criar como plugin.
  4. Faça login no SmartBunny e autorize os escopos desejados.
  5. Comece a perguntar sobre as suas finanças.

Não é mais preciso ativar o modo desenvolvedor. Se a opção não aparecer, verifique o seu plano do ChatGPT — em contas Business/Enterprise, o administrador do workspace pode ter bloqueado conectores personalizados.

Privacidade e segurança

  • Escopos granulares: você decide o que autorizar — leitura, importação, escrita de contas, escrita de lançamentos.
  • Nada acontece sem você: o servidor só responde a assistentes que você conectou e autorizou pelo OAuth.
  • Login seguro: autenticação por OAuth 2.1 com a AWS Cognito; o assistente nunca vê a sua senha.
  • Apenas os seus dados: cada chamada opera somente sobre informações da sua própria conta.
  • Auditoria: toda chamada de ferramenta é registrada (ferramenta, horário, resultado).
  • Revogação: remova o conector no assistente a qualquer momento para encerrar o acesso.

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 não tem permissão para uma ferramenta

A ferramenta pertence a um escopo que não foi autorizado. Remova e adicione o conector novamente e, na tela de autorização, conceda o escopo que falta.

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.