Suporte às integrações

O que é a integração

A integração permite que uma plataforma de IA consulte informações da sua conta do Manda a partir dos seus pedidos em linguagem natural — por exemplo, "quais contas vencem esta semana?" ou "qual foi o fluxo de caixa de agosto?". Ela é somente leitura e usa o MCP (Model Context Protocol), um padrão aberto que plataformas de IA usam para acessar serviços externos com autorização do usuário.

A disponibilidade depende de cada plataforma e do seu plano nela: é preciso que a plataforma aceite conectores MCP remotos com autorização por login (OAuth). Os menus e nomes das opções mudam com frequência; em caso de dúvida, consulte a ajuda da própria plataforma sobre conectores personalizados.

Pré-requisitos

• Um usuário ativo no Manda Pro Financeiro, com e-mail e senha próprios. Usuários com perfil de solicitante não podem usar a integração.
• Acesso, no Manda, às empresas que você quer consultar. A integração só enxerga as empresas vinculadas ao seu usuário.
• Uma conta em uma plataforma de IA que permita adicionar conectores MCP remotos.

Como conectar

1. Na plataforma de IA, procure a opção de adicionar um conector ou app personalizado (MCP) e informe o endereço do servidor do Manda, indicado abaixo. Não é preciso informar client ID nem segredo.
2. A plataforma abrirá o aplicativo do Manda. Entre com seu e-mail e senha — digite-os somente no endereço que começa com https://app.mandaprofinanceiro.com, nunca na conversa.
3. Na tela de autorização, confira o nome do aplicativo que está pedindo acesso e os tipos de dado listados. Só autorize se reconhecer a plataforma que você mesmo está conectando.
4. Volte à plataforma e faça um pedido simples, como "liste as minhas contas bancárias no Manda", para testar.

Passo a passo no Claude

1. No Claude, abra Configurações > Conectores. Se o Manda Pro Financeiro não aparecer no diretório, escolha Adicionar conector personalizado e informe o endereço do servidor. Deixe Client ID e Client Secret em branco.
2. Clique em Conectar. O Claude abre a tela de login do Manda Pro Financeiro.
3. Entre com seu usuário e senha, confira o nome do aplicativo e o acesso pedido — somente leitura dos dados das empresas às quais você está vinculado — e aprove.
4. Você volta ao Claude com o conector ativo e já pode fazer perguntas. Para desconectar, remova o conector em Configurações > Conectores e peça a revogação ao suporte.

Depois de adicionar, rode /mcp no Claude Code para autenticar. Os nomes dos menus podem mudar; em caso de dúvida, consulte a ajuda do Claude sobre conectores.

Consultas disponíveis

Todas as consultas são somente leitura. A plataforma de IA escolhe qual usar a partir do seu pedido.

• Visão geral financeira (get_dashboard) — Saldo das contas ativas e títulos vencidos e a vencer nos próximos 7 dias, separados entre pagar e receber.
• Listar contas bancárias (list_accounts) — Contas ativas com banco, agência, número e saldo calculado pela mesma regra do painel do Manda.
• Listar títulos (list_payments) — Títulos a pagar e a receber, com filtros de status, meio de pagamento, vencimento e texto.
• Listar transações bancárias (list_bank_transactions) — Lançamentos do extrato importado, com filtros de conta, período e texto.
• Fluxo de caixa previsto (get_cash_flow) — Títulos agrupados por mês de vencimento, separando o que há a pagar e a receber.
• Agregar dados financeiros (aggregate_financial_data) — Totais por período, categoria, centro de custo ou contraparte, com pagar e receber separados.
• Listar contratos (list_contracts) — Contratos recorrentes que geram os títulos previstos.
• Buscar pessoas e empresas (get_people) — Clientes, fornecedores e demais contrapartes, por nome ou documento (CPF ou CNPJ).
• Listar plano de contas e centros de custo (list_categories_and_divisions) — Categorias e centros de custo usados para classificar os títulos.
• Auditar qualidade dos dados (audit_data_quality) — Aponta contas sem saldo atualizado e títulos em aberto sem categoria.
• Buscar no Manda (search) — Busca unificada por títulos, contratos, pessoas e lançamentos bancários.
• Abrir registro do Manda (fetch) — Abre um registro encontrado pela busca, com todos os campos relevantes.

Exemplos de perguntas

• Quanto tenho a pagar e a receber nos próximos 7 dias?
• Qual é o saldo de cada conta hoje?
• Monte o fluxo de caixa previsto dos próximos três meses.
• Quais foram as maiores despesas por categoria no último trimestre?
• Quais títulos em aberto estão sem categoria?

O que a integração faz — e o que não faz

• Consulta títulos a pagar e a receber, contas e saldos, lançamentos de extrato, contratos, cadastros de clientes e fornecedores, categorias, fluxo de caixa e totais agrupados, e aponta problemas de qualidade nos dados.
• É somente leitura: não cria, altera nem exclui registros no Manda.
• Não movimenta dinheiro: não paga contas, não faz transferências bancárias e não acessa seu internet banking.
• Só acessa as empresas vinculadas ao seu usuário e não amplia as permissões dele.
• As respostas são redigidas pela plataforma de IA a partir dos dados do Manda e podem conter erros de interpretação. Na dúvida, confira na plataforma do Manda.

Reconectar, desconectar e revogar

Reconectar: a autorização é renovada automaticamente enquanto você usa a integração. Se ela ficar 30 dias sem renovar, a plataforma pedirá que você entre e autorize de novo. Use a opção de reconectar ou remova e adicione o conector outra vez.

Desconectar: remova o conector nas configurações da plataforma de IA. Isso impede novas consultas por aquela plataforma, mas não apaga dados no Manda nem conversas já registradas na plataforma.

Revogar no Manda: escreva para contato@mandaprofinanceiro.com com o assunto "Revogação de integração — [plataforma]", de preferência a partir do e-mail cadastrado no Manda. Nossa equipe de suporte faz a revogação assim que confirma o pedido, dentro do horário de atendimento. Enquanto não houver revogação, a plataforma pode continuar renovando a conexão sem prazo final (ela só expira após 30 dias sem uso) — por isso, peça sempre a revogação quando desconectar por segurança ou deixar de usar a integração.

• Política de privacidade — integrações
• Política de privacidade — retenção e exclusão