Recaudo Docs
Crear cuenta

MCP y agentes

Servidor MCP

Integra Recaudo con asistentes de inteligencia artificial

Recaudo incluye un servidor MCP (Model Context Protocol) que permite a asistentes de inteligencia artificial como Claude Desktop, Cursor, Windsurf, Claude Code y otros clientes MCP trabajar directamente con tu cuenta: administrar clientes, crear facturas, cobrar, enviar WhatsApp, CRM, automatizaciones y más.

Requisitos

  • Node.js 18 o superior
  • Una Secret Key de la API (sk_live_ o sk_test_)

Configuración en Claude Desktop

Edita el archivo 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"
      }
    }
  }
}
Reemplaza sk_live_tu_secret_key con tu Secret Key. Puedes generarla en Llaves de API. Reinicia Claude Desktop después de guardar la configuración.

Configuración en Claude Code

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

Configuración en Cursor / Windsurf

Crea el archivo .cursor/mcp.json en la raíz de tu proyecto:

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

Herramientas disponibles

El MCP Server expone 110 herramientas organizadas en 20 módulos:

Grupo Herramientas Descripción
Clientes 7 CRUD, métodos de pago, suscripciones
Facturas 9 CRUD, parcialidades, moratorios
Ligas de pago 5 Crear, cancelar, ver pagos
Cargos 3 Cobros directos, reembolsos
Productos 10 Catálogo: categorías y productos con inventario
Pedidos 8 Crear, enviar, entregar, completar pedidos
Conversaciones 7 WhatsApp, Messenger, Instagram: mensajes y plantillas
Planes 3 Listar y crear planes de suscripción
Suscripciones 7 Ciclo completo: crear, pausar, cancelar
Flujos 6 Desplegar flujos conversacionales
Webhooks 4 Configurar y probar webhooks

Ejemplo de uso

Una vez configurado, puedes hablar con tu asistente en lenguaje natural:

Conversación con Claude

Usuario: Lista mis clientes con suscripción activa

Claude: Encontré 24 clientes con suscripción activa...

Usuario: Crea un link de pago de $500 para Juan Pérez

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

Usuario: ¿Cuántas facturas pendientes tengo?

Claude: Tienes 12 facturas pendientes por un total de $45,300.00...

El MCP Server usa tu Secret Key para autenticarse. Todas las operaciones respetan los mismos permisos y límites que la API REST.

¿Te sirvió esta página? Gracias por avisarnos.
Esc