@atehra/mcp

Servidor MCP (Model Context Protocol) oficial da Atehra. Permite que Claude, Cursor, ChatGPT e qualquer cliente MCP operem a infraestrutura financeira BR da Atehra em linguagem natural.

A primeira fintech brasileira projetada pra rodar via agente de IA.

Dois jeitos de usar

| Jeito | Quando usar | Como | |---|---|---| | Remoto (HTTP/SSE) | Maioria dos casos. Sem instalar nada. | Cola URL na UI dos Connectors do Claude | | Local (stdio) | Self-hosting ou ambientes sem internet | npx -y @atehra/mcp via config JSON |

Uso remoto (recomendado) — UI dos Connectors

No Claude Desktop, vai em Settings → Connectors → Adicionar conector personalizado e cola:

URL: https://mcp.atehra.com/mcp

Em Configurações avançadas, adiciona header:

x-api-key: atk_test_SUA_CHAVE_AQUI

Salva. Pronto — 16 ferramentas Atehra disponíveis no Claude.

O que dá pra fazer

Com este servidor ligado, seu agente de IA pode:

• Consultar saldo, A receber, antecipações disponíveis em tempo real
• Criar cobranças em PIX ou boleto pra qualquer cliente
• Gerar links de pagamento reutilizáveis
• Antecipar vendas no cartão com cotação prévia
• Sacar saldo pra conta externa via PIX ou TED
• Configurar a régua de cobrança em linguagem natural
• Ver métricas do negócio (receita recorrente mensal, taxa de cancelamento, valor por cliente)
• Listar clientes, assinaturas e faturas com filtros

Uso local (stdio)

Pré-requisitos

1. Conta na Atehra (atehra.com)
2. API key (atk_test_... pra sandbox, atk_live_... pra produção)
3. Node.js 18+

No Claude Desktop

Adicione ao arquivo de configuração (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "atehra": {
      "command": "npx",
      "args": ["-y", "@atehra/mcp"],
      "env": {
        "ATEHRA_API_KEY": "atk_test_sua_chave_aqui"
      }
    }
  }
}

Reinicie o Claude Desktop. Pronto.

No Cursor

Adicione ao .cursor/mcp.json no seu projeto:

{
  "mcpServers": {
    "atehra": {
      "command": "npx",
      "args": ["-y", "@atehra/mcp"],
      "env": {
        "ATEHRA_API_KEY": "atk_test_sua_chave_aqui"
      }
    }
  }
}

Modo sandbox vs produção

O servidor detecta o modo pelo prefixo da chave:

• atk_test_... → sandbox (dados de teste, dinheiro não é real)
• atk_live_... → produção (dinheiro é real)

Recomendação forte: comece sempre em sandbox.

Segurança em produção

Em produção (atk_live_), ações que movem dinheiro real exigem confirmação dupla:

1. Você pede pro Claude executar (ex.: "saca tudo pra minha conta principal")
2. O servidor retorna: "Vou sacar R$ X pra conta Y. Confirme chamando de novo com confirm: true"
3. Claude repassa pra você pedir confirmação humana
4. Você confirma
5. Claude chama de novo com confirm: true e a ação executa

Em sandbox a confirmação é pulada (tudo é teste).

As 16 ferramentas

Saldo e dinheiro

• get_balance — saldo disponível e a receber
• list_anticipatable_payments — vendas no cartão que dão pra antecipar
• quote_anticipation — calcular taxa e valor líquido
• request_anticipation — antecipar pagamento (confirmação dupla em produção)
• request_withdrawal — sacar saldo (confirmação dupla em produção)

Cobrar e clientes

• create_customer — criar cliente
• list_customers — listar clientes
• create_plan — criar plano de produto (assinatura ou avulso)
• create_checkout_session — gerar cobrança PIX ou boleto pra um cliente
• create_checkout_link — gerar link de pagamento reutilizável
• list_recent_orders — listar últimas vendas

Números do negócio

• get_metrics_overview — receita, MRR, churn, ARPU, LTV
• list_subscriptions — assinaturas ativas
• list_invoices — faturas (pagas, pendentes, vencidas)

Régua de cobrança

• get_dunning_config — ver régua atual
• update_dunning_config — atualizar régua de cobrança

Exemplos de uso

Com o servidor ligado, peça ao Claude:

"Quanto eu tenho de saldo e quanto posso antecipar agora?"

"Cria cliente Maria Silva com email [email protected] e CPF 12345678900, depois cria uma cobrança PIX de R$ 1.500 com vencimento sexta."

"Configura a régua: tenta cobrar de novo no dia 1, manda email no dia 3, suspende no dia 7."

"Quais clientes têm fatura vencida há mais de 5 dias?"

"Como tá o MRR esse mês comparado ao anterior?"

Variáveis de ambiente

| Variável | Obrigatório | Descrição | |---|---|---| | ATEHRA_API_KEY | Sim | Chave da API (atk_test_... ou atk_live_...) | | ATEHRA_BASE_URL | Não | URL base da API. Padrão: https://api.atehra.com |

Desenvolvimento

npm install
npm run build
npm start

Pra testar localmente com o Claude Desktop, aponte o command pro node e o args pro caminho do dist/index.js:

{
  "command": "node",
  "args": ["/caminho/absoluto/para/atehra/mcp/dist/index.js"],
  "env": { "ATEHRA_API_KEY": "atk_test_..." }
}

Licença

MIT