Mcp

Notedeep MCP

Notedeep MCP 让 Codex 等 MCP 客户端安全调用 Notedeep 在线能力。

连接

服务地址：
https://www.notedeep.com/webapi/mcp
在 MCP 客户端添加该地址后，按提示打开浏览器，登录 Notedeep 并确认授权。客户端会自动管理后续凭证，无需手动创建 API Key。

当前功能

当前仅支持图片直传，不支持读写页面、管理目录、搜索知识库或上传非图片附件。
  • 支持 JPEG、PNG、GIF、WebP，单张不超过 10 MiB。
  • 上传前校验当前用户是否拥有目标 workspace。
  • 成功后返回可直接写入 Notedeep Markdown 的完整图片 URL。

图片上传流程

上传必须按以下顺序完成：
  1. 从本地知识库根目录 `.notedeep/manifest.json` 读取真实 `workspaceUuid`。
  2. 调用 `create_image_upload`，传入 `workspaceUuid`、文件名、MIME 类型和精确字节数。
  3. 使用返回的 `uploadUrl` 以 `multipart/form-data` 直传图片，字段为 `token`、`key`、`file`。
  4. 调用 `complete_image_upload`，传入 `uploadId`，取得最终 URL。
`uploadToken` 是一次性临时凭证，不应写入日志、文档或笔记。图片未完成上传前，也不能在 Markdown 中引用本地路径或相对路径。

与 Notedeep Skill 配合

建议同时安装 Notedeep Skills。Skill 负责识别本地知识库结构、生成 Notedeep Markdown，并在插入本地图片时调用 MCP 上传，再把返回的 URL 写入笔记。