ASAAS MCP Server v2.0 — Remoto (claude.ai)

Servidor MCP HTTP/SSE para conectar o ASAAS diretamente ao claude.ai.

---

Deploy no Railway (gratuito)

1. Suba o código para um repositório GitHub

1. Crie um repositório privado no GitHub
2. Faça upload desta pasta inteira

2. Crie o projeto no Railway

1. Acesse railway.app e faça login
2. Clique em New Project → Deploy from GitHub repo
3. Selecione o repositório criado

3. Configure as variáveis de ambiente

No Railway, vá em Variables e adicione:

Variável	Valor
ASAAS_API_KEY	Sua chave de API do ASAAS
AUTH_TOKEN	Uma senha forte de sua escolha (ex: minha-senha-secreta-123)
ASAAS_SANDBOX	false (produção) ou true (sandbox)
PORT	3000 (Railway define automaticamente)

⚠️ NUNCA coloque a chave ASAAS diretamente no código.

4. Obtenha a URL do servidor

Após o deploy, Railway gera uma URL pública: https://asaas-mcp-XXXX.railway.app

Teste acessando: https://asaas-mcp-XXXX.railway.app/health

---

Conectar no claude.ai

1. Acesse claude.ai → Settings → Connectors (MCP)
2. Clique em Add MCP Server
3. Preencha:
   • URL: https://asaas-mcp-XXXX.railway.app/sse
   • Auth Header: Bearer SUA_AUTH_TOKEN

---

Ferramentas disponíveis (27)

👥 Clientes

• asaas_list_customers — lista com filtros
• asaas_get_customer — busca por ID
• asaas_create_customer — cria cliente

💳 Cobranças

• asaas_list_payments — lista (status, data, cliente)
• asaas_get_payment — busca por ID
• asaas_create_payment — cria (boleto/Pix/cartão)
• asaas_cancel_payment — cancela
• asaas_refund_payment — estorna

💰 Financeiro

• asaas_get_balance — saldo disponível
• asaas_get_account — dados da conta
• asaas_get_statement — extrato por período
• asaas_list_transfers — histórico de transferências
• asaas_create_transfer_pix — transfere via Pix
• asaas_create_transfer_ted — transfere via TED
• asaas_list_bills — contas a pagar
• asaas_pay_bill — paga boleto de terceiro

🔄 Assinaturas

• asaas_list_subscriptions — lista
• asaas_create_subscription — cria recorrência

📋 Operacional

• asaas_list_installments — parcelamentos
• asaas_get_installment_payments — parcelas individuais
• asaas_list_notifications — notificações por cliente
• asaas_update_notification — ativa/desativa

🔔 Webhooks

• asaas_list_webhooks
• asaas_create_webhook
• asaas_delete_webhook

🧾 NFS-e

• asaas_list_invoices
• asaas_get_invoice
• asaas_schedule_invoice
• asaas_cancel_invoice