Por que três pinos?
Em 2011 o Brasil tornou obrigatória a sua própria tomada: três pinos redondos, o terra um pouco abaixo dos outros
dois e dois tamanhos de pino, para o plugue grosso não entrar na tomada fina. Quase nenhum outro país usa. A
imprensa chamou de padrão jabuticaba: aquilo que só dá aqui.
A tomada tem companhia: boleto, Pix, CPF para tudo e cliente que só fala por WhatsApp. Os agentes de IA chegam
prontos para o resto do mundo e travam nas nossas jabuticabas.
[!NOTE]
E o Open Finance? Regulado pelo Banco Central,
ele deixa uma instituição ler a sua conta em outro banco, com o seu consentimento. Mas só instituições
autorizadas entram nele: para chegar ao seu agente, os seus dados passam por uma delas.
Os conectores daqui usam a API oficial de cada sistema, com o seu certificado, de um servidor seu, sem empresa no
meio.
Conectores
| Conector | O que o agente pode fazer |
|---|
sicoob | Ler o saldo e o extrato da conta corrente. Se você ligar, pagar boletos que você aprovar, um a um |
inter | Ler o saldo e o extrato da conta PJ. Nunca movimenta dinheiro |
nfse | Ler as notas fiscais de serviço da empresa. Emite só no ambiente de teste, se você ligar. Nunca cancela |
Skills
Instruções que o seu agente segue, no formato aberto de Agent Skills. Testadas no Claude
Code e no Codex.
| Skill | O que o agente faz |
|---|
ler-conta | Lê os códigos de boleto e Pix de uma conta em PDF ou foto, e confere antes de pagar |
conciliar-extrato | Confere as entradas de um mês nas contas da empresa com as NFS-e emitidas e diz quais ficam sem nota |
estimar-impostos | Estima o IRPJ e a CSLL de um trimestre no Lucro Presumido, a partir das NFS-e emitidas |
emitir-nfse | Emite, no ambiente de teste, a NFS-e de um serviço de software exportado a partir da invoice em dólar |
O conector nfse já traz as skills que o usam, e o agente as lê sem instalar nada. Como instalar as outras está
na pasta de cada uma.
Início rápido
Precisa do Docker.
mkdir tres-pinos && cd tres-pinos
curl -fsSLO https://github.com/caiopizzol/tres-pinos/releases/latest/download/compose.yaml
curl -fsSL https://github.com/caiopizzol/tres-pinos/releases/latest/download/env.example -o .env
No .env, escolha os conectores em COMPOSE_PROFILES e preencha as variáveis.
Prepare o certificado como diz cada conector: Sicoob, Inter ou
NFS-e. Depois:
docker compose up -d
E ligue o seu agente na mesma máquina, com a porta e a chave de cada conector:
| Conector | Endereço | Chave |
|---|
sicoob | http://127.0.0.1:3012/mcp | SICOOB_KEY |
inter | http://127.0.0.1:3013/mcp | INTER_KEY |
nfse | http://127.0.0.1:3014/mcp | NFSE_KEY |
Os comandos guardam só o nome da variável, não a chave. Deixe a chave no ambiente em que você abre o agente, por
exemplo no ~/.zshrc. Para o Sicoob:
export SICOOB_KEY=... # a mesma do .env
codex mcp add sicoob --url http://127.0.0.1:3012/mcp --bearer-token-env-var SICOOB_KEY
claude mcp add --scope user --transport http sicoob http://127.0.0.1:3012/mcp --header 'Authorization: Bearer ${SICOOB_KEY}'
Para o Inter ou a NFS-e, troque o nome, a porta e a chave pelos da tabela.
Desenvolvimento
Precisa do Bun 1.3+.
bun install
bun run check
bun run test
docker compose up -d --build # os conectores desta pasta, em vez das imagens publicadas
Licença
MIT
