Principais lições deste artigo
-
MCP para serviços financeiros em marketplace exige separar a interface do agente da infraestrutura financeira regulada. Essa separação garante segurança jurídica e conformidade com o Banco Central.
-
Tools MCP precisam de organização por domínio funcional, como pagamentos, banking, crédito e conciliação. Cada operação de escrita exige controles adicionais de autorização e limites.
-
Implementação segura exige autenticação OAuth 2.0, limites de gasto, idempotência, trilha de auditoria e confirmação humana para transações críticas.
-
No Brasil, a camada regulada precisa de licenças adequadas, como IP, subadquirência e iniciação de pagamentos, além de capacidade de split nativo, KYC e reporte ao Bacen.
-
A Celcoin oferece a infraestrutura regulada completa para marketplaces que desejam adotar MCP com segurança e conformidade; conheça os detalhes da solução.
O problema: por que MCP em marketplace trava antes de mover dinheiro
Em uma API tradicional, o desenvolvedor define explicitamente quais endpoints chamar, em qual ordem e com quais parâmetros. O agente de IA altera essa dinâmica. Ele descobre tools disponíveis em tempo de execução, decide autonomamente qual invocar e pode encadear chamadas sem intervenção humana. A especificação oficial do MCP descreve um protocolo que opera sobre JSON-RPC 2.0 e expõe três primitivas. Essas primitivas são tools, que são funções executáveis, resources, que são dados somente leitura, e prompts, que são templates reutilizáveis. Todas são expostas a um host de IA por meio de um servidor externo.
O bloqueio real de adoção em marketplace é regulatório e de segurança transacional. Quando o agente passa de consultar saldos para executar um split de pagamento, o marketplace precisa responder a perguntas que uma API tradicional nunca precisou responder de forma autônoma. A primeira é quem autorizou a transação. A segunda é se o seller está com KYC aprovado. A terceira é se o repasse respeita a segregação de patrimônio exigida pelo Banco Central. A quarta é se a operação gera os reportes regulatórios corretos. Sem uma camada financeira regulada por trás do gateway MCP, o agente não pode mover dinheiro com segurança jurídica no Brasil.
Veja como a Celcoin resolve o bloqueio regulatório para agentes financeiros.
A solução: arquitetura de um MCP gateway para serviços financeiros
A separação entre a camada de interface do agente e a infraestrutura financeira regulada é o princípio arquitetural central. O servidor MCP para marketplace atua como um gateway. Ele traduz as intenções do agente em chamadas estruturadas, enquanto a liquidação, a custódia de recursos e a responsabilidade regulatória permanecem na camada financeira regulada.
O fluxo arquitetural segue esta estrutura:
-
O agente recebe uma instrução do usuário ou de outro agente.
-
O agente consulta o MCP gateway e descobre as tools disponíveis.
-
O agente invoca a tool adequada com os parâmetros necessários.
-
O MCP gateway valida a requisição, aplica controles de segurança transacional e repassa para a infraestrutura regulada.
-
A infraestrutura regulada executa a operação, como split, KYC, liquidação ou repasse, e retorna o resultado estruturado.
-
O MCP gateway devolve o resultado ao agente, que gera a resposta final.
-
A infraestrutura regulada registra a operação e gera os reportes ao Banco Central.
Nessa arquitetura, o servidor MCP para marketplace é a interface. A Celcoin é a camada regulada. A Celcoin opera com licença de Instituição de Pagamento, atua como subadquirente da Rede, é participante direta no Pix e Iniciadora de Pagamentos no Open Finance, com conexão à Rede do Sistema Financeiro Nacional e ao Sistema de Pagamentos Brasileiro. Isso significa que split, liquidação, KYC, reporte ao Bacen e segregação patrimonial são executados por uma entidade autorizada e supervisionada, e não pelo gateway MCP.
Conheça a infraestrutura regulada que sustenta um MCP gateway seguro.
Quais ferramentas expor para um marketplace
O catálogo de tools precisa de organização por domínio funcional. Cada tool corresponde a uma operação específica do fluxo do marketplace e é invocada pelo agente no momento adequado da jornada.
Domínio: pagamentos
-
create_payment: cria uma ordem de pagamento para o comprador. O agente aciona essa tool quando confirma o carrinho e inicia o checkout.
-
refund: processa estorno total ou parcial de uma transação. O agente aciona essa tool quando identifica uma solicitação de devolução válida.
-
split: é a tool central para MCP para split de pagamento. Ela divide o valor líquido entre múltiplos beneficiários, como seller, plataforma e afiliado, na própria liquidação. O marketplace não toca os recursos do vendedor. A divisão ocorre diretamente na liquidação, o que evita custódia indevida de valores de terceiros.
Domínio: banking
-
create_seller: abre uma conta digital para o vendedor na infraestrutura regulada. O agente aciona essa tool durante o onboarding do seller.
-
kyc_seller: submete documentos e dados do seller para verificação de identidade e conformidade com as exigências do Banco Central. O agente aciona essa tool antes de habilitar o seller para receber repasses.
-
get_seller_balance: consulta o saldo disponível e bloqueado do seller. O agente aciona essa tool quando precisa informar o vendedor sobre sua posição financeira ou calcular repasses.
Domínio: crédito
-
get_credit_offer: consulta ofertas de crédito disponíveis para um lojista com base em seu histórico transacional na plataforma. O agente aciona essa tool quando identifica elegibilidade para capital de giro. A Celcoin fornece a infraestrutura tecnológica para 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.
Domínio: conciliação
-
reconcile_transactions: cruza transações processadas com repasses realizados, identificando divergências por seller e por período. O agente aciona essa tool em fechamentos diários ou sob demanda em fluxos de conciliação.
Explore as APIs modulares da Celcoin para pagamentos, banking e crédito.
Como implementar um MCP gateway para serviços financeiros
-
Definição de escopo de tools: mapear quais operações financeiras o agente pode invocar. Separar tools de leitura, como consultas de saldo e status de transação, de tools de escrita, como criação de pagamento, split e repasse. Tools de escrita exigem controles adicionais.
-
Autenticação: implementar OAuth 2.0 com escopos granulares por tool, seguindo os mecanismos de autorização descritos na documentação oficial do MCP. Cada sessão de agente deve ter credenciais próprias, que não podem ser compartilhadas.
-
Limites de gasto e velocidade: configurar tetos por transação, por sessão e por período, como diário e mensal, antes de o agente entrar em produção. O gateway precisa verificar esses limites, e não apenas a aplicação.
-
Idempotência: garantir que toda tool de escrita aceite e registre uma chave de idempotência única por requisição. Esse controle evita que retentativas após timeout de rede gerem pagamentos ou splits duplicados.
-
Auditoria: registrar em log imutável cada invocação de tool com a identidade do agente, a identidade do usuário ou principal que autorizou a sessão, os parâmetros de entrada, o resultado e o timestamp. O log precisa ficar armazenado fora do alcance de escrita do próprio agente.
-
Confirmação humana: definir thresholds acima dos quais o agente suspende a execução e solicita aprovação humana por canal autenticado fora da banda. Esse cuidado é essencial para transações com contrapartes novas, valores próximos ao teto da sessão ou fora do horário comercial.
-
Integração com a camada regulada: conectar o MCP gateway à infraestrutura financeira autorizada pelo Banco Central. Essa integração garante que split, liquidação, KYC e reportes regulatórios sejam executados pela entidade licenciada, e não pelo gateway.
MCP para KYC e onboarding de sellers
O onboarding de sellers via agente é um dos fluxos de maior valor e maior risco regulatório em um marketplace. A tool kyc_seller precisa ser invocada antes de qualquer repasse ao vendedor, e seu fluxo deve respeitar três camadas de exigência.
A primeira camada é o consentimento. O seller deve autorizar de forma expressa o compartilhamento de seus dados para fins de verificação de identidade, em conformidade com a LGPD, Lei nº 13.709/2018. O agente não pode submeter dados de terceiros sem consentimento registrado e rastreável.
A segunda camada é a verificação regulatória. A Resolução BCB 150/2021 determina que marketplaces que intermediam repasses enquadram-se como instituições de pagamento, com obrigações de PLD, FT e KYC. O agente pode orquestrar a coleta de documentos e a submissão, mas a validação e o registro precisam ocorrer na infraestrutura regulada.
A terceira camada é a rastreabilidade. Cada etapa do onboarding, como submissão de documentos, resultado da verificação, aprovação ou rejeição, precisa ser registrada com timestamp e vinculada ao identificador único do seller. Esse registro cria uma trilha auditável para fiscalização do Banco Central.
MCP para conciliação e repasse a vendedores
A tool reconcile_transactions permite que o agente cruze automaticamente as transações processadas com os repasses realizados. Esse cruzamento identifica divergências por seller, por período e por instrumento de pagamento. Esse fluxo é especialmente relevante em marketplaces com grande volume de sellers e múltiplos meios de pagamento.
O papel do agente na conciliação é de orquestração e interpretação. O agente consulta os dados estruturados retornados pela infraestrutura regulada, identifica padrões de divergência e sinaliza exceções para revisão humana. A liquidação e o reporte regulatório permanecem integralmente na camada financeira regulada.
A LC 214/2025 criou o mecanismo de split payment tributário, pelo qual o IBS e a CBS são segregados e recolhidos automaticamente na liquidação financeira da transação. Esse mecanismo adiciona uma dimensão tributária ao fluxo de conciliação. A tool de reconciliação precisa distinguir o valor líquido do seller do valor retido para recolhimento tributário, e a infraestrutura regulada deve fornecer esses dados de forma estruturada ao MCP gateway.
Segurança transacional: limites, autorização, idempotência, auditoria e confirmação humana
Segurança transacional define se um marketplace pode colocar um agente em produção com autoridade transacional. Cinco controles são inegociáveis.
Limites de gasto: o Agentic Transaction Security Framework, ATSF, da Cloud Security Alliance recomenda monitoramento em três níveis simultâneos. O primeiro é o nível de transação individual. O segundo é o nível de sessão, que compara o gasto autorizado cumulativo com o teto da sessão. O terceiro é o nível agregado, que observa o comportamento coletivo de todas as instâncias de agentes. Quando um limite é atingido, o agente deve suspender novas operações e escalar para revisão humana. O agente não pode falhar de forma silenciosa.
Autorização por papel: cada tool de escrita precisa verificar se o agente tem o escopo de autorização necessário para aquela operação específica. Esse controle aplica o princípio do menor privilégio. Um agente autorizado a consultar saldos não deve ter permissão para executar repasses.
Idempotência: toda operação financeira executada por agente precisa registrar e verificar uma chave de idempotência única. Retentativas após falha de rede não podem gerar cobranças ou splits duplicados. Esse controle deve ser implementado na camada de gateway, antes de qualquer chamada à infraestrutura regulada.
Trilha de auditoria: a TrueFoundry recomenda que os logs de auditoria capturem a identidade do usuário autenticado que iniciou a sessão, a identidade do agente, o modelo de IA utilizado, todas as tools invocadas com seus parâmetros e resultados e timestamps imutáveis. O agente não pode ter acesso de escrita aos seus próprios logs.
Confirmação humana: transações que se aproximam do teto da sessão, envolvem contrapartes novas ou ocorrem fora do horário comercial precisam de confirmação humana síncrona por canal autenticado fora da banda. Esse canal não pode ser influenciado pelo agente. A Binance Academy descreve esse ponto de pausa como uma das salvaguardas mais eficazes disponíveis para agentes com autoridade transacional.
Saiba como implementar controles de segurança transacional com a Celcoin.
Qual assistente ou framework suporta o quê?
Definidos os controles de segurança transacional, a próxima decisão é onde executá-los. A escolha do host de IA e do framework de orquestração afeta diretamente a viabilidade de um MCP gateway financeiro em produção.
Claude, Anthropic: o Claude tem suporte nativo ao MCP, um padrão aberto publicado pela Anthropic em dezembro de 2024, com suporte disponível no Claude.ai e Claude Code. Esse ambiente é adequado para fluxos que exigem raciocínio complexo sobre múltiplas tools e contexto de sessão persistente. A recomendação é usar o Claude em casos de uso em que o agente precisa encadear KYC, split e conciliação em um único fluxo.
Cursor: o Cursor é orientado a desenvolvimento de software, com suporte a MCP para automação de tarefas técnicas. Esse ambiente é útil para equipes de engenharia que querem testar e iterar sobre o catálogo de tools MCP antes de colocar em produção. O Cursor não é o ambiente primário para execução de transações financeiras em produção.
LangChain: o LangChain é um framework de orquestração que opera acima do MCP. Ele gerencia o loop do agente, define o que o agente tenta em seguida, o que ele lembra e como se recupera de falhas. Esse framework é adequado para marketplaces que precisam de lógica de orquestração complexa com múltiplos agentes especializados, cada um com seu conjunto de tools MCP. A separação entre orquestração no LangChain e acesso a tools no MCP é a arquitetura recomendada para produção.
Para marketplaces brasileiros, o critério de escolha mais relevante é a capacidade de impor controles de segurança transacional, como limites, idempotência, auditoria e confirmação humana, de forma independente do modelo de IA utilizado.
MCP com Open Finance e a camada regulada
O ecossistema de MCP com Open Finance conecta o protocolo de agentes ao framework regulado de compartilhamento de dados e iniciação de pagamentos do Banco Central. O Open Finance brasileiro, instituído pela Resolução Conjunta nº 1/2020, baseia-se em consentimento expresso do titular dos dados e participação restrita a instituições reguladas. Isso significa que um agente que acessa dados financeiros via Open Finance precisa operar sobre uma infraestrutura autorizada pelo Banco Central.
Nesse contexto, o Agent Payments Protocol, AP2, do Google, doado à FIDO Alliance em abril de 2026, é o protocolo emergente mais relevante para marketplaces que querem habilitar pagamentos iniciados por agentes com rastreabilidade de autorização. O AP2 define três tipos de mandato. O Intent Mandate estabelece as condições para compra autônoma quando o humano não está presente. O Cart Mandate registra a aprovação explícita do usuário para um carrinho específico. O Payment Mandate sinaliza às redes de pagamento que a transação foi iniciada por agente. Cada mandato do AP2 é um Verifiable Credential assinado de forma criptográfica, o que cria uma trilha de auditoria não repudiável que vincula agente, usuário, comerciante e rede de pagamento.
Para marketplaces brasileiros, o AP2 resolve o problema de autorização, que responde à pergunta sobre se o agente tem permissão para gastar. O AP2 não substitui a infraestrutura regulada que executa a liquidação, o split e o reporte ao Bacen. A camada MCP Open Finance Brasil conecta o mandato de autorização do AP2 à infraestrutura financeira regulada, garantindo que a intenção do usuário seja verificável e que a execução siga as regras de conformidade.
Cenário brasileiro de MCP para serviços financeiros
O mercado brasileiro apresenta características regulatórias que tornam a escolha da camada de infraestrutura financeira uma decisão estratégica, e não apenas técnica. A Resolução BCB nº 494/2025 passou a exigir autorização prévia do Banco Central para operar todas as modalidades de instituição de pagamento. Essa resolução eliminou o regime anterior em que alguns participantes podiam iniciar operações sem aprovação prévia. Empresas que avaliam um MCP gateway financeiro precisam verificar se a camada regulada por trás do gateway detém as licenças adequadas para as operações que o agente vai executar.
Os critérios relevantes para essa avaliação são:
-
Cobertura de licenças, como IP, subadquirência e iniciação de pagamentos.
-
Capacidade de split nativo na liquidação.
-
Infraestrutura de KYC e PLD, FT.
-
Geração automatizada de reportes regulatórios ao Bacen.
-
Conectividade direta ao SPB e à RSFN.
-
Capacidade de escalar sem troca de infraestrutura à medida que o marketplace cresce e eventualmente obtém licença própria.
A Celcoin atende a todos esses critérios. Com mais de R$ 30 bilhões em transações mediadas mensalmente e mais de 6 mil clientes, que incluem fintechs, bancos digitais, ERPs e varejistas, a Celcoin oferece BaaS para empresas não reguladas, que operam sob a licença da Celcoin, e Core Banking para empresas reguladas, que integram sua própria licença à infraestrutura da Celcoin. A base tecnológica é a mesma nos dois casos.
A tabela a seguir resume as funcionalidades que sustentam essa oferta e o benefício direto para o marketplace.
|
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, com melhoria do tempo para geração de receita e competitividade. |
|
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 que mantém serviços funcionando mesmo com altos volumes, protegendo sua receita. |
|
Cobertura de diversas possibilidades de pagamentos, incluindo crédito |
Oferta de pagamentos e emissão de crédito que aumenta conversão, arpu e fidelização. |
|
Acesso a dados e personalização |
Dados e análises via Open Finance que permitem ofertas personalizadas, com melhoria de conversão e retenção. |
|
Compliance e conformidade como princípio |
KYC, aml e relatórios integrados que 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 que 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 que garantem melhor cobertura, recursos e velocidade de entrada no mercado. |
Fale com especialistas da Celcoin sobre licenças e conformidade.
Para consolidar os conceitos apresentados, o conteúdo a seguir reúne as dúvidas mais comuns sobre MCP para serviços financeiros em marketplace.
Perguntas frequentes
O que é MCP para marketplace?
MCP para marketplace é a aplicação do Model Context Protocol para expor operações financeiras, como pagamentos, split, KYC de sellers, repasse e conciliação, como tools invocáveis por agentes de IA. O protocolo foi lançado pela Anthropic em novembro de 2024, com autoria atribuída a David Soria Parra e Justin Spahr-Summers, e atualmente está sob governança da Agentic AI Foundation, Linux Foundation. Esse protocolo define como um agente descobre e chama ferramentas externas de forma padronizada. Em um marketplace, o agente pode orquestrar o fluxo financeiro completo, do checkout ao repasse ao seller, sem que cada etapa precise ser codificada manualmente como uma integração de API sob medida. A diferença crítica em relação a uma API tradicional é que o agente decide autonomamente qual tool invocar em tempo de execução, o que exige controles de segurança transacional que APIs convencionais não contemplavam.
Qual a diferença entre MCP e uma API REST em serviços financeiros?
Uma API REST expõe endpoints fixos que o desenvolvedor chama de forma explícita, em sequência predefinida, com parâmetros conhecidos em tempo de desenvolvimento. O MCP expõe um manifesto de tools que o agente descobre em tempo de execução e decide invocar com base no contexto da tarefa. Em serviços financeiros, essa diferença tem implicações diretas de segurança. Em uma API REST, o fluxo de autorização é determinístico e auditável por design. Em um servidor MCP, o agente pode encadear tools de formas não previstas pelo desenvolvedor, o que exige controles de autorização, idempotência, auditoria e confirmação humana.
