mcpField
A
Appointy MCP Server and API by Cotlet

Appointy MCP Server and API by Cotlet

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

Appointy MCP Server and API by Cotlet について

AI エージェントをログイン済みの Appointy アカウントに接続し、予約や顧客対応を行う MCP サーバーです。ホスト型接続に加え、Cotlet.dev へ呼び出しを転送するローカル stdio 方式も利用できます。

主な機能

  1. 01予約の作成と変更
  2. 02予約のキャンセルと顧客への通知
  3. 03スタッフ別の予定と空き時間の確認
  4. 04予約リマインダーの送信
  5. 05ホスト型とローカル stdio に対応

活用シーン

  1. 01顧客の相談予約と確認通知
  2. 02スタッフ別の予定の空き時間確認
  3. 03予約変更と関係する顧客への通知

MCP 対応

Cotlet.dev のホスト型エンドポイントを通じて、MCP クライアントに Appointy のツールを提供します。ローカル stdio サーバーも利用でき、ツール呼び出しをホスト型サービスへ転送します。

設定

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

エンドポイントhttps://cotlet.dev/mcp/v1/appointy/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/appointy/connect
Streamable HTTPhttps://cotlet.dev/mcp/v1/appointy認証が必要

ツール

詳細

Appointy を Claude Code、ChatGPT、あらゆる AI エージェントに接続する方法

はい、Claude、ChatGPT、その他の AI エージェントは Appointy アカウントで作業できます。 ChatGPT や Claude のディレクトリには Appointy の公式アプリが見つからず、サードパーティ製の Zapier MCP 統合で利用できるアクションは「顧客を作成」の 1 つだけでした。Cotlet.dev を使うと、サインイン済みのご自身の Appointy アカウントをあらゆる AI エージェントに接続できます。普段の言葉で頼むだけで、AI が予約、日時変更、クライアントへのリマインダー送信を行います。

依頼できること

木曜日の午前 10 時に、Dr. Patel の 60 分間の相談を Maria Lopez に予約して、確認メールを送ってください。

来週月曜日のスタッフごとの予定を教えてください。45 分を超える空き時間があれば一覧にしてください。

Tom の金曜日午後の予約をすべて土曜日午前に移動して、各クライアントに通知してください。

水曜日午後 3 時のグループレッスンをキャンセルして、予約している 8 人に連絡してください。

明日の予約者のうち、まだ確認していない全員にリマインダーを送ってください。

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

「Settings → Apps」からコネクター 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 通信を行い、API キーなしで Appointy のツールを一覧表示し、すべてのツール呼び出しをホストされた Cotlet.dev サーバーに転送します。上記のホスト URL を使う方法を推奨します。クライアントがローカルサーバーしか起動できない場合に、こちらをお使いください。

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

Docker を使う場合:

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

ツール:appointy_guide、appointy_status、appointy_open、appointy_read、appointy_click、appointy_type、appointy_close。COTLET_API_KEY が設定されていない場合、ツール呼び出しには「COTLET_API_KEY を設定してください。キーは https://cotlet.dev/app で取得できます。」と応答します。

コマンドライン

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

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

または、このリポジトリから直接インストールする場合:

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

Appointy ユーザーからの質問

Appointy に API や開発者向けドキュメントはありますか?

Appointy のプライベート API を利用できるのは Enterprise プランのみです。また、Zapier アプリでできるのは顧客の作成だけです。Cotlet.dev はどのプランでも、サインイン済みのご自身の Appointy アカウントで動作するため、AI エージェントで予約、承認、日時変更、キャンセルができます。

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

ChatGPT のアプリとして Cotlet.dev を追加し(「Settings → Apps」から、コネクター URL https://cotlet.dev/mcp/v1 を入力)、Cotlet.dev の Cloud Browser で一度 Appointy にサインインしてから、普段の言葉で ChatGPT に依頼します。コードも Appointy API キーも必要ありません。

Appointy で Claude を使う方法はありますか?

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

Appointy 用の MCP サーバーはありますか?

Appointy には公式 MCP サーバーがなく、ChatGPT や Claude の公式アプリもありません(2026 年 11 月時点で確認)。Cotlet.dev は、Claude、ChatGPT、Cursor、Codex、n8n、Make、Zapier と連携し、ご自身のアカウントで動作するホスト型 Appointy MCP サーバーです。

掲載先

こちらとも連携できます


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

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

コメント

MCP は初めてですか?

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

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