mcpField
Z
ZenMaid MCP Server and API by Cotlet

ZenMaid MCP Server and API by Cotlet

リモート
cotlet.devビジネス・マーケティング02 日前に更新
リポジトリ公式サイト

ZenMaid MCP Server and API by Cotlet について

ZenMaid MCP Server and API by Cotletは、清掃事業者向けにAIクライアントをログイン済みのZenMaidアカウントへ接続します。Cotlet.dev経由で予約管理や顧客管理を行え、ホスト型とローカルのMCPに対応します。

主な機能

  1. 01清掃予約の作成と変更
  2. 02予約可能な時間枠の検索
  3. 03顧客と定期清掃の登録
  4. 04今後の予約と前回清掃日の確認
  5. 05チーム間での作業割り当て変更

活用シーン

  1. 01顧客のディープクリーニング予約
  2. 02翌週のサービス空き枠の確認
  3. 03隔週の定期清掃の設定
  4. 04作業を別チームへ引き継ぎ

MCP 対応

ホスト型MCPエンドポイントと、Cotlet.devへツール呼び出しを転送するローカルstdioサーバーを提供します。ツールにはZenMaidの案内、状態確認、ブラウザー操作があります。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://cotlet.dev/mcp/v1/zenmaid/connect
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

すべてのエンドポイント
Streamable HTTPhttps://cotlet.dev/mcp/v1/zenmaid/connect
Streamable HTTPhttps://cotlet.dev/mcp/v1/zenmaid認証が必要

ツール

詳細

ZenMaid を Claude Code、ChatGPT、任意の AI エージェントに接続する方法

Claude、ChatGPT などの AI エージェントは、ZenMaid アカウントで利用できます。 ZenMaid には ChatGPT や Claude のディレクトリに公式アプリがなく、ドキュメントでは Zapier を介した連携を案内しています。Cotlet.dev を使うと、サインイン済みのご自身の ZenMaid アカウントを任意の AI エージェントに接続できるため、普段の言葉で依頼するだけで、AI がジョブのスケジュール設定、空き状況の確認、顧客情報の更新を行います。

依頼できること

Maria Lopez さん（42 Oak Street）のディープクリーニングを、木曜日の午前9時にTeam Bで3時間予定してください。

来週、2時間のスタンダードクリーニングを予約できる時間帯を教えてください。曜日ごとに一覧にしてください。

18 Pine Ave の David Chen さんを新規顧客として追加し、隔週月曜日の午後1時にクリーニングを予定してください。

今後30日間にジョブが予定されていない定期利用の顧客は誰ですか？直近のクリーニング日も表示してください。

Kelly さんの金曜日のジョブをすべて Rosa さんに変更し、影響を受ける顧客を一覧にしてください。

2分で接続

https://cotlet.dev/app で API キーを取得し、COTLET_API_KEY としてエクスポートします。

Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
ChatGPT

設定 → アプリ → コネクター URL https://cotlet.dev/mcp/v1 を追加し、Cotlet.dev にサインインします。API キーは必要ありません。

Cursor

このリポジトリから .cursor/mcp.json をプロジェクトにコピーします。

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

ローカルで実行する（stdio）

このリポジトリは実際の MCP サーバーです。stdio 経由で MCP を使用し、キーがなくても ZenMaid のツールを一覧表示し、すべてのツール呼び出しをホスト型 Cotlet.dev サーバーに転送します。上記のホスト型 URL を引き続き推奨します。クライアントがローカルサーバーしか起動できない場合に使用してください。

{"mcpServers":{"zenmaid":{"command":"uvx","args":["zenmaid-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

または Docker を使用します。

docker build -t zenmaid-mcp .
docker run -i --rm -e COTLET_API_KEY zenmaid-mcp

ツール：zenmaid_guide、zenmaid_status、zenmaid_open、zenmaid_read、zenmaid_click、zenmaid_type、zenmaid_close。COTLET_API_KEY が設定されていない場合、ツール呼び出しは「COTLET_API_KEY を設定してください。https://cotlet.dev/app でキーを取得できます」と応答します。

コマンドライン

Python 3.10 以降が必要です。ほかにインストールするものはありません。PyPI からインストールする場合：

pip install zenmaid-mcp        # or run it once: uvx zenmaid-mcp connect
zenmaid-mcp connect

または、このリポジトリから直接インストールします。

export COTLET_API_KEY="your-key"
python3 zenmaid_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 zenmaid_agent.py status    # is ZenMaid ready in your Cotlet.dev account
python3 zenmaid_agent.py guide     # ZenMaid screens and sign-in link
python3 zenmaid_agent.py read      # open ZenMaid, read the page, close the browser
python3 zenmaid_agent.py tools     # list Cotlet.dev tools
python3 zenmaid_agent.py serve     # start the stdio MCP server (same as no argument)

ZenMaid ユーザーからの質問

ZenMaid に API はありますか？

ZenMaid のドキュメントでは、Zapier を介した連携を案内しています。Cotlet.dev は ZenMaid アカウントで直接動作するため、Zap を設定しなくても AI エージェントがジョブのスケジュール設定や顧客管理を行えます。

ZenMaid を ChatGPT に接続するにはどうすればよいですか？

ChatGPT で Cotlet.dev をアプリとして追加し（設定 → アプリ、コネクター URL は https://cotlet.dev/mcp/v1）、Cotlet.dev のクラウドブラウザーで ZenMaid に一度サインインしてから、普段の言葉で ChatGPT に依頼します。コードも ZenMaid API キーも必要ありません。

Claude を ZenMaid で使う方法はありますか？

はい。Claude Code では上記の1行の claude mcp add コマンドを実行します。Claude アプリでは https://cotlet.dev/mcp/v1 をカスタムコネクターとして追加します。これで Claude がご自身の ZenMaid アカウントで動作します。

ZenMaid 用の MCP サーバーはありますか？

ZenMaid には公式の MCP サーバーはありません。Zapier では、サードパーティ製の ZenMaid MCP 接続を提供しています。Cotlet.dev は、Claude、ChatGPT、Cursor、Codex、n8n、Make、Zapier とともに ZenMaid で24時間365日利用できるホスト型 MCP サーバーです。

掲載先

以下とも連携できます

詳細：https://cotlet.dev/integrations/zenmaid-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=zenmaid

無料で始める：https://cotlet.dev/signup?app=zenmaid&utm_source=github&utm_medium=readme&utm_campaign=zenmaid

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。