Orah MCP by usefulapi

usefulapi 的 Orah MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Orah 账户。它可以读取学生、点名册、出勤情况、地点和教职员工信息，并创建或更新学生、联系人和宿舍。托管服务，无需本地安装：使用你自己的凭据连接。

在线端点： https://orah.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、桌面版）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://orah.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http orah https://orah.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "orah": {
      "url": "https://orah.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求提供你的 Orah 凭据。

分步设置指南、凭据查找方法及常见问题：https://usefulapi.io/orah/

首次连接时，你需要提供学校的 Orah Open API key，以及学校 Orah 所在的区域。学校管理员可在 Admin Console → Settings → Open API 下创建密钥，并将 IP 白名单留空。服务会验证密钥，并按用户保存。请勿将密钥放入配置文件。

工具

工具	类型	功能
orah_list_students	读取	列出学生
orah_get_student	读取	获取学生
orah_list_houses	读取	列出宿舍
orah_list_student_contacts	读取	列出学生联系人
orah_list_groups	读取	列出群组
orah_list_reason_codes	读取	列出原因代码
orah_list_locations	读取	列出地点
orah_list_current_locations	读取	列出学生当前所在地点
orah_list_location_records	读取	列出地点记录历史
orah_list_pastoral	读取	列出学生关怀记录
orah_list_roll_types	读取	列出点名册类型
orah_list_rolls	读取	列出点名册
orah_get_roll	读取	获取点名册
orah_list_daily_attendance	读取	列出每日出勤情况
orah_list_scheduled_classes	读取	列出已安排的课程
orah_list_staff	读取	列出教职员工
orah_get_staff	读取	获取教职员工成员
orah_list_leave_types	读取	列出请假类型
orah_get_leave	读取	获取请假记录
orah_create_student	写入	创建学生
orah_update_student	写入	更新学生
orah_create_contact	写入	创建联系人
orah_update_contact	写入	更新联系人
orah_create_house	写入	创建宿舍
orah_update_house	写入	更新宿舍
orah_usage_status	元信息	使用情况（免费层级用量计量）
orah_request_feature	元信息	申请添加缺失功能
orah_upgrade	元信息	升级到 Pro 或 Pro+
orah_cancel_subscription	元信息	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前确认）；meta 工具用于报告用量、管理订阅或发送功能请求。

定价

套餐	价格	限额
Free	$0	每月 50 次工具调用
Pro（每位用户）	$9/月 或 $90/年（免费 2 个月）	无限*

*Pro 在此服务上的合理使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 orah_upgrade 订阅（该工具会返回 Stripe Checkout 链接）。你可以随时使用 orah_cancel_subscription 取消：Pro 会持续到已付费周期结束，当前周期不予退款；在此之前运行 orah_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT — 请参阅 LICENSE。仅提供文档；服务由他方托管。