一木笔记使用手册

AI 工具配置方法

各 AI 工具只需填写服务器地址与令牌两项。令牌的获取方法见「MCP 连接」。

通用配置

Cursor、VS Code、Cherry Studio 及多数支持远程 MCP 的工具使用以下配置，将 粘贴你的令牌 替换为实际令牌：

{
              "mcpServers": {
                "yimu-note": {
                  "type": "streamable-http",
                  "url": "https://yimunote.com/mcp",
                  "headers": {
                    "Authorization": "Bearer 粘贴你的令牌"
                  }
                }
              }
            }
注意

Bearer 与令牌之间必须有一个空格。使用应用中的「复制配置片段」可避免填写错误。

各工具的配置位置：

工具 粘到哪里
Cursor Settings → MCP → Add new MCP server，保存后重启
VS Code 项目根目录新建 .vscode/mcp.json
Cherry Studio 设置 → MCP 服务器 → 添加服务器 → JSON 导入，然后在列表里打开它。要连最外层的 mcpServers 一起粘，还要选一个支持工具调用的模型
Windsurf 等 各自的 MCP 设置页。个别工具的 type 要写成 streamableHttp 或 http，按它自己的文档改那一个字段，地址和请求头不变

Claude Code（命令行）

在终端中执行：

claude mcp add --transport http yimu-note https://yimunote.com/mcp \
              --header "Authorization: Bearer 粘贴你的令牌"

在对话中输入 /mcp，确认 yimu-note 已连接。

ChatGPT 桌面客户端 / Codex

两者共用同一份配置文件。

  1. 打开配置文件

    Windows 用记事本打开 %USERPROFILE%\.codex\config.toml；macOS 在终端执行 open -e ~/.codex/config.toml。文件不存在就新建。

  2. 在末尾加上这一段

    [mcp_servers.yimu-note]
            url = "https://yimunote.com/mcp"
            http_headers = { Authorization = "Bearer 粘贴你的令牌" }

    如已存在 [mcp_servers.yimu-note]，修改原有配置，不要重复添加。

  3. 重启客户端

    完全退出再打开，在设置 → MCP 服务器里确认 yimu-note 已开启。

重要

令牌以明文保存在配置文件中，请勿上传到网盘或代码仓库。怀疑泄露时，在应用中注销该连接并重新创建。

Claude 桌面版 / 网页版

Customize → Connectors，右上角 + 添加自定义连接器，名称填「一木笔记」，地址填服务器地址。

注意

Claude 自定义连接器默认使用浏览器授权，一木笔记目前仅支持令牌方式。界面中无法填写请求头时，请改用 Claude Code 命令行或其它可填写请求头的工具。

豆包工作 / WorkBuddy 这类国内工具

在「自定义连接器」中按以下内容填写：

服务器名称 yimu-note
传输类型 HTTP（或 streamable-http）
服务器 URL https://yimunote.com/mcp
自定义 Header 名称 Authorization
自定义 Header 值 Bearer + 令牌

验证

配置完成后，按「MCP 连接」中的「验证连接」进行测试。无法连接时的排查方法见同一页。