Documentação

Do zero à primeira pergunta.

O Banco nohumans é um servidor MCP remoto com 13 tools de leitura e uma REST API equivalente. Conecte uma vez por cliente; cada banco vira uma conexão.

URL do servidor MCPhttps://A DEFINIR (URL do servidor MCP)a definir

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 npx nem 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)

  1. Abra Configurações → Conectores → Adicionar conector personalizado.
  2. Em Nome, escreva “Banco nohumans”. Em URL, cole a URL do servidor MCP mostrada acima.
  3. Clique em Adicionar e depois em Conectar. O navegador abre o consentimento do Open Finance.
  4. Escolha o banco, faça login no site do próprio banco e autorize a leitura.
  5. Abra um chat novo e pergunte “qual meu saldo hoje?”.

ChatGPT

  1. Em Configurações → Apps, ative o modo desenvolvedor (requer plano com suporte a MCP).
  2. Clique em Criar app.
  3. Em Nome, escreva “Banco nohumans”. Em URL do servidor MCP, cole a URL mostrada acima.
  4. Mantenha a autenticação em OAuth e confirme a criação.
  5. No primeiro uso, autorize o banco pela janela do Open Finance.

Cursor e IDEs

  1. Abra Settings → MCP → Add new MCP server.
  2. Cole a configuração abaixo em .cursor/mcp.json e salve.
  3. Quando o Cursor pedir, conclua o login no navegador.
  4. 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

  1. Registre a URL como servidor MCP remoto (transporte HTTP streamable). Não é preciso rodar npx nem subir um processo local.
  2. 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.
  3. Confirme que o agente lista as 13 tools de leitura antes de seguir.
  4. 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çãoO que significa
atualizadaConexão saudável, dados recentes.
sincronizandoColeta em andamento. Aguarde e consulte o status de novo.
erro de loginSenha mudou ou houve 2FA extra. Reconecte pela URL da conexão.
consentimento vencidoO consentimento do Open Finance expira; reconecte para renovar.
aguardando vocêO banco pede aprovação no app ou token. Conclua e retome.

Prazos de retenção, limites de requisição por plano e preços: a definir.