Principais lições deste artigo
-
Integrar agentes de IA a APIs financeiras reguladas exige classificar as tools por nível de risco (read-only, operacionais, críticas) para garantir segurança e conformidade com o Banco Central e a LGPD.
-
Usar OAuth 2.1 com PKCE obrigatório, escopos granulares e trilha de auditoria estruturada é requisito mínimo para servidores MCP em ambiente regulado.
-
MCP e API REST são tecnologias complementares. O MCP expõe tools para agentes de IA, enquanto a API REST executa as operações reais. A escolha depende do consumidor e do caso de uso.
-
Open Finance e Pix no Brasil trazem exigências específicas de consentimento, SLA e controles de fraude que precisam entrar no desenho das tools MCP desde o início.
-
A Celcoin oferece APIs financeiras reguladas, participação direta no Pix e Open Finance, licenças de Instituição de Pagamento e o cel_agents, plataforma AI First que utiliza MCP como camada de interação sobre essas APIs.
Conheça a solução completa da Celcoin para agentes de IA
O que é integração com MCP? Definição para o setor financeiro
MCP (Model Context Protocol) é um protocolo aberto, governado pela Linux Foundation, que padroniza como agentes de IA acessam ferramentas, recursos e prompts de sistemas externos. No setor financeiro, ele funciona como camada de interação sobre APIs existentes, sem substituí-las. O servidor MCP expõe tools, resources e prompts que o agente descobre e invoca com contexto. A API REST subjacente continua executando o trabalho real.
A especificação MCP de 28 de julho de 2026 tornou o núcleo stateless. Cada requisição viaja de forma independente e carrega versão de protocolo, identidade do cliente e capacidades em _meta, sem necessidade de armazenamento compartilhado de sessão. O SDK TypeScript do MCP (Tier 1) implementa a especificação 2026-07-28 desde o lançamento.
A diferença central em relação a uma API REST tradicional está no consumidor. A API expõe endpoints para código de aplicação. O servidor MCP expõe tools, resources e prompts para agentes de IA que precisam descobrir e invocar capacidades com contexto em tempo de execução.
O que é uma API de integração financeira?
No contexto brasileiro, APIs de integração financeira são interfaces que conectam sistemas a serviços como contas digitais, Pix, boletos, TED, cartões e Open Finance. Elas operam sob regulação do Banco Central, seguem padrões de segurança como FAPI (Financial-grade API) e exigem conformidade com LGPD para tratamento de dados pessoais.
Um servidor MCP financeiro se apoia nessas APIs para oferecer tools ao agente. A qualidade, a documentação e a cobertura regulatória da API subjacente determinam diretamente a segurança e a escalabilidade do servidor MCP construído sobre ela. APIs mal documentadas, sem sandbox ou sem suporte a OAuth 2.1 transferem complexidade e risco para a camada MCP.
Veja como o banking da Celcoin acelera integrações financeiras reguladas
Passo 1: entenda a arquitetura de um servidor MCP financeiro
O fluxo básico de um servidor MCP financeiro segue esta sequência:
-
O agente de IA envia uma requisição ao servidor MCP.
-
O servidor MCP autentica a requisição via OAuth 2.1, valida escopos e identifica a tool solicitada.
-
O servidor MCP chama a API financeira subjacente, como API de banking, API para Pix ou API de Open Finance.
-
A resposta retorna ao agente em formato compacto e contextualizado.
As três primitivas do MCP se aplicam diretamente a serviços financeiros:
-
Tools: ações que o agente pode executar, como iniciar uma transferência Pix, criar uma cobrança ou consultar saldo.
-
Resources: dados que o agente pode ler, como extratos, dados cadastrais ou informações de Open Finance compartilhadas com consentimento.
-
Prompts: orientações que guiam o agente em jornadas específicas, como onboarding de conta ou análise de elegibilidade de crédito.
O servidor MCP atua como camada de interação sobre as APIs financeiras. O cel_agents, plataforma AI First da Celcoin lançada em 24 de agosto de 2026 no Febraban Tech, usa MCP exatamente nesse papel. A plataforma disponibiliza um ambiente gratuito de testes em até cinco minutos e conta com cerca de 15 jornadas financeiras iniciais, incluindo abertura de contas, Pix, boletos, Open Finance e emissão de cartões.
A tabela abaixo detalha como cada funcionalidade da Celcoin contribui para a construção de um servidor MCP seguro e escalável.
|
Funcionalidade da Celcoin |
Benefício para sua empresa |
|---|---|
|
APIs modulares |
Integrações mais rápidas, com redução de custos e prazos de desenvolvimento. |
|
Experiência e suporte ao desenvolvedor |
Documentação, SDKs e sandboxes que reduzem ciclos de integração e custos de engenharia. |
|
Capacidade de lançamento rápido |
Módulos pré-construídos e entrega via SaaS aceleram lançamentos e melhoram o tempo para geração de receita. |
|
Distribuição white-label e embutida |
Suporte a produtos financeiros com marca própria. |
|
Escalabilidade com confiabilidade |
Solução com alta disponibilidade e escalável na nuvem mantém serviços funcionando mesmo com altos volumes. |
|
Cobertura de diversas possibilidades de pagamentos, incluindo crédito |
Oferecer pagamentos e emissão de crédito aumenta conversão, receita por usuário e fidelização. |
|
Acesso a dados e personalização |
Dados e análises via Open Finance permitem ofertas personalizadas, com impacto em conversão e retenção. |
|
Compliance e conformidade como princípio |
KYC, AML e relatórios integrados reduzem risco regulatório e aceleram ciclos de vendas. |
|
Prevenção de fraude e controles de risco |
Monitoramento baseado em IA e autenticação robusta reduzem estornos, perdas e exposição regulatória. |
|
Força do ecossistema de parceiros da Celcoin |
Parcerias e integrações com bancos, redes e fintechs ampliam cobertura e velocidade de entrada no mercado. |
Passo 2: classifique as tools MCP por risco
A classificação de tools por nível de risco diferencia implementações seguras de implementações expostas. Sem essa classificação, tools críticas como iniciação de pagamento Pix ficam sujeitas aos mesmos controles de uma consulta de saldo, o que viola boas práticas de engenharia e exigências regulatórias do Banco Central e da LGPD.
Nível 1, read-only: consultas de saldo, extratos, dados de Open Finance compartilhados com consentimento.
-
Controles: OAuth 2.1 com escopo de leitura, como
mcp:tool:consulta_saldo:read, log de acesso e auditoria.
Nível 2, operacionais: criação de cobranças, emissão de boletos, atualização cadastral.
-
Controles: OAuth 2.1 com escopo específico por operação, confirmação explícita do usuário, idempotency key e logs de auditoria estruturados.
Nível 3, críticas: iniciação de pagamentos Pix, transferências TED, movimentações de conta.
-
Controles: OAuth 2.1 com escopo restrito, como
mcp:tool:pix_transfer:exec, confirmação explícita em duas etapas, idempotency key obrigatória, trilha de auditoria imutável e monitoramento de fraude em tempo real.
A idempotency key garante que uma mesma instrução de pagamento não seja processada duas vezes em caso de retentativa, falha frequente em ambientes de agentes que reenviam requisições após timeout. Já a confirmação explícita do usuário em operações críticas atua em outra frente. Ela quebra a cadeia de ataque de injeção de prompt e impede que conteúdo malicioso em documentos lidos pelo agente acione transferências sem aprovação humana.
A classificação por risco é pré-requisito para conformidade com a LGPD, pelo princípio da minimização e da finalidade, e com as normas do Banco Central para Instituições de Pagamento, que exigem controles proporcionais ao risco de cada operação.
Descubra essa solução completa para fintechs, bancos digitais, gestoras de fundos, varejistas e ERPs
Passo 3: configure segurança, OAuth 2.1 e LGPD em ambiente regulado
Em servidores MCP remotos com transporte HTTP, a especificação MCP exige OAuth 2.1 com PKCE obrigatório para todos os clientes públicos. O servidor MCP atua exclusivamente como resource server. Ele valida tokens, aplica escopos e delega autenticação e emissão de tokens a um authorization server externo. O servidor não deve reutilizar o token recebido do cliente para chamar APIs downstream, prática conhecida como token passthrough, que cria vulnerabilidade de confused deputy.
Os elementos essenciais da configuração de segurança são:
-
Escopos granulares: definidos por tool e por nível de risco, seguindo o princípio do menor privilégio. Escopos amplos demais representam uma das falhas mais comuns em implementações MCP.
-
Tokens de curta duração: access tokens com validade de 5 a 15 minutos e refresh tokens com expiração absoluta de 24 horas, o que força reautenticação diária.
-
Validação de audiência: o servidor MCP rejeita tokens não emitidos especificamente para ele, mesmo que a assinatura seja válida.
-
Revogação de refresh token: ao detectar reuso de token já invalidado, o sistema deve revogar toda a família de tokens imediatamente.
No âmbito da LGPD, o tratamento de dados financeiros em um servidor MCP exige base legal documentada para cada atividade de processamento. Execução de contrato se aplica a operações bancárias, cumprimento de obrigação legal se aplica a KYC e AML, e consentimento específico se aplica ao compartilhamento via Open Finance. O consentimento no Open Finance tem validade máxima de 12 meses, é revogável instantaneamente e deve cobrir o uso específico do agente, não apenas o acesso aos dados.
A trilha de auditoria mínima viável para conformidade regulatória deve registrar, no momento de cada decisão, timestamp de precisão sub-segundo, identidade do usuário, tool invocada, base legal aplicada, dados de entrada utilizados e resultado da operação. Logs gerados post-hoc não atendem ao Artigo 20 da LGPD, que exige que o mecanismo de explicabilidade esteja embutido na arquitetura operacional.
A Celcoin opera com licenças próprias de Instituição de Pagamento, participação direta no Pix e infraestrutura de Open Finance que já contempla KYC, AML, relatórios regulatórios automatizados, como DIMP, CADOCs e CCS, e conformidade com Banco Central, Receita Federal e SUSEP. Construir um servidor MCP sobre essa base reduz de forma relevante o esforço de conformidade regulatória.
Passo 4: compare MCP e API REST tradicional
MCP e API REST funcionam como tecnologias complementares. A maioria dos servidores MCP internamente chama APIs REST e as encapsula para acesso por agentes de IA. A escolha entre os dois modelos depende do consumidor e do caso de uso.
Quando usar API REST diretamente: integrações determinísticas entre sistemas, pipelines de alto volume e propósito único, fluxos em lote agendados e cenários em que o comportamento determinístico é crítico para auditoria regulatória. APIs REST entregam tempos de resposta de aproximadamente 850 ms em média e contam com mais de 20 anos de ecossistema de segurança consolidado.
Quando usar MCP: agentes de IA que precisam descobrir e invocar capacidades com contexto em tempo de execução, cenários com múltiplos sistemas corporativos conectados e jornadas financeiras conversacionais. O overhead de protocolo do MCP é de 100 a 300 ms por requisição, com impacto de cold start de 2 a 5 segundos na primeira chamada. Essa latência é aceitável em fluxos conversacionais, mas relevante em pipelines de alta volumetria.
Em termos de custo de manutenção, integrações ponto a ponto crescem em complexidade rapidamente. Cinco sistemas significam cinco bases de código separadas, cinco implementações de autenticação e cinco padrões de tratamento de erro. Com MCP, o servidor é construído uma vez e atende todos os agentes compatíveis com o protocolo. O MCP também proporciona redução de 50 a 80% no consumo de tokens por meio de respostas compactas, entre 1 e 5 KB, em vez de payloads brutos de API, entre 5 e 50 KB.
Veja como o banking da Celcoin apoia arquiteturas com MCP e APIs REST
Passo 5: aplique MCP ao Open Finance e ao Pix no Brasil
Com a arquitetura definida e as diferenças entre MCP e API REST esclarecidas, o próximo passo é aplicar esse conhecimento aos dois pilares do sistema financeiro brasileiro: Open Finance e Pix. O Open Finance Brasil ultrapassou 200 milhões de consentimentos ativos em junho de 2026, com bilhões de chamadas de API bem-sucedidas semanalmente. Um servidor MCP pode expor tools para todo o ciclo do Open Finance, incluindo obtenção de consentimento, compartilhamento de dados cadastrais e transacionais e iniciação de pagamento.
As particularidades regulatórias do Open Finance que o servidor MCP deve respeitar incluem:
-
Consentimento com especificidade e finalidade declarada previamente ao titular, validade máxima de 12 meses e revogabilidade instantânea.
-
Autenticação por redirecionamento app-to-app ou web-to-app, que elimina screen scraping.
-
Uso dos dados estritamente para a finalidade declarada no consentimento. Reaproveitar dados de Open Finance para usos além do escopo declarado constitui violação regulatória, mesmo quando o fluxo é executado por agente autônomo.
Para o Pix, as tools de nível crítico, como iniciação de pagamento, consulta de status e devolução, exigem os controles descritos no Passo 2. Esses controles incluem OAuth 2.1 com escopo restrito, confirmação explícita em duas etapas, idempotency key obrigatória e trilha de auditoria imutável. Agentes que iniciam ou roteiam transações Pix precisam garantir que a decisão do agente não introduza latência ou modos de falha que violem os requisitos de SLA do Pix estabelecidos pelo Banco Central.
A Celcoin tem participação direta no Pix e infraestrutura de Open Finance com APIs bem documentadas e compatíveis com padrões REST, o que cria uma base adequada para um servidor MCP em produção. As jornadas iniciais do cel_agents já cobrem fluxos de Open Finance e Pix.
A Celcoin oferece infraestrutura de crédito como parte de sua solução full stack, permitindo que empresas ofertem produtos de crédito aos seus clientes. A Celcoin não oferece nenhum tipo de empréstimo para consumidores. A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes.
Passo 6: implemente um MCP para serviços financeiros
-
Definir as tools e classificá-las por risco, em read-only, operacionais e críticas, documentando cada uma com esquemas de entrada e saída claros.
-
Escolher a API financeira subjacente e verificar documentação, SDKs, sandbox e cobertura regulatória.
-
Configurar OAuth 2.1 com escopos granulares por tool, PKCE obrigatório e consentimento do usuário para cada finalidade de processamento.
-
Implementar idempotency key e confirmação explícita do usuário para todas as tools de nível operacional e crítico.
-
Montar trilha de auditoria estruturada com timestamp sub-segundo, identidade do usuário, tool invocada, base legal e resultado, registrada no momento da decisão.
-
Testar em ambiente sandbox antes de produção, cobrindo cenários de retentativa, timeout e rejeição de token.
-
Validar conformidade com LGPD, incluindo base legal, finalidade, minimização, consentimento e direito de revogação, e com normas do Banco Central para o tipo de operação e licença aplicável.
-
Monitorar e evoluir as tools conforme novas jornadas, revisando escopos periodicamente e atualizando definições de tools quando a API subjacente mudar.
Passo 7: valide com critérios de sucesso e evite erros comuns
Os indicadores de uma implementação bem-sucedida incluem estabilidade operacional, com ausência de falhas por duplicidade ou timeout não tratado, tempo de implementação de novas jornadas, redução de retrabalho de integração, aderência regulatória verificável por auditoria, qualidade das definições de tools, com esquemas claros e descrições que guiam corretamente o agente, e escalabilidade sob volume crescente de requisições.
As falhas mais frequentes em implementações de servidores MCP financeiros são:
-
Expor tools críticas sem confirmação explícita do usuário, o que abre caminho para injeção de prompt.
-
Ignorar idempotency key em operações de pagamento, o que gera duplicidade de transações.
-
Usar escopos OAuth amplos demais, o que viola o princípio do menor privilégio e a LGPD.
-
Não registrar trilha de auditoria estruturada, o que impossibilita investigação de incidentes e atendimento a solicitações de titulares.
-
Tratar LGPD como etapa posterior, sem mapear base legal para cada atividade de processamento antes do go-live.
-
Subestimar a complexidade regulatória do Open Finance e do Pix, especialmente os requisitos de consentimento granular e SLA operacional.
As boas práticas recomendadas são:
-
Começar por tools read-only para validar a arquitetura antes de expor operações críticas.
-
Testar exaustivamente em sandbox, incluindo cenários de reuso de refresh token e token com audiência incorreta.
-
Documentar cada tool com esquema JSON e descrição que guie o comportamento do agente.
-
Revisar escopos periodicamente.
-
Manter trilha de auditoria imutável com retenção compatível com os prazos regulatórios aplicáveis.
Veja como a Celcoin simplifica a conformidade regulatória para sua empresa
Perguntas frequentes
O que é integração por MCP?
Integração por MCP é a conexão de agentes de IA a sistemas externos por meio do Model Context Protocol, um protocolo aberto baseado em JSON-RPC 2.0 que padroniza como o agente descobre e invoca ferramentas, recursos e prompts. No setor financeiro, o servidor MCP funciona como camada de interação sobre APIs financeiras reguladas e expõe essas APIs em formato consumível por agentes. A especificação de 28 de julho de 2026 tornou o núcleo do protocolo stateless e permite que servidores MCP sejam implantados em infraestrutura escalável padrão, sem gerenciamento de sessão persistente.
O que é uma API de integração financeira?
Uma API de integração financeira é uma interface programática que conecta sistemas a serviços como contas digitais, Pix, boletos, TED, cartões e Open Finance, operando sob regulação do Banco Central e em conformidade com a LGPD. No contexto de um servidor MCP, a API financeira é a camada que executa as operações reais. O servidor MCP encapsula essa API e a expõe como tools para agentes de IA. A qualidade da API subjacente, incluindo documentação, sandbox, suporte a OAuth 2.1 e cobertura regulatória, determina diretamente a segurança e a escalabilidade do servidor MCP construído sobre ela.
Quais bancos possuem API no Brasil?
No Brasil, o Open Finance obriga instituições de grande porte, dos segmentos S1 e S2, a disponibilizar APIs padronizadas para compartilhamento de dados e iniciação de pagamento, com adoção voluntária massificada por fintechs e bancos digitais. Além das APIs do Open Finance, instituições como a Celcoin disponibilizam APIs modulares para Banking as a Service e Core Banking, cobrindo contas digitais, Pix, boletos, TED, cartões, Open Finance e Open Insurance. A Celcoin atua como participante direta no Pix e como Iniciadora de Pagamentos no Open Finance, com APIs documentadas e compatíveis com padrões REST e FAPI.
Como garantir segurança e LGPD em um MCP server financeiro?
A segurança de um servidor MCP financeiro requer OAuth 2.1 com PKCE obrigatório, escopos granulares por tool e por nível de risco, tokens de acesso de curta duração, entre 5 e 15 minutos, validação de audiência em cada requisição e trilha de auditoria estruturada registrada no momento de cada decisão. Para conformidade com a LGPD, cada atividade de processamento de dados deve ter base legal documentada antes do go-live, como execução de contrato para operações bancárias, consentimento específico para Open Finance e cumprimento de obrigação legal para KYC e AML. Como detalhado no Passo 3, o consentimento tem validade máxima de 12 meses, é revogável instantaneamente e deve cobrir o uso específico do agente, não apenas o acesso aos dados. Logs gerados post-hoc não atendem ao Artigo 20 da LGPD, por isso o mecanismo de explicabilidade precisa estar embutido na arquitetura operacional.
MCP substitui API REST?
MCP e API REST são tecnologias complementares e resolvem problemas diferentes. A maioria dos servidores MCP internamente chama APIs REST e as encapsula para acesso por agentes de IA. A API REST continua sendo a escolha adequada para integrações determinísticas entre sistemas, pipelines de alto volume e fluxos em lote. O servidor MCP é a escolha adequada quando o consumidor é um agente de IA que precisa descobrir e invocar capacidades com contexto em tempo de execução. O ponto de virada em que o MCP reduz o custo total de propriedade em relação a integrações ponto a ponto costuma aparecer a partir de três ou mais integrações conectadas a agentes.
Preciso usar o cel_agents Studio para integrar com a Celcoin?
O uso do cel_agents Studio é opcional. Essa ferramenta existe para que profissionais de produto visualizem e testem jornadas financeiras de forma interativa, sem necessidade de conhecimento em programação. Empresas que já possuem interfaces e padrões próprios de desenvolvimento podem utilizar apenas os recursos de integração assistida por IA via MCP, mantendo sua arquitetura e seus processos. A IA, por meio do MCP, cria uma camada de interação sobre as APIs da Celcoin.
A Celcoin oferece suporte para integração via MCP?
A Celcoin oferece suporte especializado para integração via MCP. O cel_agents disponibiliza um ambiente gratuito de testes em poucos minutos, com jornadas financeiras iniciais cobrindo abertura de contas, Pix, boletos, Open Finance e emissão de cartões. A Celcoin oferece documentação, SDKs e sandboxes que reduzem ciclos de integração, além de suporte com acesso direto a decisores. Para empresas que já são clientes da Celcoin, o cel_agents também permite atualizar integrações existentes, incorporar novos produtos financeiros ou adaptar a operação a mudanças regulatórias sem reconstruir a infraestrutura.
Conclusão: próximos passos para integrar agentes de IA a serviços financeiros
Implementar um servidor MCP financeiro com consistência técnica, operacional e regulatória exige executar os sete passos deste guia em sequência. Esses passos incluem definir e classificar tools por risco, escolher a API financeira adequada, configurar OAuth 2.1 com escopos granulares, implementar idempotency key e confirmação explícita para operações críticas, montar trilha de auditoria estruturada, testar em sandbox e validar conformidade com LGPD e normas do Banco Central antes de ir a produção.
Atalhos nesse caminho, como expor tools críticas sem confirmação explícita, usar escopos amplos demais ou operar sem trilha de auditoria, expõem a operação a fraudes, duplicidade de transações e sanções regulatórias. A base tecnológica sobre a qual o servidor MCP é construído determina em grande parte o esforço de conformidade necessário.
A Celcoin reúne, em uma única plataforma, as APIs financeiras reguladas, a infraestrutura de Open Finance e Pix, as licenças de Instituição de Pagamento, o compliance embutido e o cel_agents, plataforma AI First que usa MCP como camada de interação sobre essas APIs. Os próximos passos práticos são avaliar as jornadas financeiras relevantes para o seu produto, testar no ambiente gratuito do cel_agents e evoluir para produção com a mesma infraestrutura.
Descubra essa solução completa para fintechs, bancos digitais, gestoras de fundos, varejistas e ERPs


