How does the MCP handle authentication?

The MCP uses OAuth2 client credentials to mint a bearer token. It manages the 40-minute token lifetime and automatically refreshes it if a request fails.

Can I use this in a production environment?

The MCP defaults to the Celcoin sandbox. Production use requires an mTLS certificate and a source-IP allowlist, which is intended for self-hosted or edge callers.

Does this move real money?

Yes, the pix_payment and ted_transfer capabilities initiate actual financial movements. Always confirm the amount, recipient, and client code before authorizing the agent.

How do I check if a Pix payment was successful?

You can use the pix_payment_status capability by providing the transaction ID, client code, or end-to-end ID returned during initiation.

What is the difference between Pix and TED in this MCP?

Pix is used for immediate or dated transfers via keys or accounts, while TED is used for interbank same-day transfers requiring a BACEN finality code.

Where do I get the Celcoin Client ID and Secret?

The Celcoin integration team issues them during your homologation. For testing, the Celcoin docs publish a public sandbox test pair for the bill payment, recharge or transfer products. point the base URL at the sandbox and use that pair right away.

Sandbox or production. which base URL do I set?

Leave the base URL empty (or set the sandbox URL) to call the sandbox, which needs no extra setup. Per Celcoin's docs, the production base URL additionally requires an mTLS certificate issued by Celcoin plus a source-IP allowlist. a hosted runner cannot provide either, so production is intended for self-hosted or edge callers that hold the certificate.

Do pix_payment and ted_transfer actually move money?

Yes. both initiate real BRL transfers in the connected environment (in the sandbox, against sandbox balances). The capabilities tell the agent to confirm the amount, parties and purpose with you before calling. Track each one afterwards with pix_payment_status or ted_transfer_status.

What is client_finality in a TED?

It is the BACEN finality code describing the purpose of the interbank transfer. a 6-digit code such as 010101. "99999" means no specific finality (other), in which case the free-text description becomes required and is what the receiver sees on their statement.

Baixar PDF Versão em Markdown

Conecte Celcoin Baas Open Finance ao ChatGPT e Claude

Configure uma vez e funcione no ChatGPT, Claude, Cursor e em qualquer outro cliente que você goste. Tudo roda com segurança em segundo plano, para você relaxar e focar no que realmente importa. Controle total de pagamentos e contas via MCP.

Pergunte à IA sobre este Connector

Desenvolvido, mantido e hospedado pela Vinkius.

MCP VERIFICADO · PRONTO PARA PRODUÇÃO · GARANTIA VINKIUS

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

A sua IA faz o trabalho. A gente cuida com segurança.

Nenhuma outra ferramenta de IA te dá isso. O seu workflow roda no cliente que você já ama, a sua conta fica protegida, e você decide o que o agente pode e não pode fazer. É a razão completa para mudar de vez.

Cada Connector vive dentro da nossa infraestrutura, no mesmo lugar onde o seu workflow roda. As três coisas abaixo já fazem parte dele, trabalhando silenciosamente em segundo plano para que você nunca precise pensar nelas. Nada para adicionar, nada para configurar, nada com que se preocupar.

How Vinkius works: one connection, every tool, in any AI

V8 Isolate01

Cada Connector roda dentro do seu próprio ambiente lacrado.

Cada Connector roda em seu próprio runtime V8 lacrado — sem acesso aos seus arquivos, ao seu sistema ou a outros servidores. Um Connector nunca enxerga além da sua própria requisição.

Kill Switch02

Um interruptor para todos os agentes. Na hora.

Uma única ação desativa todos os Connectors, revoga todos os tokens e encerra todas as sessões de uma vez. A Governança de IA guarda o registro.

FinOps por usuário03

Limites de gastos que pausam em vez de assustar.

Cada usuário tem suas próprias conexões e credenciais, isoladas das dos demais. O que ultrapassar o seu limite de gastos fica aguardando a sua aprovação, em vez de ser cobrado.

Três controles, embutidos na camada pela qual sua IA se conecta.

Conjunto completo · 9 capacidades

O conjunto completo de capacidades de Celcoin Open Finance API.

Estas são as ações exatas que a sua IA pode escolher quando você pedir para trabalhar com Celcoin Open Finance API.

Conjunto de capacidades01 / 03

01-03

3 capacidades neste conjunto.

Parte de 9 disponíveis através de Celcoin Open Finance API.

01
Verificar credenciais
Valida as credenciais da Celcoin gerando um novo token bearer e retorna os detalhes da integração.
02
Consultar status de Pix
Acompanha o status de um Pix enviado usando o ID da transação, código do cliente ou ID end-to-end.
03
Listar contas
Lista as contas BaaS criadas em um período específico, permitindo filtrar por número da conta ou CPF/CNPJ.

Conjunto de capacidades02 / 03

04-06

3 capacidades neste conjunto.

Parte de 9 disponíveis através de Celcoin Open Finance API.

04
Consultar saldo
Verifica o saldo atual de uma carteira BaaS, detalhando valores disponíveis, bloqueados e o total.
05
Consultar extrato
Acessa o histórico de movimentações de uma carteira em um intervalo de datas definido.
06
Listar chaves Pix
Identifica as chaves Pix cadastradas em uma conta específica para recebimento de valores.

Conjunto de capacidades03 / 03

07-09

3 capacidades neste conjunto.

Parte de 9 disponíveis através de Celcoin Open Finance API.

07
Realizar pagamento Pix
Inicia transferências Pix de uma conta BaaS para chaves ou dados bancários de destino.
08
Realizar transferência TED
Executa transferências interbancárias via TED entre contas bancárias com códigos de finalidade do BACEN.
09
Consultar status de TED
Verifica o status de uma transferência TED realizada através do ID da transação ou código do cliente.

Um connector, todas as IAs

Celcoin Open Finance API funciona com os clientes de IA mais populares.

Estes são os clientes mais populares, cada um com um guia passo a passo: um link, configurado uma vez, com governança e visibilidade embutidas. E como tudo roda no padrão MCP, a mesma conexão também funciona em qualquer outro cliente compatível — nada para reconstruir.

Construindo o seu próprio app? O connector é seu para usar.

Você não precisa de um cliente para colocar Celcoin Open Finance API para trabalhar: a mesma conexão hospedada entra nas suas aplicações e no código do seu agente, com a mesma governança em cada pedido. Construa com ele, converse com ele — uma conexão para os dois.

Observada, não estimada

Média de 1040ms. Rápida em produção.

Celcoin Open Finance API é verificado diariamente contra o serviço em produção.

Média diáriaPico de 1040ms

25 de set.Hoje

Dia mais rápido: 1040ms
Dia mais lento: 1040ms
Tendência de 14 dias: Estável0%

Conecte seu cliente

Uma URL. Todos os clientes.

Ative o Connector, copie seu link e cole no cliente que você já usa. 9 capacidades chegam prontas para rodar.

Acesso de prévia · não é autenticação no provedor

O token vk_preview_* pertence à infraestrutura de prévia da Vinkius. Ele permite que o Claude descubra e exiba as capacidades de Celcoin Open Finance API, para você ver a experiência dentro da sua IA.

Ele não autentica a sua conta com Celcoin Open Finance API. Ações que exigem credenciais ou dados reais da conta podem não ser executadas até que você ative o Connector e autorize o serviço.

Celcoin Open Finance API Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_hzQEnNtAWqCj1RiBHEGiBvEOCIlo44qZCz13DXui/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Celcoin Open Finance API capabilities are ready to use.

Configuração · claude_desktop_config.jsonCopiar

{
  "mcpServers": {
    "celcoin-baas-open-finance-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_hzQEnNtAWqCj1RiBHEGiBvEOCIlo44qZCz13DXui/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Instruções passo a passo para cada cliente estão no guia. Como conectar

Configuração guiada para o Claude? Como dar ao Claude acesso a Celcoin Open Finance API

Veja todos os clientes de IA com quem este connector funciona ↑

Para quem é

Feito para o trabalho que quem usa Celcoin Open Finance API delega.

Ideal para empresas que operam no ecossistema de pagamentos e precisam de integração direta com a infraestrutura da Celcoin.

01
Instituições Financeiras
Empresas que utilizam a infraestrutura de BaaS para gerenciar operações de crédito e pagamentos.
02
Operadores de BaaS
Gestores que precisam monitorar saldos, extratos e realizar transferências em escala.
03
Desenvolvedores de Fintechs
Profissionais que buscam automatizar fluxos de Pix, TED e conciliação bancária via MCP.

FAQ

Perguntas de quem usa Celcoin Open Finance API.

01
How does the MCP handle authentication?
The MCP uses OAuth2 client credentials to mint a bearer token. It manages the 40-minute token lifetime and automatically refreshes it if a request fails.
02
Can I use this in a production environment?
The MCP defaults to the Celcoin sandbox. Production use requires an mTLS certificate and a source-IP allowlist, which is intended for self-hosted or edge callers.
03
Does this move real money?
Yes, the pix_payment and ted_transfer capabilities initiate actual financial movements. Always confirm the amount, recipient, and client code before authorizing the agent.
04
How do I check if a Pix payment was successful?
You can use the pix_payment_status capability by providing the transaction ID, client code, or end-to-end ID returned during initiation.
05
What is the difference between Pix and TED in this MCP?
Pix is used for immediate or dated transfers via keys or accounts, while TED is used for interbank same-day transfers requiring a BACEN finality code.
06
Where do I get the Celcoin Client ID and Secret?
The Celcoin integration team issues them during your homologation. For testing, the Celcoin docs publish a public sandbox test pair for the bill payment, recharge or transfer products. point the base URL at the sandbox and use that pair right away.
07
Sandbox or production. which base URL do I set?
Leave the base URL empty (or set the sandbox URL) to call the sandbox, which needs no extra setup. Per Celcoin's docs, the production base URL additionally requires an mTLS certificate issued by Celcoin plus a source-IP allowlist. a hosted runner cannot provide either, so production is intended for self-hosted or edge callers that hold the certificate.
08
Do pix_payment and ted_transfer actually move money?
Yes. both initiate real BRL transfers in the connected environment (in the sandbox, against sandbox balances). The capabilities tell the agent to confirm the amount, parties and purpose with you before calling. Track each one afterwards with pix_payment_status or ted_transfer_status.
09
What is client_finality in a TED?
It is the BACEN finality code describing the purpose of the interbank transfer. a 6-digit code such as 010101. "99999" means no specific finality (other), in which case the free-text description becomes required and is what the receiver sees on their statement.