用 MCP 连接 AI 智能体

Caliu 附带一个 MCP（Model Context Protocol）服务器，因此像 Claude Desktop、Claude Code、Cursor 和 Windsurf 这样的 AI 智能体可以搜索、阅读、创建和更新你的笔记，管理提醒，以及浏览你的标签。它提供 12 个聚焦的工具，而不是照搬每一个 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 并批准访问。已批准的客户端会出现在网页应用用户菜单的已连接的应用下，你可以随时在那里吊销它们。

智能体只需写 Markdown

这里刻意没有标签管理工具。Caliu 中的标签由笔记内容里的 #hashtags 派生而来，因此一个在笔记里写下 #work/ideas 的智能体，其实已经给它打好了标签。两种方式运行的是完全相同的工具。

用 MCP 连接 AI 智能体 · Caliu Help