@maideo/mcp

Maideo Agent API用の公式MCP（Model Context Protocol）サーバーです。

MCP互換のAIエージェント（Claude Desktop、Claude Code、ChatGPT desktop、Continue.dev、Cursorなど）を使用して、フランス全土でプロのハウスクリーニング（ménage à domicile）を、人間の介入なしにエンドツーエンドで予約できます。

機能

• 郵便番号による対応エリアの確認

• 確定見積もりの取得

• Maideoのバックオフィスでの予約作成（運用チームが確認可能）

• 50%の即時税額控除前払い（URSSAF）のためのエンドユーザー登録（カード決済不要 — 各作業後に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に以下のように依頼できます：

「来週の月曜日から、パリの12 rue de Rivoli, 75001で毎週3時間の掃除を予約してくれますか？」

Claudeが自動的に5つのツールを連携させます。

Claude Codeの設定

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

環境変数

不正防止のための保留

このMCPサーバー経由で作成されたすべての予約は、作業員が派遣されるまで48時間保留されます。Maideoの運用チームがエンドユーザーに電話やSMSで確認を行う場合があります。本番環境で偽のデータを使用して予約を送信しないでください。 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が金額の50%（税額控除分）をMaideoに直接支払う

5. URSSAFが残りの50%をSEPA口座振替でエンドユーザーから徴収

カードもStripeも、前払いも、署名済みPDFも不要です。 IBANと本人確認情報だけで十分です。

リンク

• Maideoウェブサイト

• OpenAPI仕様

• エージェントポリシー

• LLMマニフェスト

ライセンス

MIT