连接 AI 助手（MCP）

MCP（模型上下文协议）可以让 Claude 这样的 AI 助手直接将 Mikipage 作为工具使用。连接后，你可以在对话中说“将这个保存到 Mikipage”或“刷新我的所有页面”，然后这些操作就会完成。

如果你已经为助手付费，这是使用 Mikipage AI 的推荐方式，因为你的助手会使用现有订阅进行思考，不会消耗任何 Mikipage AI 积分。请参阅[1]，了解这与在网站上运行 AI 的区别。

设置

连接 URL 是：

https://mikipage.com/mcp

大多数客户端只需要这些信息。助手首次连接时会通过浏览器登录——你会被转到 Mikipage，批准连接后返回。无需生成 API 密钥，也无需粘贴或轮换令牌。

Claude（网页版或桌面版）

打开 设置 → 连接器。
选择 添加自定义连接器。
将其命名为 mikipage.com。
远程 URL：https://mikipage.com/mcp。
保存，然后点击连接，并在浏览器打开时批准登录。

Claude Code

claude mcp add --transport http mikipage https://mikipage.com/mcp

其他客户端

Mikipage 通过支持 OAuth 的可流式 HTTP 提供 MCP，包括动态客户端注册——因此任何兼容的客户端都应该只凭上面的 URL 连接，无需其他配置。

你的助手可以做什么

连接后，助手会拥有以下工具：

笔记——创建、读取和更新笔记；将笔记分享到群组或移除分享；以及对笔记进行语义搜索，并按群组、日期范围、星标、归档状态和标签进行筛选。

页面——创建、读取、更新和搜索页面。更重要的是，它可以写入页面的结果，这正是实现 AI 端页面生成的关键。

关联——从任一方向核对哪些笔记属于哪些页面，添加和移除链接，并将项目标记为已匹配，使其不再显示为过期。

它自行执行的 AI 运行——对于不只是读写的工作，助手会向 Mikipage 请求提示词，并在自己的模型上回答。这包括分析页面（生成页面摘要、搜索计划、是否需要侧边栏，以及如何获取笔记）、分析笔记（笔记标题、摘要，以及 Graph 视图所绘制的具名人物、地点和事物），以及构建页面侧边栏。这些提示词与网站运行的提示词相同——助手不会自行编造——因此，完全通过 MCP 维护的页面最终会与在网站上刷新的页面处于相同状态。

它定位所需的其他一切——列出你的群组，并读取你的个人资料、时区、使用量统计，以及用于使其输出与网站保持一致的页面生成指南。

它有意无法执行的操作

删除任何内容。 不能删除笔记，也不能删除页面。删除不可逆，而一个误解了“清理我的旧笔记”的助手可能会一次性清除大量内容。删除仍然需要由你自己在网站上或通过 API 完成。
更改账户设置。 它可以读取你的个人资料、时区和使用量统计，但编辑这些内容需要在网站上完成。
管理群组或成员。 创建群组和邀请人员需要在网站上完成。
读取或写入文件内容。 它只能看到附件的元数据。文件字节会以很小的收益淹没对话上下文——请改为在笔记文本中描述附件（见[2]）。
发布评论。 评论是一种即时的小型社交行为，应当在网站上完成。

实际可以提出什么请求

“刷新我的所有页面”

这是最主要的用途。你的助手会询问 Mikipage 哪些内容已过期，获取需要完成的工作并逐项处理：对于每条发生变化的笔记，查找它现在所属的页面；对于笔记发生变动的页面，查找相关笔记；然后重新生成需要重写的页面，并附上返回来源的引用。它会重复执行，直到没有任何内容过期。

关于这个循环，有两点值得了解：

先进行分析。 在匹配或重新生成任何内容之前，助手会重新分析分析状态已过期的页面和笔记。这会清除“需要刷新”标记，也会生成匹配步骤随后使用的搜索计划——因此，MCP 刷新搜索的内容与网站搜索的内容相同。
这是迭代式的。 向页面添加笔记会将该页面标记为需要重新生成，因此助手会继续发现新的工作。它会持续运行，直到所有内容都处理完毕——你可能会看到它循环多次。

添加“包括我的群组”，它就会在处理完你的个人空间后，对每个群组执行相同的流程。

如果你希望现在就让所有内容保持最新，这种方式非常理想。若要按计划保持页面更新，ai_refresh.py 脚本可以用少得多的令牌执行相同的扫描。请参阅[1]。

“更新此页面”

范围更小，通常也更有用：助手会读取一个页面及其关联笔记，按照该页面的说明综合生成新版本，并附上引用写回页面。适合你刚添加了一些笔记，想让某个页面保持最新的情况。

“将这个保存到 Mikipage”

在对话中途进行捕获。需要注意的是，以这种方式创建笔记不会启动任何匹配操作——笔记会被保存，并在下次刷新时处理。

“我的笔记中关于……是怎么说的？”

你的助手可以搜索整个笔记库，并基于找到的内容进行推理，使用你的笔记作为当前对话中正在处理事项的可靠上下文。

费用

Mikipage 不收取任何费用。模型调用由助手自身的订阅支付。这也是为什么即使 AI 积分余额为零，MCP 驱动的刷新仍然可以继续运行。