Slotix

Slotix MCP Server

适用于 Slotix 的 MCP（Model Context Protocol）服务——AI 驱动的预约管理。

此服务允许 Claude Desktop 和 ChatGPT 等 AI 助手通过自然对话，直接管理您的 Slotix 预约、客户和通知。

功能

• 预约：查看、创建、更新、取消和重新安排预约
• 客户：搜索并查看客户信息和历史记录
• 可预约时段：查看可供预约的时段
• 统计数据：获取业务洞察（收入、预约、客户）
• 通知：通过 Telegram 或 WhatsApp 向客户发送消息
• 优惠券：创建带二维码的折扣券并发送给客户

前提条件

• 拥有有效订阅的 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（开发者模式）

1. 在 ChatGPT 设置中启用开发者模式（需要 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. 点击“提交服务”
3. 提供仓库 URL 和文档

Anthropic MCP Directory（官方）

要求：

• 网站上提供可访问的隐私政策
• 已验证的联系信息
• 提供技术支持
• 使用有效证书的 OAuth 2.0（适用于远程服务）
• 至少 3 个可正常运行的示例用例
• 遵守 Anthropic MCP Directory 政策

流程：

1. 确保服务满足所有安全和隐私要求
2. 准备包含示例数据的测试账号
3. 通过 Claude Partners 提交
4. 等待审核（可能需要数周）

---

安全

• 切勿公开分享 API 密钥
• API 密钥可完全访问你的 Slotix 账号
• 如果密钥泄露，请撤销并重新生成
• 使用环境变量，不要将密钥硬编码

支持

• 文档：docs.slotix.it
• 问题：GitHub Issues
• 电子邮件：[email protected]

许可证

MIT 许可证——详情请参阅 LICENSE。