讓 AI 智慧體使用公司知識庫，並留下它的每一次修改

AI 智慧體（agent）趁晚上整理了一遍新人報到指南。隔天新同事照著做，卻連不上 VPN：有一步指向去年就停用的伺服器。馬上有兩個問題：智慧體改了什麼？能不能只撤回那一處，保留其餘的整理？

知識庫答不出這兩題，讓智慧體寫入就是賭運氣。

智慧體需要的，和公司需要的

智慧體需要存取：找得到、讀得到正確的文件，有時還要能改。公司需要問責：每次修改都有紀錄，人能審閱、能撤回。

多數做法只解決前者。搜尋索引讓智慧體能讀，wiki 的 API 讓它能寫；但 wiki 的頁面歷史沒有分組，想撤回一次修改，只能手動再改一遍。

為什麼是 Git

Git 本來就是為「很多人改同一批檔案」設計的，記錄的正是公司想知道的：

每次修改是一次提交（commit），有作者、時間與說明；
一次提交可以包含多個檔案，一件工作就是一次修改；
diff 列出改了哪幾行；
revert 撤回一次提交，其他歷史不動；
分支與 pull request 讓人先審，修改才算數。

智慧體也擅長處理檔案，Markdown 組成的知識庫本來就是它會讀、會改的東西。

MCP：智慧體怎麼碰到儲存庫

MCP（Model Context Protocol）是讓 AI 應用程式連接工具與資料的開放標準。 MCP 伺服器提供工具，任何 MCP 用戶端都能呼叫，不論是聊天助理還是寫程式的智慧體。

透過 MCP 開放的知識庫，會給智慧體這些工具：

列出筆記本與筆記；
依主題搜尋，讀整則筆記或只讀 frontmatter；
新增、編輯、移動或刪除筆記，每次修改都提交。

智慧體不必會下 Git 指令，伺服器會把編輯變成提交。

用 MyGitNotes 設定

一、把知識放進儲存庫。 寫成 Markdown 筆記，依筆記本分組，放在公司自己的儲存庫。既有的 Markdown 文件直接提交進去。

二、決定伺服器在哪裡執行。 app.mygitnotes.com 替儲存庫提供 Streamable HTTP 的 MCP 端點，給 ChatGPT connector 這類遠端用戶端。開源版可以在你的電腦上以 stdio 執行同一個伺服器，搭配本機 checkout，給 Claude Desktop 或 Codex。也可以自架開源版，讓端點留在公司網路內。

三、每個智慧體各自授權。 只回答問題的給唯讀，負責維護文件的少數幾個才給寫入。每個授權都能單獨撤銷。

四、智慧體的指示也放進儲存庫。 哪些筆記本可以改、提交訊息怎麼寫，寫成檔案放在同一個儲存庫，一樣有版本，智慧體也讀得到。

五、看歷史。 智慧體的每次修改都是歷史裡獨立的一次提交。讀它的 diff，改錯了就 revert。

值得有的防護

人和智慧體會同時寫入，寫入就得小心。在 MyGitNotes，每次寫入會帶上智慧體最後讀到的版本；筆記之後被改過，寫入就會被拒絕，不會悄悄蓋掉較新的修改。筆記本以外的路徑也會被拒絕，更新分支時不會 force push。

這套做法解決不了的事

提交記錄的是改了什麼，不是改得對不對。重要的文件，還是得有人讀歷史。智慧體送給模型供應商的內容，會依那家供應商的條款離開你的掌控；自架能讓知識庫留在公司網路內，但模型的輸入不在此限。

開頭那個 VPN 步驟，在這套做法下是五分鐘的事：找到智慧體的提交，讀 diff，然後 revert，或只改正那一行。

公司怎麼導入，請見 AI 智慧體頁面。