@recaudo/mcp-server

Servidor MCP (Model Context Protocol) para Recaudo — plataforma de pagos, facturación, CRM y automatización.

Permite a asistentes de IA como Claude Desktop, Cursor y otros clientes MCP gestionar tu negocio directamente: crear facturas, cobrar, enviar WhatsApp, gestionar clientes, CRM y más.

110 herramientas disponibles

| Módulo | Herramientas | |--------|-------------| | Clientes | Crear, buscar, actualizar, eliminar, métodos de pago | | Facturas | CRUD completo, parcialidades, moratorios | | Pagos | Cargos, reembolsos, links de pago | | Conversaciones | WhatsApp, Instagram, Messenger, templates | | Cobranza | Facturas vencidas, promesas de pago, intentos | | CRM | Deals, pipelines, mover etapas | | Seguimientos | Crear, completar, reprogramar | | Automatizaciones | Crear reglas trigger→acción | | Email | Templates, envíos, historial | | Calendario | Citas, disponibilidad, tipos | | Facturación electrónica | CFDI, timbrar, cancelar | | Etiquetas | Tags de clientes y conversaciones | | Reportes | Generar reportes con lenguaje natural | | Productos | Catálogo, categorías, inventario | | Pedidos | CRUD, estados, envío | | Suscripciones | Planes, cobro recurrente | | Webhooks | Configurar, probar, historial |

Configuración rápida

1. Obtén tu API Key

Ve a Recaudo → Configuración → API Keys y genera una Secret Key.

2. Configura tu cliente MCP

Claude Desktop

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

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

Claude Code

claude mcp add recaudo -- npx -y @recaudo/mcp-server

Luego configura la variable de entorno RECAUDO_API_KEY.

Cursor

Crea .cursor/mcp.json en tu proyecto:

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

3. Reinicia tu cliente y listo

Ahora puedes pedirle a tu asistente de IA cosas como:

• "Muéstrame los últimos 5 pagos"
• "Crea una factura de $5,000 para el cliente Juan Pérez"
• "¿Cuántas facturas vencidas hay?"
• "Envía un WhatsApp al cliente con el template de recordatorio"
• "Crea un seguimiento para llamar a Pedro mañana"
• "Genera un reporte de ingresos del mes"

Variables de entorno

| Variable | Requerida | Descripción | |----------|-----------|-------------| | RECAUDO_API_KEY | Sí | Tu Secret Key de la API | | RECAUDO_API_URL | No | URL base (default: https://recaudo.app/api/v1) |

Documentación

• API Reference
• MCP Server docs

Licencia

MIT