> For the complete documentation index, see [llms.txt](https://ajuda.financeiro.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.financeiro.app/guia-completo-3.0/geral/mcp-do-falcon-financas.md). # MCP do Falcon Finanças: consultas com inteligência artificial MCP do Falcon Finanças: conecte assistentes de IA (Claude, Codex, Gemini CLI, Copilot) para consultar seus dados financeiros com segurança, somente leitura na primeira versão. O **MCP do** [**Falcon Finanças**](https://dash.financeiro.app) permitirá conectar assistentes de inteligência artificial compatíveis ao Falcon para consultar informações da sua empresa com linguagem natural e dentro das permissões do usuário. Com essa integração, você poderá fazer perguntas ao seu assistente de IA e receber respostas baseadas nos dados autorizados do Falcon, sem precisar navegar por várias telas para localizar cada informação. {% hint style="info" %} O MCP está em implantação e será liberado gradualmente. A primeira versão será exclusiva para consultas e não poderá incluir, editar, baixar ou excluir lançamentos. {% endhint %} ## O que é MCP? MCP é um padrão de conexão entre assistentes de inteligência artificial e sistemas que fornecem dados ou funções específicas. No Falcon, essa conexão será feita por ferramentas controladas. A IA não receberá acesso direto ao banco de dados, não poderá enviar comandos livres e somente utilizará as consultas que o Falcon disponibilizar com segurança. ## Em quais assistentes de IA poderá ser utilizado? O MCP do Falcon utiliza um padrão aberto. Por isso, a proposta é permitir sua conexão com diferentes assistentes que sejam compatíveis com servidores MCP remotos, como: * [**Claude**](https://claude.ai/), da **Anthropic**: permite adicionar servidores MCP remotos como conectores personalizados. Consulte também a [documentação oficial de conectores do Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). * [**Codex**](https://chatgpt.com/codex), da **OpenAI**: possui suporte a servidores MCP remotos no aplicativo, na ferramenta de linha de comando e na extensão para ambientes de desenvolvimento. Consulte também a [documentação oficial de MCP do Codex](https://developers.openai.com/codex/mcp/). * [**Gemini CLI**](https://geminicli.com/), do **Google**: é o cliente do ecossistema Gemini que possui suporte documentado para conexão com servidores MCP. Consulte também a [documentação oficial de MCP do Gemini CLI](https://geminicli.com/docs/tools/mcp-server/). * [**GitHub Copilot**](https://github.com/features/copilot), do **GitHub/Microsoft**: pode utilizar servidores MCP em ambientes de desenvolvimento compatíveis, como Visual Studio Code e Visual Studio. Consulte também a [documentação oficial de MCP do GitHub Copilot](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp). * [**Microsoft Copilot Studio**](https://copilotstudio.microsoft.com/): permite adicionar um servidor MCP como ferramenta de um agente empresarial. Consulte também a [documentação oficial do Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/agents-experience/tools-add-mcp-server). Para o usuário, o assistente de IA será o local onde a pergunta será escrita. O MCP funcionará como uma ponte segura entre esse assistente e as consultas autorizadas do Falcon. {% hint style="warning" %} O fato de um assistente aceitar o padrão MCP não significa que a conexão com o Falcon já esteja liberada nele. Cada opção será testada e homologada com a autenticação do Falcon antes da publicação do respectivo passo a passo. Alguns serviços também podem exigir um plano pago, uma versão específica ou autorização do administrador da empresa. {% endhint %} No caso do Google, a compatibilidade documentada atualmente é com o **Gemini CLI**, que é uma ferramenta mais técnica. O site e o aplicativo comuns do Gemini não devem ser considerados compatíveis com o MCP do Falcon até que o Google disponibilize e documente essa configuração para esses produtos. ## O que a primeira versão permitirá? A primeira versão será **somente para leitura**. O objetivo é permitir que a IA ajude a localizar e interpretar informações financeiras já cadastradas no Falcon. As consultas serão disponibilizadas em etapas durante o piloto. No estágio técnico atual, o MCP já identifica as empresas que o usuário autenticado pode acessar. As consultas financeiras serão acrescentadas e validadas gradualmente antes da liberação aos clientes. Conforme novas consultas forem homologadas, este artigo será atualizado com a lista de informações disponíveis e exemplos de perguntas. ## O que não estará disponível na primeira versão? Nesta etapa, o assistente não poderá: * cadastrar despesas, receitas, transferências ou outros lançamentos; * alterar informações já cadastradas; * realizar pagamentos, recebimentos ou baixas; * excluir dados; * acessar empresas que não estejam liberadas para o usuário. Mesmo que uma solicitação seja feita em linguagem natural, o MCP não executará operações de escrita nesta primeira versão. ## Inclusões de lançamentos por IA A evolução planejada do MCP inclui a possibilidade de criar por IA todos os tipos de lançamentos financeiros compatíveis com o Falcon. Essa etapa será desenvolvida separadamente da conexão de consulta. Antes da liberação, as inclusões deverão passar por regras de validação, autorização e confirmação para evitar lançamentos incorretos ou não autorizados. Até que essa evolução seja oficialmente anunciada, continue realizando inclusões e alterações diretamente no Falcon pelos fluxos atuais. ## Quais planos podem usar o MCP? O MCP está disponível **a partir do plano Basic**, com o plano em dia: * o plano **Free** não utiliza o MCP; * no plano pago vencido, o MCP continua funcionando durante a carência e fica bloqueado depois dela, até a renovação; * quando a conta deixa de atender a essas condições, as conexões já feitas param de responder às consultas. Para contratar ou renovar, acesse **Meu plano**, no menu do usuário. ## Como limitar quem usa o MCP? Com o [Controle de acessos](/guia-completo-3.0/gestao/controle-de-acessos.md) ativo, só usam o MCP os usuários liberados na linha **Apps de IA conectados (MCP)**, do módulo **Sistema**. A liberação é por empresa. Com o controle desligado, todos os usuários da empresa podem usar. ## Como ver e desconectar um assistente de IA? Os assistentes que você autorizou ficam em **Apps de IA conectados**: 1. Clique na sua foto, no canto superior direito do Falcon. 2. Selecione **Apps de IA conectados**. 3. Confira os assistentes conectados, cada um com o logo (Claude, ChatGPT/Codex, Gemini, GitHub Copilot ou Cursor), a data da conexão e a última renovação do acesso. 4. Para remover um deles, clique em **Desconectar** e confirme.
Tela Apps de IA conectados com Claude, Visual Studio Code e ChatGPT, cada um com o logo e o botão Desconectar
O assistente perde o acesso na hora. Para usá-lo novamente, será preciso autorizá-lo outra vez. Cada usuário vê e desconecta somente as próprias conexões. ## Como o acesso será protegido? O acesso seguirá as permissões do próprio Falcon: * o usuário precisará se autenticar; * somente usuários ativos de contas a partir do plano Basic, com o plano em dia, poderão utilizar a integração; * o e-mail do usuário precisa estar ativado; * cada usuário verá apenas as empresas às quais possui acesso e, com o Controle de acessos ativo, em que foi liberado para o MCP; * as consultas serão limitadas às ferramentas disponibilizadas pelo Falcon; * o uso das ferramentas terá auditoria operacional; * a conexão da primeira versão será tecnicamente restrita à leitura. O assistente de IA não receberá usuário ou senha do banco de dados e não poderá executar SQL ou outras consultas livres. ## Quando poderei conectar meu assistente de IA? A liberação será feita gradualmente, começando por um piloto controlado. Quando o acesso estiver disponível, publicaremos nesta Central de Ajuda: 1. os assistentes compatíveis; 2. as versões homologadas e os requisitos para participar; 3. o passo a passo de conexão e autorização; 4. a lista de consultas disponíveis; 5. exemplos de perguntas que poderão ser feitas. ## Dúvidas comuns ### O MCP já está disponível para todos os clientes? Ainda não. A integração está em implantação e passará por um piloto controlado antes de uma disponibilidade mais ampla. ### O MCP funciona no plano Free? Não. O MCP está disponível a partir do plano Basic, com o plano em dia. Se a sua conta estiver no Free ou com o plano bloqueado por vencimento, atualize ou renove em **Meu plano**. ### Preciso ativar meu e-mail para usar o MCP? Sim. Sem o e-mail ativado, a conexão não é autorizada e as consultas de uma conexão já feita são recusadas. Para receber o link de ativação novamente, abra o **sino de notificações** no Falcon Finanças e clique em **Ative o seu e-mail**. Depois de ativar, a conexão volta a responder em até um minuto. ### Como tiro o acesso de um assistente de IA? Clique na sua foto, selecione **Apps de IA conectados** e clique em **Desconectar** no assistente desejado. O acesso é encerrado na hora. ### Poderei usar o Claude, o Codex ou o Gemini? Esses assistentes possuem opções compatíveis com o padrão MCP, mas a disponibilidade do MCP do Falcon em cada um dependerá da homologação da conexão e da autenticação. No ecossistema Gemini, o suporte documentado atualmente está no Gemini CLI. ### A IA poderá criar uma despesa ou receita? Não na primeira versão. A fase inicial permitirá somente consultas. A inclusão de lançamentos por IA faz parte da evolução planejada e será anunciada separadamente quando estiver disponível. ### A IA poderá alterar ou excluir meus dados? Não. As ferramentas da primeira versão serão somente de leitura. ### A IA verá todas as empresas da assinatura? Não necessariamente. O MCP respeitará as permissões do usuário autenticado e apresentará somente as empresas às quais esse usuário possui acesso no Falcon. ### Preciso compartilhar minha senha do Falcon com a IA? Não. O acesso será feito por um processo próprio de autenticação e autorização. Nunca envie sua senha, tokens ou outras credenciais em uma conversa com um assistente de IA.