Como Dar uma Conta Bancária ao Seu Agente de IA em 5 Minutos (MCP + FLAT)

Desenvolvedores que constroem agentes de IA (Claude, GPT ou LLMs personalizados) frequentemente precisam que seus agentes lidem com transações do mundo real—verificando saldos, recebendo pagamentos ou ganhando recompensas. FLAT (Flat Cash) torna isso possível sem uma carteira, frase-semente ou taxas de gás, utilizando o Protocolo de Contexto do Modelo (MCP).

Neste tutorial, você irá:
✅ Adicionar o servidor FLAT MCP ao seu agente de IA (Claude Desktop)
✅ Obter um FlatID para seu agente (conta baseada em e-mail)
✅ Habilitar verificações de saldo, transferências e ganhos de tarefas
✅ Implantar em menos de 5 minutos

Pré-requisitos

• Claude Desktop (ou qualquer agente de IA compatível com MCP)
• URL do Servidor FLAT MCP: https://flat.cash/api/mcp
• Protocolo: HTTP transmitível

Passo 1: Adicione o Servidor FLAT MCP ao claude_desktop_config.json

1. Abra Claude Desktop e navegue até:

   • Mac: ~/.claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Adicione a configuração do servidor FLAT MCP:
   

{
  "mcpServers": {
    "flat": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-flat@latest",
        "https://flat.cash/api/mcp"
      ],
      "env": {}
    }
  }
}

1. Salve o arquivo e reinicie o Claude Desktop.

✅ Verificação: Abra o Inspetor MCP (Cmd+Shift+P > "MCP: Inspecionar") e confirme que flat aparece na lista.

Passo 2: O Agente Obtém um FlatID (Sem Carteira Necessária)

Seu agente de IA agora tem um FlatID—uma conta única, baseada em e-mail. Sem frase-semente, sem KYC, sem taxas de gás.

Como Obter Seu FlatID

Pergunte ao seu agente de IA:

"Qual é o meu FlatID?"

Resposta de exemplo:

Seu FlatID é: ai_agent_1234567890@flat.cash

🔹 Como funciona:

• O FlatID é a conta bancária do seu agente.
• Depósitos podem ser enviados para este endereço semelhante a um e-mail.
• Sem chaves privadas—transações são gerenciadas via ferramentas MCP.

Passo 3: O Agente Agora Pode Lidar com Dinheiro

Seu agente de IA agora pode:
💰 Verificar saldo
📥 Receber pagamentos
🔄 Transferir fundos
🎁 Ganhar recompensas (tokens SAVE)

Ferramentas MCP Disponíveis

Passo 4: Exemplos Práticos

1. Verificar Saldo

Pergunte ao seu agente:

"Qual é o meu saldo FLAT?"

Resposta de exemplo:

Seu saldo atual: 10.5 SAVE (~$11.76)

2. Receber um Pagamento

Envie SAVE para o FlatID do seu agente:

Enviar 2 SAVE para ai_agent_1234567890@flat.cash

Seu agente detectará o depósito na próxima verificação de saldo.

3. Transferir Fundos

Pergunte ao seu agente:

"Enviar 1 SAVE para bob@flat.cash"

Resposta de exemplo:

Transferência bem-sucedida! Enviado 1 SAVE para bob@flat.cash.
Novo saldo: 9.5 SAVE

4. Ganhar Recompensas (Tokens SAVE)

Pergunte ao seu agente:

"Mostre-me tarefas que posso ganhar SAVE"

Resposta de exemplo:

Tarefas disponíveis:
- Tarefa #123: "Testar API FLAT" → 5 SAVE (~$5.60)
- Tarefa #456: "Escrever um tutorial" → 10 SAVE (~$11.20)

Então reivindique uma tarefa:

"Ganhar tarefa 123"

Resposta de exemplo:

Tarefa concluída! Você ganhou 5 SAVE.
Novo saldo: 14.5 SAVE

Passo 5: Sem Taxas de Gás, Sem KYC, Sem Carteira

✅ Zero taxas de gás (transações são off-chain)
✅ Sem frase-semente (FlatID é baseado em e-mail)
✅ Sem KYC (totalmente sem permissão)
✅ Liquidações instantâneas (tokens SAVE creditados imediatamente)

💡 Preço Atual do SAVE: ~$1.12 (verifique via flat_price)

Solução de Problemas