@maideo/mcp

Maideo Agent API 的官方 MCP（模型上下文协议）服务器。

允许任何兼容 MCP 的 AI 智能体（Claude Desktop、Claude Code、ChatGPT 桌面版、Continue.dev、Cursor 等）在法国全境全流程预订专业家庭清洁服务（ménage à domicile），无需人工干预。

功能

• 按邮政编码检查服务覆盖范围

• 提供固定价格报价

• 在 Maideo 后台创建预订（运营团队可见）

• 为最终用户注册 URSSAF 50% 即时税收抵免预付（无需信用卡支付——每次服务后通过 SEPA 直接借记）

• 轮询预订状态

公开工具

安装

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：

“你能帮我预订下周一开始，位于巴黎 75001，Rivoli 路 12 号的每周 3 小时清洁服务吗？”

Claude 将自动串联这 5 个工具。

配置 Claude Code

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

环境变量

反欺诈保留期

所有通过此 MCP 服务器创建的预订在派遣工作人员前均有 48 小时的保留期。Maideo 运营团队可能会致电/发送短信给最终用户进行核实。请勿在生产环境中使用虚假数据提交预订。 你的 MAIDEO_AGENT_NAME 可能会被列入黑名单。

在调用 create_booking 之前，你还必须获得最终用户的明确同意。请将 agentConsent: true 作为绑定证明传递。

支付方式（无需支付步骤）

Maideo 使用 URSSAF 的 avance immédiate de crédit d'impôt（即时税收抵免预付），这是法国政府针对家庭服务的一项计划。

1. 最终用户通过 enroll_avance_immediate 注册——提供身份信息、出生地、地址、IBAN

2. 工作人员进行清洁服务

3. Maideo 向 URSSAF 申报工时

4. URSSAF 直接向 Maideo 支付 50% 的金额（税收抵免部分）

5. URSSAF 通过 SEPA 直接借记从最终用户处收取剩余的 50%

无需信用卡，无需 Stripe，无需预付，无需签署 PDF。 仅需 IBAN + 身份信息即可。

链接

• Maideo 网站

• OpenAPI 规范

• 智能体政策

• LLM 清单

许可证

MIT