@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 Paris에서 매주 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