Três pinos, nenhum adaptador.

A tomada brasileira para agentes de IA: conectores MCP de código aberto,
que você hospeda, para o que só existe no Brasil 🇧🇷

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. Nunca movimenta dinheiro
`inter`	Ler o saldo e o extrato da conta PJ. Nunca movimenta dinheiro
`nfse`	Ler as notas fiscais de serviço da empresa. Nunca emite nem 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 no extrato do Inter com as NFS-e emitidas e diz quais ficam sem nota

A conciliar-extrato usa os conectores inter e nfse: copie a pasta dela para ~/.claude/skills ou
~/.agents/skills.
Para a ler-conta, copie a pasta e diga ao agente onde está o repositório:

bun install --production --filter @tres-pinos/boleto   # na pasta do repositório
export TRES_PINOS_DIR="$PWD"
mkdir -p ~/.claude/skills && cp -R skills/ler-conta ~/.claude/skills/   # Claude Code
mkdir -p ~/.agents/skills && cp -R skills/ler-conta ~/.agents/skills/   # Codex

A ler-conta precisa do Node.js 22.18+, do Bun para instalar e, para PDFs,
do Poppler e do qpdf.

Início rápido

Precisa do Docker.

git clone https://github.com/caiopizzol/tres-pinos && cd tres-pinos
cp .env.example .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