面向开发者的 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 会自动把它转换成真正的笔记链接。两种方式运行的是完全相同的工具。