← AI 寫程式記憶實用指南

指南

怎麼幫 Claude Code 加記憶 MCP,並確認真的能用?

選好 MCP 連線方式與 scope,完成授權,再用實際保存與新對話讀取確認記憶可用,並排查常見問題。

作者: Cairn

更新於:

發布於:

使用 Cairn.ink Memory,先執行 npx @cairn-ink/memory setup,Cloud 提供自動保存與提問回想,Local 則在單機提供不需帳號的明確工具。其他服務依文件用 claude mcp add 加入,從 /mcp 授權。最後都要保存一筆合成記錄,再到新對話查回來。

加入之前需要準備什麼?

需要 Claude Code,以及有官方 Claude Code 或相容 MCP 接法的記憶服務。MCP 是 Model Context Protocol,讓助理呼叫其他程式或服務的工具;記憶連線要有保存脈絡的位置,也要有下次取回的方法。

先找官方文件,確認用戶端是啟動本機程序,還是連線到 HTTP 服務,再看資料保存位置、授權方式,以及保存對話需要明確呼叫,還是會自動進行。同一產品的不同模式也可能不同。

以下先用 Cairn.ink Memory安裝器,再介紹手動 HTTP 與本機 stdio 接法。Claude 指令與 scope 依官方 MCP 文件,查閱日期為 2026-11-12。

Cairn.ink Memory 安裝器怎麼用?

準備 Node 22.16 以上版本,確認選用 CLI 在執行路徑上,再執行:

npx @cairn-ink/memory setup

選 Cloud,登入 cairn.ink 後啟用自動保存與提問回想。也可以直接選定:

npx @cairn-ink/memory setup --cloud
npx @cairn-ink/memory status

安裝器會找出 Claude Code 與 Codex,詢問尚未建立的連線。兩邊都要連接時,完全關閉工具並等背景工作結束,再確認共用。第一次成對設定只需一次瀏覽器登入,記憶身分會連起同一專案。完成後重開工具;Codex 請在 /hooks 檢查四項 Cairn 設定。

想在一台電腦免費使用、不需帳號,選 Local,或執行:

npx @cairn-ink/memory setup --local

Local 提供明確工具,沒有自動保存或跨電腦同步。語意回想需要模型金鑰,保存和查看則不需要。既有安裝衝突與模式切換依安裝器 README處理。

Cloud 保存前會先在本機盡力遮蔽敏感內容,提問回想也會傳送經遮蔽、限制長度的副本,請先看隱私控制。成對安裝提供以下控制:

npx @cairn-ink/memory pause
npx @cairn-ink/memory resume
npx @cairn-ink/memory prompt-recall-off --client codex
npx @cairn-ink/memory config --codex-daily-cap 300

暫停期間的對話不補存。Codex 關閉提問回想後,保留保存與 MCP。已有當日計數時,新保存上限在下次每日重置生效。Codex 預設每天 200 次,既有安裝保留原上限,Claude 額度獨立計算。

Scope 要選哪一種?

先選 scope,它決定連線設定放在哪裡,不決定伺服器上的記憶屬於誰。

Scope適合情況設定界線
Local自己在一個專案使用私人的專案設定
Project和版本庫貢獻者共用定義版本庫 MCP 設定
User個人跨專案使用個人設定

加入命令時使用 --scope local、--scope project 或 --scope user。

Project scope 的共同定義放在: .mcp.json

每個同事各自完成授權,能讀什麼由服務判斷。個人權杖不要寫進準備提交的檔案。

私人記憶要跨版本庫使用,可以從 user scope 開始。只想在一個專案試用,可用 local。避免在多種 scope 重複加入同名項目,更細的設定可能蓋過你原本想測的那一個。

只想手動使用託管明確工具,怎麼接?

只用明確工具,可依發版 README改走手動接法:

claude mcp add --transport http --scope user cairn https://cairn.ink/api/mcp
claude mcp list
claude mcp get cairn

開啟 Claude Code,進入: /mcp

選擇伺服器的驗證選項,在瀏覽器以預期帳號完成 OAuth。回到對話,確認記憶工具可用。這條手動路徑提供明確保存、回想與遺忘;需要自動保存與提問回想,使用上面的安裝器。

若組織有管理允許的伺服器,或專案需要信任授權,先依用戶端提示處理,不要重複加入另一份定義。註冊完成後,再確認已授權的工具呼叫成功。

OAuth 和權杖差在哪裡?

OAuth 透過瀏覽器授權,讓用戶端取得存取能力,不必手動把可重複使用的秘密放進專案。本例從 MCP 面板啟動這個流程,登入的必須是你打算讀取私人 Memory 的帳號。

其他服務可能要求個人存取權杖或 API key,常見做法是放進授權標頭,或透過環境變數交給本機程序。格式與秘密保存方式要依該服務文件。權杖若屬於另一個帳號,也可能成功連上錯的儲存區。

被拒絕時,一起核對網址、帳號與驗證方式。各服務憑證放在對應端點,使用該服務支援的秘密管理方式。

本機 stdio 伺服器有什麼不同?

Stdio 指伺服器透過標準輸入和輸出交換 MCP 訊息,由 Claude Code 在本機啟動。另行查看供應商設定,確認是否呼叫線上 API。

例如 MCP reference memory server保存本機知識圖譜,文件建議選擇自己擁有的持久儲存路徑,查閱日期為 2026-11-12。先把下面的絕對路徑佔位文字換成既有、可寫入目錄裡的自有路徑:

claude mcp add --env MEMORY_FILE_PATH=/absolute/path/memory.jsonl --transport stdio --scope user memory -- npx -y @modelcontextprotocol/server-memory

-- 分隔符後面的內容交給伺服器程式。持久資料不要放在套件快取。呼叫工具時,使用實際安裝的伺服器提供的名稱。

怎麼確認真的保存,也能留到下一次?

在託管範例的 Claude Code 對話輸入:

Use remember_memory to save this in personal scope:
For the fictional Willow demo, I prefer review summaries with the conclusion first.
Show the Memory ID and Source Receipt from the tool response.

查看實際回應。Memory 是使用者的私人脈絡;Source Receipt 提供由來的摘錄與用戶端資訊,方便檢查。保留識別碼與來源,給自己比對。

開啟新 Claude Code 對話,不要複製答案,只問:

Use recall_memory to find my review-summary preference for the Willow demo.
Show the Memory ID and Source Receipt, or report no matching result.

識別碼與來源相符,就確認這次跨對話保存成功。之後要接其他工具,就再做一次跨用戶端檢查。

測試結束後,可請助理用那個確切識別碼遺忘測試記錄,再確認工具結果。遺忘會移出主動回想,儲存歷史和備份另有保留方式。Knowledge Card 有自己的審閱與人為授權發布流程。

出問題時先排查什麼?

找不到伺服器,先查 scope 和開啟 Claude Code 的目錄。本機程序起不來,查執行檔、環境與檔案權限。HTTP 失敗則查端點、網路與授權。先看實際錯誤,再決定要改什麼。

看得到工具卻找不到記憶,先確認保存真的成功,再查帳號、範圍與查詢用語。第一次用個人範圍,可以避開共用不透明專案身分的前提。先排除逾時與授權問題,再重試搜尋。

自動安裝除了明確工具,也要檢查一般對話是否保存。status 只讀本機狀態,不驗證遠端服務或 hook。

依連線指南完成所選用戶端的設定。

常見問題

MCP scope 該怎麼選?
只有你在單一專案使用可選 local,要在版本庫共用連線定義用 project,個人跨專案則用 user。
顯示已連線就代表記憶正常嗎?
還不夠。先保存合成記錄、查看實際回應,再到沒有答案的新對話查詢。
接記憶 MCP 就會自動擷取嗎?
Cairn.ink Memory 的 Cloud 安裝器會開啟自動保存與提問回想。手動 MCP 註冊只提供明確工具,Local 也使用明確工具、不自動保存。
可以把權杖放進提交的設定嗎?
不要。請使用供應商支援的秘密管理方式。本篇託管範例使用瀏覽器 OAuth,不必把權杖放進專案設定。

參考來源