如何在 Claude Code 安裝 MakeClass MCP

一行指令加一次登入，在終端機直接查、讀、寫你的 MakeClass 筆記

使用 ChatGPT 或 Codex？請看〈For ChatGPT / Codex 用戶：安裝 MakeClass MCP〉。

裝上 MakeClass MCP 後，可以直接在 Claude Code 裡用一句話查、讀、寫你在 MakeClass 的筆記，不必切換到瀏覽器。安裝只要一行指令加一次登入。 MakeClass MCP 能做什麼

工具 用途 可以這樣問 --- --- --- listmynotes 依時間倒序列出自己的筆記 「列出我最近 5 篇筆記」 searchnotes 語意搜尋自己或全站公開的筆記 「我之前有沒有寫過 Redis 佇列？」 readnote 讀取單篇筆記的摘要、重點與正文 「打開那篇 MIT 提問策略」 createnote 建立新文章，預設為草稿 「把剛才的解法存成 MakeClass 文章」 updatenote 修改自己文章的標題、正文或觀點 「幫那篇補一段心得」 listmychannels 列出可發布的頻道 「我有哪些頻道？」 collectskill 把工具或 Skill 收進自己的 Skill 庫 「收藏這個 Skill」 事前準備 Claude Code：已安裝且能在終端機執行 claude。建議更新到最新版，較新的版本在連線失敗時會顯示錯誤碼，比較好除錯。 MakeClass 帳號：能登入 makeclass.me，安裝時會跳出瀏覽器請你授權。 MakeClass MCP 網址：https://makeclass.me/mcp。 注意：如果你已經在 claude.ai 網頁版連接過 MakeClass，而且 Claude Code 是用同一個 claude.ai 帳號登入，claude.ai 的連接器會自動出現在 Claude Code。先在 Claude Code 裡輸入 /mcp，看到 MakeClass 就不必再裝。用 API key 或 Bedrock 等第三方平台登入時，這條捷徑不會生效。 安裝步驟 加入伺服器。 在終端機（不是 Claude Code 裡面）執行 claude mcp add --transport http --scope user makeclass https://makeclass.me/mcp，看到 Added ... 就代表設定已寫入。 登入授權。 進入 Claude Code 後輸入 /mcp，選 makeclass，瀏覽器會開啟 MakeClass 授權頁，登入並同意即可。也可以直接在終端機跑 claude mcp login makeclass。 確認狀態。 執行 claude mcp list，makeclass 顯示 ✔ Connected 就完成了。

--scope 決定這個伺服器在哪些專案可用：

Scope 作用範圍 存放位置 適合 --- --- --- --- user 你所有專案 /.claude.json 個人隨處都想用 MakeClass（推薦） local（預設） 只有目前專案，只有你 /.claude.json 只在某個專案試用 project 目前專案，團隊共用 專案根目錄 .mcp.json 整個團隊都要用，檔案進版控

用 project scope 時，團隊成員第一次開啟專案會被要求核准這個伺服器，每個人還是要各自登入 MakeClass。

資料來源：Claude Code MCP 官方文件 驗證：跑第一個提示詞

在 Claude Code 裡輸入 /mcp，makeclass 旁邊會顯示工具數量。接著直接用一般話問：

Claude Code 會呼叫 listmynotes，回傳每篇的標題、狀態（草稿、已核准、已發布）、可見度與連結。第一次呼叫時會跳出權限詢問，按允許即可。

其他好用的問法：「搜尋我寫過關於 BullMQ 的筆記」會呼叫 searchnotes；「把剛才解決的 bug 整理成 MakeClass 文章」會呼叫 createnote，文章會停在草稿，要自己到 review 頁按發布。 進階：用 /mcpost 把對話存成 DevLog

MCP 讓 Claude Code 能讀寫筆記；mcpost 則把開發對話裡的「為什麼這樣做」整理成 DevLog，送進 Vibe Coding 專區。兩者可以並用。

之後在 Claude Code 說「這段記下來」或輸入 /mcpost，它會寫出 DevLog 檔、先跑 mcpost devlog <檔案> --dry-run 掃機密並預覽，確認後才送出。送出的文章一律是草稿加 unlisted，公開與否由你自己決定。 常見問題

狀況 解法 --- --- ! Needs authentication 還沒完成 OAuth 登入，跑 /mcp 或 claude mcp login makeclass MCP server makeclass already exists 同一個 scope 已有同名伺服器，先 claude mcp remove makeclass 再重加 /mcp 裡 MakeClass 標示為 hidden 手動加的伺服器與 claude.ai 連接器指向同一網址，擇一保留即可 ✘ Failed to connect 用 claude mcp get makeclass 看 Issue 欄的 HTTP 狀態碼 SSH 遠端機器沒有瀏覽器 用 ssh -t 連線後跑 claude mcp login makeclass --no-browser，把網址貼到本機開啟 安全注意事項 token 不要貼進對話：mck 開頭的 MakeClass 權杖一旦進了對話紀錄就等於外洩，只在自己的終端機輸入。 .mcp.json 不要放密碼：project scope 的設定會進版控，只放網址，讓每個人走自己的 OAuth。 發文前先看過：createnote 建立的是草稿，公開發布一律由人到 review 頁按下。 撤銷授權：在 /mcp 選 Clear authentication，或跑 claude mcp logout makeclass。