> 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-versao-classica/integracoes/mcp-do-falcon-financas.md).

# MCP do Falcon Finanças: consultas com inteligência artificial

O **MCP do** [**Falcon Finanças**](https://falcon.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.

## 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 poderão utilizar a integração;
* cada usuário verá apenas as empresas às quais possui acesso;
* 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.

### 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.