从 Local MCP 迁移到 Remote MCP

Remote MCP 的目标是让 Dessix 能在未打开本地 App 的情况下被 AI 客户端访问。Local MCP 仍可以继续使用，但后续推荐迁移到 Remote MCP。

迁移前后差异

项目	Local MCP	Remote MCP
运行位置	Electron 本地进程	Dessix 服务端
App 是否必须打开	是	否
认证方式	本地 App bridge	Access token
数据来源	本地 App 数据	Dessix 云端数据
工具名	`dessix_*`	`dessix_*`
函数签名	Local MCP schema	与 Local MCP 兼容

兼容原则

Remote MCP 保持已有 tool name 和 input schema：

dessix_list_workspaces
dessix_get_current_workspace
dessix_search_blocks
dessix_read_block
dessix_create_block
dessix_update_block
dessix_delete_block
dessix_restore_block
dessix_create_folder
dessix_rename_folder
dessix_move_folder
dessix_delete_folder
dessix_move_block
dessix_list_folder_children

这些工具覆盖 workspace、内容块和 folder。

迁移步骤

在 Dessix App 的 workspace settings advanced 面板创建 access token。
在 MCP 客户端中新增 Remote MCP server。
Endpoint 设置为：
text
```
https://api.dessix.io/v1/mcp
```
添加请求 header：
http
```
Authorization: Bearer dx_live_xxx
```
保持原来的 tool 调用参数不变。
用 dessix_list_workspaces 和 dessix_get_current_workspace 验证连接。
用 dessix_search_blocks 或 dessix_read_block 验证数据读取。

Workspace 规则

如果调用参数没有传 workspace_id，Remote MCP 会使用服务端记录的最近打开 workspace。用户从未创建 workspace 时，会返回 NO_WORKSPACE_SELECTED。

需要注意的行为变化

Remote MCP 不依赖当前 App 页面。
写入后内容会同步回 Dessix。
远端写入会走服务端权限校验，只能访问 token 所属用户的数据。
Folder 删除会和 Dessix App 内保持一致：目标 folder 及其子 folder 会被删除，其中的内容会进入 trash。
超长内容会被截断并返回截断标记。

回退方式

如果 Remote MCP 客户端配置暂时不可用，可以保留 Local MCP 配置作为回退。两者在迁移期可以并行存在，但推荐新配置优先使用 Remote MCP。