@maideo/mcp

Официальный сервер MCP (Model Context Protocol) для Maideo Agent API.

Позволяет любому AI-агенту, совместимому с MCP (Claude Desktop, Claude Code, ChatGPT desktop, Continue.dev, Cursor и т. д.), бронировать профессиональные услуги по уборке дома (ménage à domicile) в любой точке Франции «под ключ», без участия человека.

Что он делает

Проверяет покрытие по почтовому индексу
Предоставляет твердое ценовое предложение
Создает бронирование в бэк-офисе Maideo (видимое для операционной команды)
Регистрирует конечного пользователя в URSSAF для получения 50% аванса налогового вычета (оплата картой не нужна — прямое списание SEPA после каждого визита)
Отслеживает статус бронирования

Доступные инструменты

Инструмент	Назначение
`search_coverage`	Проверить, обслуживает ли Maideo почтовый индекс
`get_quote`	Получить твердое ценовое предложение, действительное 72 часа
`create_booking`	Создать бронирование (возвращает `bookingToken`, действительный 72 часа)
`enroll_avance_immediate`	Отправить данные для регистрации в URSSAF (IBAN + личность)
`get_booking_status`	Получить статус (заказ, исполнитель, URSSAF)

Установка

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

Настройка Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Перезапустите Claude Desktop. Теперь вы можете попросить Claude:

"Можешь забронировать мне еженедельную 3-часовую уборку по адресу 12 rue de Rivoli, 75001 Paris, начиная со следующего понедельника?"

Claude автоматически объединит 5 инструментов.

Настройка Claude Code

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

Переменные окружения

Переменная	По умолчанию	Назначение
`MAIDEO_API_BASE`	`https://api.maideo.fr/public/agent`	Базовый URL API (переопределите для staging/dev)
`MAIDEO_AGENT_NAME`	`maideo-mcp-client`	Идентификатор, отправляемый через заголовок `X-Agent-Name` (используется для ограничения частоты запросов и аналитики)

Защита от мошенничества

Все бронирования, созданные через этот MCP-сервер, удерживаются в течение 48 часов перед назначением исполнителя. Операционная команда Maideo может позвонить или отправить SMS конечному пользователю для проверки. Не отправляйте бронирования с фиктивными данными в продакшн. Ваш MAIDEO_AGENT_NAME может быть заблокирован.

Вы также должны получить явное согласие от конечного пользователя перед вызовом create_booking. Передайте agentConsent: true в качестве подтверждения согласия.

Как работает оплата (этапа оплаты нет)

Maideo использует систему URSSAF avance immédiate de crédit d'impôt (аванс налогового вычета), государственную программу Франции для бытовых услуг.

Конечный пользователь регистрируется через enroll_avance_immediate — предоставляет личность, место рождения, адрес, IBAN
Исполнитель выполняет уборку
Maideo декларирует часы в URSSAF
URSSAF выплачивает Maideo напрямую 50% от суммы (часть налогового вычета)
URSSAF списывает оставшиеся 50% с конечного пользователя через прямое списание SEPA

Никаких карт, никакого Stripe, никакой предоплаты, никаких подписанных PDF. Достаточно IBAN и данных личности.

Ссылки

Лицензия

MIT

maideo