給開發者的 MCP 伺服器

Caliu 附帶一個 MCP（Model Context Protocol）伺服器，讓 AI 代理程式可以搜尋、閱讀、建立和更新你的筆記，上傳並讀取圖片和檔案，以及瀏覽你的標籤。它提供 13 個聚焦的工具，而不是把每一個 API 端點都照搬一遍。如果想連接 Claude、ChatGPT 或其他聊天助理，「Caliu 與 AI」一節裡有逐步教學。這篇文章介紹的是開發者工具。

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

遠端端點是 https://api.caliuapp.com/mcp（Streamable HTTP）。不必複製任何金鑰：用戶端會把你帶到一個授權畫面，你在那裡登入 Caliu 並核准存取。已核准的用戶端會出現在網頁版使用者選單的已連接的應用程式底下，你隨時可以在那裡撤銷它們。

在 Claude Code 中：

claude mcp add --transport http caliu https://api.caliuapp.com/mcp

在 Cursor（~/.cursor/mcp.json）以及其他讀取 mcpServers 設定的用戶端中：

{
  "mcpServers": {
    "caliu": {
      "url": "https://api.caliuapp.com/mcp"
    }
  }
}

在 VS Code（.vscode/mcp.json）中：

{
  "servers": {
    "caliu": {
      "type": "http",
      "url": "https://api.caliuapp.com/mcp"
    }
  }
}

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

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

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

代理程式只要寫 Markdown 就好

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