Slotix

Slotix MCP サーバー

Slotix 用の MCP（Model Context Protocol）サーバーです。AI を活用した予約管理を提供します。

このサーバーを使うと、Claude Desktop や ChatGPT などの AI アシスタントが、自然な会話を通じて Slotix の予約、クライアント、通知を直接管理できます。

特長

• 予約：予約の表示、作成、更新、キャンセル、日時変更
• クライアント：クライアント情報と履歴の検索、表示
• 空き状況：予約可能な時間枠の確認
• 統計：ビジネスに関する分析情報の取得（売上、予約、クライアント）
• 通知：Telegram または WhatsApp でクライアントにメッセージを送信
• クーポン：QR コード付きの割引クーポンを作成し、クライアントに送信

前提条件

• 有効なサブスクリプションがある Slotix アカウント
• API キー（Slotix の Settings > API & Integrations で生成できます）

インストール

Claude Desktop

1. uvx を使用してインストールします：

uvx slotixmcp

2. claude_desktop_config.json を編集して Claude Desktop を設定します：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "slotix": {
      "command": "uvx",
      "args": ["slotixmcp"],
      "env": {
        "SLOTIX_API_KEY": "sk_slotix_your_api_key_here"
      }
    }
  }
}

3. Claude Desktop を再起動します

ChatGPT（Developer Mode）

1. ChatGPT の設定で Developer Mode を有効にします（Plus/Pro が必要です）
2. Settings → Connectors → Advanced Settings → Developer Mode に移動します
3. API キーを使って MCP サーバーを追加します

直接インストール（pip）

pip install slotixmcp

設定

次の環境変数を設定します：

変数	必須	説明
SLOTIX_API_KEY	はい	Slotix API キー（sk_slotix_ で始まります）
SLOTIX_API_URL	いいえ	API URL（デフォルト：https://api.slotix.it）

利用可能なツール

ツール	説明
get_profile	プロフィール情報を取得します
get_appointments	日付範囲とステータスのフィルターを指定して予約を取得します
get_today_appointments	今日の予約を取得します
get_week_appointments	今週の予約を取得します
get_appointment	特定の予約の詳細を取得します
create_appointment	新しい予約を作成します
update_appointment	既存の予約を更新します
cancel_appointment	予約をキャンセルします
reschedule_appointment	予約日時を変更し、必要に応じてクライアントに通知します
get_clients	オプションの検索条件を指定してクライアントの一覧を取得します
get_client	クライアントの詳細情報を取得します
get_availability	予約可能な時間枠を取得します
get_stats	ビジネスの統計情報を取得します
send_notification	クライアントにメッセージを送信します
create_coupon	割引クーポンを作成し、クライアントに送信します

会話の例

今日の予定を確認する：

「今日の予約は何がありますか？」

予約日時を変更する：

「Mario Rossi の予約を明日の午後3時に変更して、本人にも知らせてください」

クライアントの履歴を確認する：

「クライアントの Maria Bianchi の予約履歴を見せてください」

ビジネスの統計情報を取得する：

「今月はどうでしたか？統計情報を見せてください」

空き時間を探す：

「来週はいつ空いていますか？」

割引クーポンを送信する：

「クライアントの Mario Rossi に10％割引クーポンを作成してください」

定額クーポンを送信する：

「ID 42 のクライアントに €5 のクーポンを送ってください」

開発

ローカル開発

# Clone the repository
git clone https://github.com/slotix/SlotixMCP.git
cd SlotixMCP

# Install dependencies
pip install -e .

# Run the server
SLOTIX_API_KEY=your_key python -m slotixmcp.server

MCP Inspector でのテスト

npx @modelcontextprotocol/inspector uvx slotixmcp

---

MCP ストアへの公開

PyPI（uvx でのインストールに必須）

1. パッケージをビルドします：

pip install build twine
python -m build

2. PyPI にアップロードします：

# Test upload first
twine upload --repository testpypi dist/*

# Production upload
twine upload dist/*

または uv を使用します：

uv build
uv publish

MCP.so（コミュニティレジストリ）

1. mcp.so にアクセスします
2. "Submit Server" をクリックします
3. 次の内容を入力します：
   • 名前：Slotix
   • リポジトリ：https://github.com/slotix/SlotixMCP
   • 説明：プロフェッショナル向けの AI を活用した予約管理

または、リポジトリで GitHub の Issue を作成して送信します。

Smithery.ai

1. smithery.ai にアクセスします
2. GitHub でサインインします
3. MCP サーバーのリポジトリを送信します
4. メタデータと例を入力します

Glama.ai

1. glama.ai/mcp/servers にアクセスします
2. 「Submit Server」をクリックします
3. リポジトリの URL とドキュメントを入力します

Anthropic MCP ディレクトリ（公式）

要件：

• ウェブサイトからアクセスできるプライバシーポリシー
• 確認済みの連絡先情報
• テクニカルサポートの提供
• 有効な証明書を使用した OAuth 2.0（リモートサーバーの場合）
• 動作するユースケースの例が 3 つ以上
• Anthropic MCP Directory Policy への準拠

手順：

1. サーバーがすべてのセキュリティ要件とプライバシー要件を満たしていることを確認します
2. サンプルデータを含むテストアカウントを準備します
3. Claude Partners から申請します
4. 審査を待ちます（数週間かかる場合があります）

---

セキュリティ

• API キーを公開しないでください
• API キーを使用すると、Slotix アカウントに完全にアクセスできます
• キーが漏えいした場合は、無効化して再生成してください
• キーをハードコードせず、環境変数を使用してください

サポート

• ドキュメント：docs.slotix.it
• 問題：GitHub Issues
• メール：[email protected]

ライセンス

MIT ライセンス。詳細は LICENSE をご覧ください。