用 MCP 連接 AI 代理程式

Caliu 附帶一個 MCP（Model Context Protocol）伺服器，讓 Claude Desktop、Claude Code、Cursor 和 Windsurf 這類 AI 代理程式可以搜尋、閱讀、建立和更新你的筆記，管理提醒，上傳並讀取圖片和檔案，以及瀏覽你的標籤。它提供 14 個聚焦的工具，而不是把每一個 API 端點都照搬一遍。

做法一：搭配 API 金鑰的本機伺服器

先建立一組 API 金鑰（請看 API 金鑰那篇文章），然後把下面這段加進你 MCP 用戶端的設定檔：

{
  "mcpServers": {
    "caliu": {
      "command": "npx",
      "args": ["-y", "@caliu-notes/mcp"],
      "env": {
        "CALIU_API_KEY": "caliu_your_api_key_here"
      }
    }
  }
}

做法二：搭配 OAuth 的遠端伺服器

像 claude.ai 連接器這類網頁型的用戶端，可以使用位於 https://api.caliuapp.com/mcp 的遠端端點。不必複製任何金鑰：用戶端會把你帶到一個授權畫面，你在那裡登入 Caliu 並核准存取。已核准的用戶端會出現在網頁版使用者選單的已連接的 App 底下，你隨時可以在那裡撤銷它們。

代理程式只要寫 Markdown 就好

這裡刻意沒有標籤管理工具。Caliu 的標籤是從筆記內容裡的 #hashtags 衍生出來的，所以一個在筆記裡寫下 #work/ideas 的代理程式，其實已經幫它加好標籤了。連結也一樣：在筆記裡寫下 [[Note Title]]，Caliu 會自動把它解析成真正的筆記連結。兩種做法執行的是完全相同的工具。