Zooza Mcp Server

Zooza MCP 服务 — 为活动业务提供 AI 驱动的课程管理

一个开源的 模型上下文协议（MCP）服务，可将 Claude、ChatGPT 和其他 AI 助手直接连接到你的 Zooza 账户。
通过自然语言安排日程、追踪出勤、跟进潜在客户并管理课程——无需使用控制面板。

网站 · 文档 · 快速入门 · 工具 · 获取 Zooza 账户

查看实际演示

项目介绍

Zooza MCP 服务是一个免费、开源的模型上下文协议（MCP）集成，适用于 Zooza——一款面向舞蹈学校、语言学院、游泳学校、音乐学校、STEAM 项目、体育俱乐部及其他活动业务的课程管理和日程安排软件。

活动管理者、学校管理员和加盟业务运营者可以通过自然语言对话管理日程、追踪出勤、创建课程、处理预订和咨询、设置分期付款，并查询数据——使用 Claude、ChatGPT 或任何兼容 MCP 的 AI 客户端即可，无需打开 Zooza 控制面板。

Zooza 为斯洛伐克、捷克、德国、英国及其他地区的 500,000 多名学员提供服务——客户从单店舞蹈学校到国际加盟网络不等。这个 MCP 服务将同一平台带给任何支持 模型上下文协议的 AI 客户端。

刚接触 Zooza？ 在 signup.zooza.online 创建免费账户——不到 2 分钟即可完成。

你可以做什么

记录出勤

"Open the register for tonight's adult ballet class."
"Who was absent from Saturday's Spanish beginners session?"
"Mark everyone present in today's robotics group."
"Add a note to this week's yoga class — we covered breathing techniques."

从头创建一个学期

"Create a new Spanish for beginners course for Spring 2026 at the city centre location.
 Classes every Tuesday 16:00–17:00 for 12 weeks, starting 3 March.
 Assign trainer Tomáš Novák and preview the full schedule before I confirm."

"Set up our summer robotics camp — Monday to Friday, 9:00–13:00, for 4 weeks in July.
 Split into two age groups: 6–9 and 10–14. Preview both before I confirm."

将照片变成完整学期安排——无需从空白页开始

手动安排一个学季，意味着要花两天时间在空白表单中录入内容。现在，你只需把已有的资料交给助手——白板照片、手绘草图或电子表格截图都可以——它就会为你拟定整个学期的安排，供你审核后再发布。

"Here's a photo of our autumn whiteboard — create these classes in my account, starting Monday the 8th."
"Screenshot of our timetable spreadsheet attached. Build the full term, respecting our holiday calendar."

你总会先看到预览表格和日历，只有在你确认后才会创建任何内容——由你提出需求，最终决定权始终在你手中。了解一个品牌如何将一张照片变成跨多个场地的 68 个已发布课程：从一张照片到完整的已发布学期课程。

即时获取答案

"Which programmes are running this billing period?"
"Who's teaching dance on Monday evenings?"
"Which STEAM courses still have free capacity this term?"
"What sessions are scheduled for tomorrow?"

管理预订

"Show unpaid registrations from this season."
"Which clients are on the waiting list for Saturday gymnastics?"
"How many spots are left in the beginner English course?"

处理从首次来信到报名的咨询

收到咨询后，回复了邮件，然后邮件就一直留在某个人的收件箱里，直到热度消退。助手会将整个对话线程作为记录保存在 Zooza 中——咨询会成为可跟踪的潜在客户，回复会返回到你能看到的地方，需要人工处理的事项则会成为标明负责人的待办事项。

"Log this enquiry from the contact form as a lead and tag it 'spring-open-day'."
"Did anyone reply to last week's trial invitations? Show me what they said."
"This parent asked about sibling discounts — assign it to Katka, due Friday."
"Tag the leads who booked a trial as 'converted' and close out the rest."

这里的任何操作都不会在你不知情的情况下给客户发邮件——录入潜在客户不会发送任何内容，而且所有外发消息仍会经过先规划再确认的流程。

设置分期付款

"Split our €200 term fee into 4 monthly payments and offer it on the ballet programme."
"This programme has 14 payment plans attached — clean it up, leave only the two we use."
"Put Nováková's booking on the 3-instalment plan starting next month."

用自然语言询问任意报告

无需报告模块，也无需电子表格公式。像平时思考问题一样提出业务问题，助手就会提取真实数据并整理呈现——内容会根据你的问题量身定制，而不是套用固定仪表板。

"Who's at which venue each day this week?"
"Which instructors are stretched thin, and who has room for more?"
"What grew and what shrank between the spring and summer terms?"
"How many seats does my whole operation actually have right now?"

报告操作只会读取数据——绝不会触及预订、课程或付款，因此你可以放心探索。了解品牌如何使用此功能：只需开口询问，即可生成自定义报告。

无需点击菜单，无需切换标签页，也无需编写自动化脚本。只需提出问题——Claude 会处理查询、名册、预览和确认。

支持的客户端

2 分钟内完成连接

还没有 Zooza 账户？ 在 signup.zooza.online 免费注册

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "zooza": {
      "type": "http",
      "url": "https://mcp.zooza.app/mcp"
    }
  }
}

文件位置：

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

重启 Claude Desktop。首次使用时，系统会提示你登录 Zooza 账户——无需 API 密钥，也无需额外设置，只需使用现有登录信息即可。

Claude Code

从 Releases 下载最新插件（文件名为 zooza-plugin-v*.zip），然后运行：

/install-plugin zooza-plugin-v*.zip

插件包含 MCP 连接配置、引导式工作流技能，以及自动会话上下文。

注意： 35 个工具中有 5 个（get_terminology、explain_data_model、comms_list_merge_vars、classes_list_schedule_patterns、negotiate_terminology）无需 Zooza 账户即可使用——适合在连接实时数据前了解数据模型的运作方式。

工作原理

You → Claude / ChatGPT → Zooza MCP Server → Zooza API → Your data

MCP 服务由 Zooza 托管在 mcp.zooza.app，无状态运行。你无需在本地运行任何程序。每个请求都会通过你的 Zooza 账户进行身份验证——Claude 只能查看和更改你在控制面板中已有权限访问的内容。

每项写入操作都必须经过明确确认才能提交——Claude 会向你展示即将创建或更改的内容，只有在你确认后才会继续。

区域： 支持欧盟（SK/CZ/DE/RO/HU/IT/PL）、英国、美国和亚洲区域。系统会自动将你的账户路由到正确的区域基础设施。

多地点和加盟账户： 每次会话开始时，Claude 都会询问要操作哪个地点。你可以在对话中途切换地点——便于跨地点比较或管理整个网络。

语言与地区

Zooza MCP 专为多语言、多市场运营而设计，开箱即能理解不同地区的术语差异：

negotiate_terminology 工具可以让 Claude 了解您的业务所使用的特定词汇，并在之后的每次对话中使用这些词汇——因此，如果您把课程项目称为“kurzy”，把课次称为“hodiny”，Claude 就会始终使用您的说法进行回复。

可用工具

35 个工具，涵盖排课、出勤、预订与潜在客户、客户沟通、付款与分期账单、报告、课程项目和课次编辑，以及 Zooza 领域知识。

排课与课程管理

编辑班级与课次

每次编辑都分为两步：预览 → 确认——调用同一工具两次；在您批准差异前，不会进行任何更改。

出勤

预订

客户沟通

付款与分期账单

设置分期付款涉及三个独立对象：方案包含价格，模板规定如何拆分价格，而计划则将这种拆分应用到某位客户的预订上。方案设置为分期收款后，只有附加模板才会生成付款计划；方案上的模板不会自动继承到预订中——每笔预订都需要应用计划。

潜在客户、标签与跟进

报告

查询

免费工具 — Zooza 领域知识（不调用 API，无需账户）

这五个工具包含 Zooza 专属知识，无需凭据即可使用——不需要 Zooza 账户。适用于探索数据模型、准备消息，以及在连接实时数据前设置术语。

实用工具

Skills — 引导式活动工作流

Skills 是操作指南，用于教会 Claude 如何在实际运营场景中正确组合工具。检测到匹配的请求时，Claude 会自动加载相应的 Skill。

安全与合规

• TLS — 保护 AI 客户端与 mcp.zooza.app 之间的所有流量
• OAuth 2.0 — Claude 会收到与 Zooza 身份绑定的受限令牌，而非密码
• 权限继承 — Claude 只能执行 Zooza 账户权限允许的操作
• 写入前确认 — 所有创建或更改记录的操作都需要明确确认
• 无状态服务 — MCP 服务不会在请求之间保留会话状态。出于安全和调试目的，Zooza 会在服务端保留工具调用审计日志（运行的工具、其参数及结果）；日志仅保留在 Zooza 自身的基础设施内，绝不会与第三方共享
• 符合 GDPR 要求 — Zooza 按照 GDPR 处理数据。请参阅隐私政策和个人数据处理条款。欧盟账户会路由至欧盟区域的基础设施。
• 区域数据路由 — 欧盟、英国、美国和亚洲区域分别路由至各自的基础设施；JWT 会自动确定所在区域

向 Zooza MCP 发出的查询可能会由您选择的 AI 提供商（Anthropic、OpenAI 等）处理。评估合规要求时，请同时查看其数据政策和 Zooza 的数据政策。所有写入操作在执行前都需要明确确认。

Zooza 是什么

Zooza 是面向活动品牌的一站式课程管理与排期软件平台：

舞蹈与运动 — 舞蹈学院、体操、婴幼儿运动课程、瑜伽
语言与教育 — 语言学校、辅导中心、STEAM / 机器人 / 编程
体育 — 武术、游泳学校、网球学院、体育俱乐部和特许经营网络
营地与季节性活动 — 夏令营、假期项目、周末工作坊
音乐 — 音乐学校、乐器课程、团体和个人项目
健身与健康 — 健身工作室、普拉提、婴幼儿课程

所有业务都在同一平台上运行，从单一地点到国际特许经营网络皆可覆盖。

Zooza 管理完整的运营生命周期：项目设置、课程排期、客户预约与注册、出勤跟踪、付款管理、家长沟通以及多地点报告，旨在自动处理目前依赖电子表格、WhatsApp 群组和六个不同控制面板标签页的手动工作。

Zooza MCP 将该平台扩展至 AI。团队成员——从活动经理到特许经营运营者——无需在控制面板中逐项点击，即可使用 Claude、ChatGPT 或任何支持 Model Context Protocol 的 AI 客户端，通过自然语言对话操作 Zooza。

路线图

面向开发者

git clone https://github.com/zooza-dev/zooza-mcp-server
cd zooza-mcp-server
npm install
cp .env.example .env   # fill in credentials
npm run dev            # http://localhost:3001/mcp

curl -sS http://localhost:3001/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Claude / ChatGPT (any MCP client)
    │  Streamable HTTP over TLS
    ▼
mcp.zooza.app  (Node.js / TypeScript — stateless)
    │  OAuth 2.0 JWT validation + regional routing
    ▼
Zooza API  (your data, your permissions)

支持

help.zooza.online — 完整文档
zooza.online — 平台网站
[email protected] — 联系我们
signup.zooza.online — 创建 Zooza 账户

如果它为你节省了时间，点亮 ⭐ 可以帮助其他人发现它。

由 Zooza 构建 — 面向活动品牌的课程管理与排期软件。