Antes de começar
- Tenha em mãos o login do banco. A autorização acontece no site do próprio banco, pelo fluxo regulado do Open Finance.
- Copie a URL do servidor MCP. O transporte é HTTP streamable remoto: não é preciso rodar
npxnem manter processo local. - Depois de conectado, a primeira sincronização leva alguns minutos. Peça o status da conexão se uma conta ainda aparecer vazia.
Claude (web e Desktop)
- Abra Configurações → Conectores → Adicionar conector personalizado.
- Em Nome, escreva “Banco nohumans”. Em URL, cole a URL do servidor MCP mostrada acima.
- Clique em Adicionar e depois em Conectar. O navegador abre o consentimento do Open Finance.
- Escolha o banco, faça login no site do próprio banco e autorize a leitura.
- Abra um chat novo e pergunte “qual meu saldo hoje?”.
ChatGPT
- Em Configurações → Apps, ative o modo desenvolvedor (requer plano com suporte a MCP).
- Clique em Criar app.
- Em Nome, escreva “Banco nohumans”. Em URL do servidor MCP, cole a URL mostrada acima.
- Mantenha a autenticação em OAuth e confirme a criação.
- No primeiro uso, autorize o banco pela janela do Open Finance.
Cursor e IDEs
- Abra Settings → MCP → Add new MCP server.
- Cole a configuração abaixo em .cursor/mcp.json e salve.
- Quando o Cursor pedir, conclua o login no navegador.
- Peça no chat do editor: “liste minhas contas e o saldo de cada uma”.
{
"mcpServers": {
"banco-nohumans": {
"url": "COLE_AQUI_A_URL_DO_MCP"
}
}
}Agentes e CLIs
- Registre a URL como servidor MCP remoto (transporte HTTP streamable). Não é preciso rodar npx nem subir um processo local.
- Se o agente não tiver OAuth no navegador, use a variável de ambiente BANCO_API_KEY com uma chave de API (a definir) emitida no painel.
- Confirme que o agente lista as 13 tools de leitura antes de seguir.
- Peça um resumo de uma conta para validar o caminho de leitura.
Exemplos de prompt
Depois de conectar, fale como falaria com uma pessoa. A IA traduz a pergunta em chamadas às tools.
- Quanto gastei com mercado e restaurante este mês?
- Qual o meu saldo somado em todos os bancos?
- Liste as últimas 20 transações de todas as contas.
- Quais faturas de cartão vencem na próxima semana?
- Como está minha carteira de investimentos hoje?
- Tenho empréstimo ativo em algum banco? Qual o saldo devedor?
Limites e estados
| Situação | O que significa |
|---|---|
atualizada | Conexão saudável, dados recentes. |
sincronizando | Coleta em andamento. Aguarde e consulte o status de novo. |
erro de login | Senha mudou ou houve 2FA extra. Reconecte pela URL da conexão. |
consentimento vencido | O consentimento do Open Finance expira; reconecte para renovar. |
aguardando você | O banco pede aprovação no app ou token. Conclua e retome. |