@maideo/mcp

Servidor oficial MCP (Model Context Protocol) para la API de Maideo Agent.

Permite que cualquier agente de IA compatible con MCP (Claude Desktop, Claude Code, ChatGPT desktop, Continue.dev, Cursor, etc.) reserve servicios profesionales de limpieza a domicilio (ménage à domicile) en cualquier lugar de Francia, de principio a fin, sin intervención humana.

Qué hace

• Comprueba la cobertura por código postal

• Devuelve un presupuesto firme

• Crea una reserva en el back-office de Maideo (visible para el equipo de operaciones)

• Inscribe al usuario final en URSSAF para el anticipo inmediato del 50% del crédito fiscal (no se necesita pago con tarjeta; domiciliación bancaria SEPA después de cada intervención)

• Consulta el estado de la reserva

Herramientas expuestas

Instalación

npm install -g @maideo/mcp
# or use npx without installing:
npx @maideo/mcp

Configurar Claude Desktop

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

{
  "mcpServers": {
    "maideo": {
      "command": "npx",
      "args": ["-y", "@maideo/mcp"],
      "env": {
        "MAIDEO_AGENT_NAME": "claude-desktop"
      }
    }
  }
}

Reinicie Claude Desktop. Ahora puede pedirle a Claude:

"¿Puedes reservarme una limpieza semanal de 3 horas en 12 rue de Rivoli, 75001 París, a partir del próximo lunes?"

Claude encadenará las 5 herramientas automáticamente.

Configurar Claude Code

claude mcp add maideo npx -- -y @maideo/mcp

Variables de entorno

Retención antifraude

Todas las reservas creadas a través de este servidor MCP se retienen durante 48 horas antes de asignar al trabajador. El equipo de operaciones de Maideo puede llamar o enviar un SMS al usuario final para verificar. No envíe reservas con datos falsos en producción. Su MAIDEO_AGENT_NAME podría ser incluido en una lista negra.

También debe obtener el consentimiento explícito del usuario final antes de llamar a create_booking. Pase agentConsent: true como atestación de vinculación.

Cómo funciona el pago (no hay paso de pago)

Maideo utiliza el avance immédiate de crédit d'impôt (anticipo inmediato del crédito fiscal) de URSSAF, un programa del gobierno francés para servicios a domicilio.

1. El usuario final se inscribe a través de enroll_avance_immediate: proporciona identidad, lugar de nacimiento, dirección, IBAN

2. El trabajador realiza la limpieza

3. Maideo declara las horas a URSSAF

4. URSSAF paga a Maideo directamente el 50% del importe (la parte del crédito fiscal)

5. URSSAF cobra el 50% restante al usuario final mediante domiciliación bancaria SEPA

Sin tarjeta, sin Stripe, sin pago por adelantado, sin PDF firmado. El IBAN + la identidad son suficientes.

Enlaces

• Sitio web de Maideo

• Especificación OpenAPI

• Política de agentes

• Manifiesto de LLMs

Licencia

MIT