Recaudo Docs
Criar conta

MCP e agentes

Servidor MCP

Integre o Recaudo com assistentes de inteligência artificial

O Recaudo inclui um servidor MCP (Model Context Protocol) que permite que assistentes de inteligência artificial como Claude Desktop, Cursor, Windsurf, Claude Code e outros clientes MCP trabalhem diretamente com sua conta: gerenciar clientes, criar faturas, cobrar, enviar WhatsApp, CRM, automações e mais.

Requisitos

  • Node.js 18 ou superior
  • Uma Secret Key da API (sk_live_ o sk_test_)

Configuração no Claude Desktop

Edite o arquivo claude_desktop_config.json (Mac: ~/Library/Application Support/Claude/claude_desktop_config.json | Windows: %APPDATA%\Claude\claude_desktop_config.json):

claude_desktop_config.json 
{
  "mcpServers": {
    "recaudo": {
      "command": "npx",
      "args": ["-y", "@recaudo/mcp-server"],
      "env": {
        "RECAUDO_API_KEY": "sk_live_tu_secret_key"
      }
    }
  }
}
Substitua sk_live_tu_secret_key pela sua Secret Key. Você pode gerá-la em Chaves de API. Reinicie o Claude Desktop depois de salvar a configuração.

Configuração no Claude Code

Terminal 
claude mcp add recaudo -e RECAUDO_API_KEY=sk_live_tu_secret_key -- npx -y @recaudo/mcp-server

Configuração no Cursor / Windsurf

Crie o arquivo .cursor/mcp.json na raiz do seu projeto:

.cursor/mcp.json 
{
  "mcpServers": {
    "recaudo": {
      "command": "npx",
      "args": ["-y", "@recaudo/mcp-server"],
      "env": {
        "RECAUDO_API_KEY": "sk_live_tu_secret_key"
      }
    }
  }
}

Ferramentas disponíveis

O servidor MCP expõe 110 ferramentas organizadas em 20 módulos:

Grupo Ferramentas Descrição
Clientes 7 CRUD, formas de pagamento, assinaturas
Faturas 9 CRUD, parcelas, juros de mora
Links de pagamento 5 Criar, cancelar, ver pagamentos
Cobranças 3 Cobranças diretas, reembolsos
Produtos 10 Catálogo: categorias e produtos com estoque
Pedidos 8 Criar, enviar, entregar, concluir pedidos
Conversas 7 WhatsApp, Messenger, Instagram: mensagens e modelos
Planos 3 Listar e criar planos de assinatura
Assinaturas 7 Ciclo completo: criar, pausar, cancelar
Fluxos 6 Disparar fluxos de conversa
Webhooks 4 Configurar e testar webhooks

Exemplo de uso

Depois de configurado, você pode conversar com seu assistente em linguagem natural:

Conversa com o Claude

Usuário: Liste meus clientes com assinatura ativa

Claude: Encontrei 24 clientes com assinatura ativa...

Usuário: Crie um link de pagamento de $500 para Juan Pérez

Claude: Link criado: https://recaudo.app/pay/abc123...

Usuário: Quantas faturas pendentes eu tenho?

Claude: Você tem 12 faturas pendentes no total de $45,300.00...

O servidor MCP usa sua Secret Key para se autenticar. Todas as operações seguem as mesmas permissões e limites da API REST.

Esta página ajudou? Obrigado por avisar.
Esc