关于 Teachworks MCP by usefulapi
Teachworks MCP by usefulapi 是面向辅导机构及其运营人员的托管 MCP 服务,可从 MCP 客户端查看教学与财务记录,并安排课程。它还支持创建家庭、学生、课程和付款记录。
主要功能
- 01查询学生、家庭与员工
- 02查看课程、可用时间和事件
- 03读取发票及付款记录
- 04创建家庭、学生和课程
- 05添加学生到课程并记录付款
适用场景
- 01查询学生及其课程安排
- 02核对发票和付款信息
- 03创建课程并将学生加入课程
MCP 相关
提供托管 MCP 服务,可连接 Claude、Cursor 等客户端。客户端使用 Teachworks API token 访问只读工具和部分写入工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://teachworks.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-teachworks https://teachworks.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-teachworks":{"type":"http","url":"https://teachworks.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-teachworks":{"type":"http","url":"https://teachworks.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-teachworks":{"type":"http","url":"https://teachworks.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-teachworks":{"serverUrl":"https://teachworks.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
24| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码(从 1 开始,默认值为 1)。 |
| type | enum | 否 | family = 子女学生,independent = 独立学生。family | independent |
| string | 否 | 按电子邮件搜索。 | |
| grade | string | 否 | 按年级搜索。 |
| school | string | 否 | 按学校搜索。 |
| status | enum | 否 | Active | Inactive | Prospective |
| subject | string | 否 | 按主题搜索。 |
| per_page | integer | 否 | 每页记录数(默认值为 20,最大值为 50)。 |
| direction | enum | 否 | 按 id 升序(默认)或降序(最新优先)排序。asc | desc |
| last_name | string | 否 | 按姓氏搜索。 |
| first_name | string | 否 | 按名字搜索。 |
| customer_id | any | 否 | 仅显示属于此客户/家庭 id 的学生。 |
| phone_number | string | 否 | 按电话号码搜索。 |
详细介绍
usefulapi 推出的 Teachworks MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Teachworks — 读取 Teachworks 学生、家庭、导师、课程、发票和付款信息;预约课程。 托管服务,无需本地安装:使用你自己的 Teachworks 凭据连接。
在线端点: https://teachworks.usefulapi.io/mcp · 主页: https://usefulapi.io/teachworks
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://teachworks.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http teachworks https://teachworks.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"teachworks": {
"url": "https://teachworks.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Teachworks 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/teachworks/
首次连接时,你需要提供自己的 Teachworks API 令牌。 系统会验证你的凭据、按用户存储并限定为仅你本人使用 — 配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
teachworks_list_students | 读取 | 列出学生 |
teachworks_get_student | 读取 | 获取学生信息 |
teachworks_list_customers | 读取 | 列出客户 |
teachworks_get_customer | 读取 | 获取客户信息 |
teachworks_list_employees | 读取 | 列出员工 |
teachworks_get_employee | 读取 | 获取员工信息 |
teachworks_get_employee_earnings | 读取 | 获取员工收入 |
teachworks_get_lesson_totals | 读取 | 获取课程总数 |
teachworks_list_lessons | 读取 | 列出课程 |
teachworks_get_lesson | 读取 | 获取课程信息 |
teachworks_list_other_events | 读取 | 列出其他活动 |
teachworks_list_availabilities | 读取 | 列出教师可用时间 |
teachworks_list_invoices | 读取 | 列出发票 |
teachworks_get_invoice | 读取 | 获取发票 |
teachworks_list_payments | 读取 | 列出付款 |
teachworks_get_payment | 读取 | 获取付款 |
teachworks_list_locations | 读取 | 列出地点 |
teachworks_list_services | 读取 | 列出服务 |
teachworks_list_subjects | 读取 | 列出科目 |
teachworks_create_family | 写入 | 创建家庭 |
teachworks_create_child_student | 写入 | 创建子女学生 |
teachworks_create_lesson | 写入 | 创建课程 |
teachworks_add_student_to_lesson | 写入 | 将学生添加到课程 |
teachworks_create_payment | 写入 | 记录付款 |
teachworks_usage_status | 元数据 | 使用状态(免费套餐用量计量) |
teachworks_request_feature | 元数据 | 请求添加缺失的功能 |
teachworks_upgrade | 元数据 | 升级到 Pro(无限*) |
teachworks_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先征求确认);meta 工具用于报告用量、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/月 或 $90/年(免费赠送 2 个月) | 无限* |
*此服务上的 Pro 套餐公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 套餐仅适用于此服务。使用 teachworks_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 teachworks_cancel_subscription 取消:Pro 服务会持续到已付费周期结束,当前周期不予退款;在此之前运行 teachworks_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Teachworks 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。