@maideo/mcp

Offizieller MCP-Server (Model Context Protocol) für die Maideo Agent API.

Ermöglicht jedem MCP-kompatiblen KI-Agenten (Claude Desktop, Claude Code, ChatGPT Desktop, Continue.dev, Cursor usw.), professionelle Reinigungsdienste für Privathaushalte (ménage à domicile) in ganz Frankreich von Anfang bis Ende ohne menschliches Eingreifen zu buchen.

Was es tut

• Überprüft die Abdeckung anhand der Postleitzahl

• Liefert ein verbindliches Preisangebot

• Erstellt eine Buchung im Back-Office von Maideo (sichtbar für das Ops-Team)

• Meldet den Endnutzer bei der URSSAF für den 50%igen sofortigen Steuerkreditvorschuss an (keine Kartenzahlung erforderlich – SEPA-Lastschrift nach jedem Einsatz)

• Fragt den Buchungsstatus ab

Verfügbare Tools

Installation

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

Claude Desktop konfigurieren

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Starten Sie Claude Desktop neu. Sie können Claude nun fragen:

„Kannst du für mich eine wöchentliche 3-stündige Reinigung in der 12 rue de Rivoli, 75001 Paris, ab nächstem Montag buchen?“

Claude wird die 5 Tools automatisch verketten.

Claude Code konfigurieren

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

Umgebungsvariablen

Betrugspräventionssperre

Alle über diesen MCP-Server erstellten Buchungen werden 48 Stunden lang zurückgehalten, bevor eine Reinigungskraft entsandt wird. Das Maideo-Ops-Team kann den Endnutzer per Telefon/SMS kontaktieren, um die Buchung zu verifizieren. Übermitteln Sie in der Produktion keine Buchungen mit gefälschten Daten. Ihr MAIDEO_AGENT_NAME könnte auf eine Sperrliste gesetzt werden.

Sie müssen außerdem die ausdrückliche Zustimmung des Endnutzers einholen, bevor Sie create_booking aufrufen. Übergeben Sie agentConsent: true als verbindliche Bestätigung.

Wie die Zahlung funktioniert (es gibt keinen Zahlungsschritt)

Maideo nutzt den URSSAF avance immédiate de crédit d'impôt (sofortiger Steuerkreditvorschuss), ein französisches Regierungsprogramm für haushaltsnahe Dienstleistungen.

1. Der Endnutzer meldet sich über enroll_avance_immediate an – unter Angabe von Identität, Geburtsort, Adresse und IBAN

2. Die Reinigungskraft führt die Reinigung durch

3. Maideo meldet die Stunden an die URSSAF

4. Die URSSAF zahlt Maideo direkt 50 % des Betrags (den Steuerkreditanteil)

5. Die URSSAF zieht die verbleibenden 50 % vom Endnutzer per SEPA-Lastschrift ein

Keine Karte, kein Stripe, keine Vorauszahlung, kein unterschriebenes PDF. Die IBAN + Identität reichen aus.

Links

• Maideo-Website

• OpenAPI-Spezifikation

• Agenten-Richtlinie

• LLMs-Manifest

Lizenz

MIT