API

除了通过用户界面进行操作外，你还可以通过 API 来访问和操作 WonderPen 中的内容。

注：API 接口自桌面版 v3.1.3 开始支持。

开启

API 接口默认是关闭的，你可以在设置窗口 → 高级 → API 处开启。如下图所示：

API 服务会在本机启动一个 HTTP 服务，这个服务只监听 127.0.0.1 IP，只有本机可见，不用担心接口被局域网内的其他人访问。

全部设置如下所示：

你可以指定 API 服务的端口，或者重设（重新生成）API Token。

MCP 服务

MCP 的全名是 Model Context Protocol，作用是让 AI 应用连接外部系统。

WonderPen 没有内置 AI 服务，但集成了 MCP 接口，你可以使用支持 MCP 的本地 AI 应用访问和操作 WonderPen 中的数据。

简单来说，就是 WonderPen 开放了接口，让第三方 AI 应用可以访问 WonderPen 中的内容。

开启 API HTTP 服务之后，MCP 服务也会同时启动，默认设置下，你可以使用 http://127.0.0.1:8022/mcp 来访问 WonderPen 的 MCP 服务，类型是可流式传输的 HTTP (streamableHttp)。

多数情况下，添加 MCP 服务时还需要添加一个请求头用于验证身份，内容形如 Authorization=Bearer wp-xxx，其中的 wp-xxx 即是上面截图中的 API Token。

CLI

除了 MCP 接口，WonderPen 还支持更通用的 CLI 接口，即命令行接口。

你可以运行示例命令，查看帮助信息，帮助信息中包含了各命名的使用说明。