FINANCEIA · GUIA DE CONEXÃO COM IA

Conecte o Financeia ao ChatGPT, Gemini e Claude

Da primeira conexão a uma transação aprovada: escolha o que compartilhar, consulte seus registros e revise cada alteração proposta.

URL do servidor MCP de produçãohttps://api.financeia.app/mcp

Escolha OAuth. Não é necessária uma chave de API do provedor. A disponibilidade depende da conta, região e políticas do espaço de trabalho; as interfaces podem mudar.

Comece com a conta e o perfil certos

  1. Entre no Financeia e sincronize seus registros. As conexões com IA estão incluídas em todos os planos e ficam desativadas até você consentir.

  2. Ative Assistentes de IA conectados, leia cada declaração de consentimento e confirme com sua senha atual.

  3. Compartilhe apenas os perfis pessoais ou conjuntos desejados. A permissão de leitura permite consultar relatórios; a de propostas também envia sugestões para revisão de IA. O acesso conjunto nunca ultrapassa suas próprias permissões.

Aplicativo web

Abra seu avatar → Configurações → Assistentes de IA conectados.

Aplicativo móvel

Abra seu avatar → Configurações → Preferências de segurança → Assistentes de IA conectados. Ative a opção e leia o consentimento.

Web: Assistentes de IA conectados nas configurações do Financeia.
Web: Assistentes de IA conectados nas configurações do Financeia.
Móvel: Configurações → Preferências de segurança → Assistentes de IA conectados.
Móvel: Configurações → Preferências de segurança → Assistentes de IA conectados.

ChatGPT

Adicione um plugin MCP personalizado no ChatGPT

Use o ChatGPT na web em um espaço de trabalho que permita servidores MCP personalizados.

  1. Abra Plugins → Adicionar (+) → Adicionar servidor MCP personalizado. Em interfaces antigas, a opção pode estar em Aplicativos ou Modo de desenvolvedor.

  2. Use Financeia como nome, informe a URL de produção acima e selecione OAuth. Deixe as credenciais de cliente em branco, a menos que o Financeia as tenha fornecido à sua organização.

  3. Leia e confirme o aviso. Escolha Criar como plugin e depois Instalar/Conectar. Conclua a autorização do Financeia abaixo.

  4. Abra uma nova conversa. Digite @, selecione Financeia e peça a lista dos perfis compartilhados. Confira a conta antes de continuar.

ChatGPT: URL de produção e OAuth no formulário MCP personalizado.
ChatGPT: URL de produção e OAuth no formulário MCP personalizado.

Instruções oficiais do provedor

Gemini

Crie um aplicativo personalizado no Gemini

Atualmente, o Google exige uma conta pessoal elegível de um adulto nos EUA, idioma inglês e armazenamento de atividade ativado. Uma assinatura não garante acesso; consulte os requisitos atuais do Google.

  1. Abra Personalizar → Conectores ou Configurações → Inteligência pessoal → Aplicativos conectados.

  2. Selecione Criar aplicativo personalizado, informe a URL MCP de produção e avance.

  3. Leia os avisos do Google, prossiga com a vinculação das contas e conclua a autorização do Financeia abaixo.

  4. Em uma nova conversa, digite @ e escolha Financeia. Peça os perfis compartilhados. Se não houver aplicativos personalizados, consulte os critérios de elegibilidade do Google.

Gemini: informe a URL do servidor no formulário de aplicativo personalizado.
Gemini: informe a URL do servidor no formulário de aplicativo personalizado.

Instruções oficiais do provedor

Claude

Adicione um conector remoto no Claude

Em organizações Team ou Enterprise, o proprietário pode precisar adicionar o conector primeiro; depois, cada membro autoriza sua própria conta do Financeia.

  1. Abra Personalizar → Conectores → Adicionar → Adicionar conector personalizado. Proprietários também podem usar Configurações da organização → Conectores.

  2. Informe Financeia e a URL MCP de produção e escolha Continuar.

  3. Escolha Entrar agora. Use a identidade publicada compatível do Claude ou o registro automático; não selecione Sem login nem cole um token de acesso. Adicionar → Conectar.

  4. Conclua a autorização do Financeia abaixo. Ative o Financeia no menu de conectores/ferramentas e peça os perfis compartilhados em uma nova conversa.

Claude: o conector remoto usa o login OAuth do Financeia.
Claude: o conector remoto usa o login OAuth do Financeia.

Instruções oficiais do provedor

Autorize no Financeia, nunca na conversa

  1. Confira se o endereço é https://financeia.app. Informe suas credenciais do Financeia ali e conclua as verificações de segurança habituais. Nunca envie sua senha ao assistente.

  2. Se solicitado, ative as conexões com IA e aceite o aviso atual. Confira a identidade do assistente, selecione apenas os perfis desejados e escolha leitura ou leitura/propostas.

  3. Confirme com sua senha atual, se necessário, e escolha Conectar/Permitir. Volte ao provedor; se a solicitação expirou, inicie a conexão novamente.

Transforme uma sugestão em um registro confirmado

Exemplo com dados fictícios
No meu perfil Pessoal, proponha uma despesa de 25 USD da conta Everyday checking, categoria Food & groceries, em 21 de outubro de 2026, com a descrição “Almoço de demonstração do guia”. Pergunte pelos dados que faltarem. Envie uma única vez para revisão.
  1. Primeiro peça ao assistente que encontre o perfil, a conta e a categoria exatos e confirme moeda, data e fuso horário. Ele deve perguntar pelos dados ausentes.

  2. Confira os dados da chamada da ferramenta antes de permitir a proposta. Uma proposta não registra uma transação nem altera o saldo.

  3. Abra a revisão de IA no Financeia web ou móvel, selecione o perfil correto e confira valor, conta, moeda, data, categoria, descrição e alertas de duplicidade. Aprove a versão revisada, edite e revise novamente ou recuse. Confira a seleção antes de aprovar em lote.

  4. Aguarde a confirmação. Após uma interrupção, use get_proposal_status ou get_batch_status e verifique a transação na busca ou nos detalhes antes de tentar novamente. Nunca reenvie um lote com resultado incerto.

Pelo menos três possíveis duplicatas em 30 segundos podem gerar um alerta informativo. O assistente deve conferir envios repetidos; o alerta não os rejeita automaticamente.

Web: confira o evento exato antes de aprovar.
Web: confira o evento exato antes de aprovar.
Móvel: caixa de revisão de IA e detalhes das propostas.
Móvel: caixa de revisão de IA e detalhes das propostas.

Todas as ações disponíveis

As 58 ferramentas, com permissões e campos de entrada. Os identificadores técnicos são mantidos para corresponder às chamadas reais.

Comece com list_profiles e informe o profile_id escolhido. Use get_capabilities, get_profile_context e get_data_completeness para consultar funções, fuso horário, moedas e cobertura.

Referência completa de JSON Schema (contrato técnico)

Perfis compartilhados e permissõeslist_profilesLer / simular

Permissão: financeia:read

Entradas: Nenhuma

Buscar contas permitidasfind_accountsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), query, include_inactive, offset

Buscar categoriasfind_categoriesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), kind, query, offset

Buscar posições de investimentofind_holdingsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), query, offset

Buscar imóveisfind_propertiesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), query, offset

Buscar instrumentos financeirosfind_instrumentsLer / simular

Permissão: financeia:read

Entradas: query (obrigatório)

Panorama financeiroget_financial_snapshotLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), currency

Despesas por categoria e períodoget_spending_summaryLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), period_start (obrigatório), period_end (obrigatório), currency

Resumo do fluxo de caixaget_cashflow_summaryLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), months, currency

Duração da reserva de emergênciaget_emergency_runwayLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), currency

Simular compra sem registrarsimulate_purchase_impactLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), amount (obrigatório), currency (obrigatório)

Buscar transações registradassearch_transactionsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), period_start, period_end, text, category_id, account_id, limit, cursor

Saldos e resumo da contaget_account_summaryLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit

Resumo dos investimentosget_holdings_summaryLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit

Resumo dos imóveisget_property_summaryLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit

Cobertura e qualidade dos dadosget_data_completenessLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório)

Propor transaçõespropose_transactionsPropor para revisão

Permissão: financeia:propose

Entradas: profile_id (obrigatório), request_summary (obrigatório), items (obrigatório)

Propor correção de transaçãopropose_correctionPropor para revisão

Permissão: financeia:propose

Entradas: profile_id (obrigatório), request_summary (obrigatório), correction (obrigatório)

Propor categoriapropose_categoryPropor para revisão

Permissão: financeia:propose

Entradas: profile_id (obrigatório), request_summary (obrigatório), category (obrigatório)

Propor contapropose_accountPropor para revisão

Permissão: financeia:propose

Entradas: profile_id (obrigatório), request_summary (obrigatório), account (obrigatório)

Propor posição de investimentopropose_holdingPropor para revisão

Permissão: financeia:propose

Entradas: profile_id (obrigatório), request_summary (obrigatório), holding (obrigatório)

Propor imóvelpropose_propertyPropor para revisão

Permissão: financeia:propose

Entradas: profile_id (obrigatório), request_summary (obrigatório), property (obrigatório)

Propor ordem das contaspropose_account_orderPropor para revisão

Permissão: financeia:propose

Entradas: profile_id (obrigatório), request_summary (obrigatório), order (obrigatório)

Status da propostaget_proposal_statusLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), proposal_id (obrigatório)

Status do loteget_batch_statusLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), batch_id (obrigatório)

Entidades e identificadoresfind_entitiesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Orçamentos configurados por categorialist_budget_categoriesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Orçamentos históricos salvoslist_budget_snapshotsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Eventos planejados e recorrenteslist_planned_eventsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Metas e valores reservados de poupançalist_savings_goalsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Planos de dívida e premissaslist_debt_plansLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Modelos de lançamento salvoslist_entry_templatesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Regras de identificação de estabelecimentoslist_merchant_aliasesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Listas de acompanhamento de gastoslist_spending_watchlistsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Definições de relatórios salvoslist_saved_reportsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Agendamentos de relatórios sem execuçãolist_report_schedulesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_version, query

Recursos disponíveisget_capabilitiesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório)

Fuso horário e moedas do perfilget_profile_contextLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório)

Calendário financeiroget_finance_calendarLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), period_start (obrigatório), period_end (obrigatório)

Ocorrências de eventos planejadosget_planned_occurrencesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), period_start (obrigatório), period_end (obrigatório), series_id

Desempenho das entidadesget_entity_performanceLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), period_start (obrigatório), period_end (obrigatório), currency, entity_code (obrigatório)

Revisão do ciclo orçamentárioget_budget_period_reviewLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), period_start (obrigatório), period_end (obrigatório)

Histórico dos ciclos orçamentárioslist_budget_period_historyLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit

Detalhes da transaçãoget_transaction_detailLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), event_id (obrigatório)

Histórico de alterações da transaçãoget_transaction_historyLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), event_id (obrigatório), cursor

Rateios da transaçãoget_transaction_allocationsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), event_id (obrigatório)

Histórico de saldos registradosget_account_balance_historyLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), account_id (obrigatório), months, through

Histórico de avaliações de investimentosget_holding_valuation_historyLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), holding_id (obrigatório), offset, limit, expected_version

Detalhes do investimentoget_holding_detailLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), holding_id (obrigatório)

Detalhes do imóvelget_property_detailLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), property_id (obrigatório)

Histórico de avaliações de imóveisget_property_valuation_historyLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), property_id (obrigatório), offset, limit, expected_version

Etiquetasget_tagsLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), offset, limit, expected_revision

Fila de revisão de transaçõesget_transaction_review_queueLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), query

Progresso do acompanhamento de gastosget_spending_watchlist_progressLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório)

Preferências de notificaçõesget_notification_preferencesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório)

Taxas de câmbio dos relatóriosget_reporting_ratesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), currency

Buscas salvas em Livrosget_saved_book_searchesLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório)

Evidências dos valores da carteiraget_portfolio_evidenceLer / simular

Permissão: financeia:read

Entradas: profile_id (obrigatório), period_start (obrigatório), period_end (obrigatório), currency

Leia cada resultado no contexto

Preserve período, moeda, datas de referência, revisão e metadados de qualidade. Siga a paginação: a busca retorna no máximo 25 transações por página. Se a revisão mudar, reinicie a consulta de forma consistente. Valores ausentes não são zero. Orçamentos salvos são evidências históricas. As explicações do assistente não são aconselhamento financeiro profissional.

Ajuda, recuperação e controle

A opção de conector personalizado não aparece

Confira plano, região, idioma e políticas do provedor. O proprietário da equipe pode precisar adicioná-lo; veja as instruções oficiais acima.

A verificação de segurança está indisponível

Recarregue a aba de login do Financeia e deixe a verificação normal do Cloudflare terminar. Confira a conexão e bloqueadores de conteúdo. Se persistir, informe horário e erro ao suporte; não contorne a verificação.

O assistente vê outro perfil ou nenhum dado

Peça list_profiles. Confira a conta do Financeia, os perfis selecionados, a sincronização e a cobertura. Conecte novamente se a autorização expirou.

Uma proposta aparece duas vezes

Confira primeiro o status da proposta/lote e a revisão de IA. Leia os alertas e recuse sugestões pendentes indesejadas; não reenvie sem verificar.

Desconectar ou reduzir o acesso

Em Configurações do Financeia → Assistentes de IA conectados, revogue a conexão, remova um perfil compartilhado ou desative as conexões. Remova/desconecte também no provedor. O acesso futuro para, mas os dados já enviados não são apagados.

Qual ambiente devo usar?

Este guia usa produção. O ambiente de testes tem contas e controles separados. Não compartilhe dados privados com uma conexão de teste por engano.

Um perfil. Uma pergunta. Sua aprovação.

Comece com uma consulta somente de leitura. Ative propostas quando estiver familiarizado com a revisão.

Abrir configurações do FinanceiaConhecer o FinanceiaFalar com a equipe

As capturas mostram dados fictícios de demonstração. As telas do Financeia usam o idioma do artigo; os nomes das contas de exemplo e os identificadores técnicos permanecem iguais. As telas do ChatGPT, Gemini e Claude continuam em inglês. As interfaces e os requisitos de acesso podem mudar.