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。請說明使用的用戶端、連線方式和錯誤訊息,不要傳送權杖。
