Package Exports

@atehra/mcp
@atehra/mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@atehra/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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

Conta na Atehra (atehra.com)
API key (atk_test_... pra sandbox, atk_live_... pra produção)
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:

Você pede pro Claude executar (ex.: "saca tudo pra minha conta principal")
O servidor retorna: "Vou sacar R$ X pra conta Y. Confirme chamando de novo com confirm: true"
Claude repassa pra você pedir confirmação humana
Você confirma
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 maria@exemplo.com.br 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