Notit MCP 連線指南

將 Notit 課程與學習資料連接到 AI 助理,直接詢問課堂內容。您可以透過 OAuth 登入或手動權杖完成連線。

開始前的準備

MCP 是讓 AI 應用程式連接外部資料和工具的開放標準。連接 Notit 後,AI 助理可以讀取您授權的學習資料,並用於回答問題。更多資訊請參閱 MCP 官方介紹

  • Notit 帳戶與學習資料:登入您要使用的帳戶,確認需要查詢的課程、課堂紀錄和筆記已儲存在 Notit 中。
  • 相容的用戶端:需要支援遠端 HTTP MCP 伺服器,以及 OAuth 登入或自訂驗證標頭的 AI 應用程式。設定選單名稱和使用條件因用戶端而異。
  • Notit 方案:所有方案都可以連線,但透過 MCP 讀取學習資料需要 Plus 或 Pro查看 Notit 方案

應該選哪種方式?如果用戶端會開啟 Notit 登入頁面,請使用 OAuth。如果需要手動輸入權杖或 HTTP 驗證標頭,請按照手動權杖步驟操作。

透過 OAuth 連線 · 建議

登入 Notit 並核准讀取權限即可。無須簽發手動 MCP 權杖,也無須開啟 Notit 中的 MCP 開關。

  1. 在 AI 應用程式中開啟新增遠端 MCP 伺服器的設定。如果需要名稱,請輸入 Notit
  2. 輸入以下伺服器位址並開始連線。
https://mcp.notit.ai/mcp
  1. Notit 登入頁面開啟後,登入儲存了學習資料的帳戶。
  2. 確認發出請求的用戶端與回呼主機,然後選擇至少一項讀取權限。各權限的用途見權限表
  3. 選擇連線並返回 AI 應用程式。在對話中選擇或啟用 Notit 工具。

嘗試第一次提問,確認能夠讀取資料。您可以在 Notit 的我的 → 整合 → MCP → 詳細設定 → 已連線的應用程式中查看 OAuth 連線。

透過手動權杖連線

此方式適用於支援自訂 HTTP 驗證標頭或 Bearer 權杖的用戶端。

  1. 在 Notit 開啟我的 → 整合 → MCP,開啟 MCP 開關,並等待權杖簽發完成。
  2. 開啟詳細設定,在權杖權限中選擇至少一項所需的讀取權限。MCP 開啟時,變更權限會自動簽發新權杖。
  3. 在 AI 應用程式中新增遠端 MCP 伺服器。使用 Notit 的複製 endpoint按鈕,填入以下位址。
https://mcp.notit.ai/mcp
  1. 在 Notit 中選擇複製驗證 header,將複製的內容填入用戶端的 HTTP 驗證設定。如果手動輸入,請將下面的預留文字替換為已簽發的權杖。
Authorization: Bearer <已簽發的權杖>
  • 如果標頭名稱和值分開填寫:名稱為 Authorization,值為 Bearer <已簽發的權杖>
  • 如果有專用的 Bearer token 輸入欄位:只輸入權杖,不要加上 Bearer 前綴。
  1. 儲存設定並連線,然後進行第一次提問

請將權杖填入用戶端的驗證設定,不要傳送到 AI 對話中。查看 Notit 中顯示的到期時間。變更權限等操作簽發新權杖後,請同步更新用戶端儲存的驗證資訊。

檢查連線並開始提問

先問:「顯示我在 Notit 中的課程清單。」顯示實際課程後,再選擇具體課程和課堂紀錄繼續提問。

  1. 從課程清單中選擇一門課程。
  2. 例如詢問:「顯示熱力學課程的課堂紀錄清單。」
  3. 指定課堂名稱或日期,讓助理讀取筆記或整理逐字稿重點。

請將範例中的課程名稱和日期換成您自己的資料。查詢課程與課堂紀錄清單分別需要對應的讀取權限,使用筆記或逐字稿也需要相應權限。伺服器顯示「已連線」並不代表已經可以讀取學習資料。

權限與可用資料

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

Notit MCP 整合說明 · 隱私權政策