Notit MCP 连接指南
开始前的准备
MCP 是让 AI 应用连接外部数据和工具的开放标准。连接 Notit 后,AI 助手可以读取您授权的学习资料,并用于回答问题。更多信息请参阅 MCP 官方介绍。
- Notit 账户与学习资料:登录您要使用的账户,确认需要查询的课程、课堂记录和笔记已保存在 Notit 中。
- 兼容的客户端:需要支持远程 HTTP MCP 服务器,以及 OAuth 登录或自定义认证请求头的 AI 应用。设置菜单名称和使用条件因客户端而异。
- Notit 套餐:所有套餐都可以连接,但通过 MCP 读取学习数据需要 Plus 或 Pro。查看 Notit 套餐
通过 OAuth 连接 · 推荐
登录 Notit 并批准读取权限即可。无需签发手动 MCP 令牌,也无需打开 Notit 中的 MCP 开关。
- 在 AI 应用中打开添加远程 MCP 服务器的设置。如果需要名称,请输入 Notit。
- 输入以下服务器地址并开始连接。
https://mcp.notit.ai/mcp
- Notit 登录页面打开后,登录保存了学习资料的账户。
- 确认发起请求的客户端与回调主机,然后选择至少一项读取权限。各权限的作用见权限表。
- 选择连接并返回 AI 应用。在对话中选择或启用 Notit 工具。
尝试第一次提问,确认能够读取数据。您可以在 Notit 的我的 → 集成 → MCP → 详细设置 → 已连接的应用中查看 OAuth 连接。
通过手动令牌连接
此方式适用于支持自定义 HTTP 认证请求头或 Bearer 令牌的客户端。
- 在 Notit 打开我的 → 集成 → MCP,开启 MCP 开关,并等待令牌签发完成。
- 打开详细设置,在令牌权限中选择至少一项所需的读取权限。MCP 开启时,更改权限会自动签发新令牌。
- 在 AI 应用中添加远程 MCP 服务器。使用 Notit 的复制 endpoint按钮,填入以下地址。
https://mcp.notit.ai/mcp
- 在 Notit 中选择复制认证 header,将复制的内容填入客户端的 HTTP 认证设置。如果手动输入,请将下面的占位符替换为已签发的令牌。
Authorization: Bearer <已签发的令牌>
- 如果请求头名称和值分开填写:名称为
Authorization,值为Bearer <已签发的令牌>。 - 如果有专用的 Bearer token 输入框:只输入令牌,不要添加
Bearer前缀。
- 保存设置并连接,然后进行第一次提问。
请将令牌填入客户端的认证设置,不要发送到 AI 对话中。查看 Notit 中显示的过期时间。更改权限等操作签发新令牌后,请同步更新客户端保存的认证信息。
检查连接并开始提问
先问:“显示我在 Notit 中的课程列表。”显示实际课程后,再选择具体课程和课堂记录继续提问。
- 从课程列表中选择一门课程。
- 例如询问:“显示热力学课程的课堂记录列表。”
- 指定课堂名称或日期,让助手读取笔记或总结转录。
请将示例中的课程名称和日期换成您自己的资料。查询课程与课堂记录列表分别需要对应的读取权限,使用笔记或转录也需要相应权限。服务器显示“已连接”并不代表已经可以读取学习数据。
权限与可用资料
| 读取权限 | 可用信息 |
|---|---|
读取课程course:read | 您的课程列表、单门课程详情,以及当前或下一节课的安排 |
读取课堂记录lecture:read | 某门课程下的课堂记录列表及单次课堂详情 |
读取笔记note:read | StudyPack、已生成的笔记、完整 Markdown 笔记,以及单个 StudyPack 内的搜索 |
读取转录transcript:read | 某次课堂的转录、转录搜索,以及已生成的摘要和关键词 |
读取考试重点exam_point:read | 考试重点及来源笔记信息,以及 StudyPack Quick Review |
Notit 仅提供您已批准权限对应的工具,并检查资料是否属于登录账户。MCP 连接无法创建、修改或删除 Notit 数据。搜索工具在特定课堂或 StudyPack 内运行,不会一次搜索所有课程。
AI 读取的资料会传递给连接的 AI 服务,并适用该服务的数据处理政策。连接时请取消您不想授予的读取权限。
问题排查
登录或认证失败
确认服务器地址是 https://mcp.notit.ai/mcp。如果 OAuth 授权请求已过期,请从 AI 应用重新发起连接。使用手动令牌时,请检查请求头名称、Bearer 后的空格,以及令牌是否完整。
手动令牌已过期
在 Notit 的 MCP 详细设置中查看过期时间。关闭 MCP 后重新开启即可签发新令牌。确认所需权限,将新认证信息保存到客户端,再重新连接。
缺少工具或权限不足
在权限表中确认所需权限。OAuth 连接请先断开,再选择所需权限重新连接。手动令牌请更改令牌权限,并将新签发的认证信息更新到客户端。随后刷新客户端的连接或工具列表。
已经连接,却提示需要升级套餐
所有套餐都可以连接并查看工具列表,但读取学习数据需要 Plus 或 Pro。请检查所连接 Notit 账户的套餐。升级后重新发送请求即可。
找不到课程或学习资料
确认连接的是正确账户,且资料在 Notit 应用中可见。提供具体的课程名称、课堂名称或日期。如果笔记或转录仍在生成,请等待处理完成后重试。如果没有下一节课,也请检查 Notit 中保存的上课安排。
断开连接
OAuth 连接
在 Notit 打开我的 → 集成 → MCP → 详细设置 → 已连接的应用,为对应应用选择断开连接。这会停止通过该 OAuth 连接进行新的数据访问。您也可以移除 AI 应用中保留的服务器设置。
手动令牌连接
在 AI 应用中移除 Notit MCP 服务器及保存的令牌或认证请求头。如果多个客户端使用了同一个令牌,请逐一移除。不要将关闭 MCP 开关或签发新令牌视为现有令牌立即失效。
OAuth 连接与手动令牌分别管理。结束其中一种连接不会同时结束另一种连接。
获取帮助
请访问 Notit 客户支持,或发送邮件至 help@metaplad.com。请说明使用的客户端、连接方式和错误信息,不要发送令牌。
