MCP 配置

MCP（Model Context Protocol）让 NoteGen 通过统一协议调用外部工具和资源。启用 MCP 不会自动授权所有服务器；还需要启用服务器并在对话中选择它。

连接类型

本地命令（stdio）

仅支持桌面端。填写命令、空格分隔的参数和 JSON 格式环境变量，例如：

{
  "API_KEY": "your-key"
}

命令字段可直接填写 npx @modelcontextprotocol/server-filesystem，NoteGen 会在参数字段为空时拆分第一个命令和后续参数。

HTTP 服务

桌面端和移动端都支持。填写服务 URL，以及可选的 JSON 请求头：

{
  "Authorization": "Bearer your-token"
}

移动端不能启动本机 stdio 进程，因此新建服务器时只提供 HTTP 类型。

添加与导入

• 点击“添加服务器”，填写名称、类型和连接参数。
• 可关闭单个服务器而不删除配置。
• “导入 JSON”支持常见的 mcpServers 配置结构；重复服务器会被跳过。
• 保存前可测试临时配置，保存后启用的服务器会自动尝试连接。

运行时环境

本地命令常依赖 Node.js、Python、uv 或其他启动器。使用“检查环境”查看版本和缺失项；支持的平台可以在确认命令后执行引导式安装。安装输出会显示在日志中，也可以中途终止。

工具浏览与使用

连接成功后，工具浏览器会显示服务器提供的工具、描述和参数。打开 Chat/Agent 工具栏中的 MCP 按钮，选择要用于当前会话的服务器。Agent 调用工具时仍会遵循权限确认规则。

让其他客户端访问 NoteGen

桌面端 MCP 设置包含“访问 NoteGen”标签页。启用后，NoteGen 会在 127.0.0.1 启动本地 Streamable HTTP MCP 服务，让 Claude Desktop、Codex 或其他兼容客户端操作当前工作区。

1. 打开“访问 NoteGen”并启用服务。
2. 保留默认端口，或选择 1024–65535 之间未被占用的端口。
3. 点击连接/复制配置。NoteGen 会生成包含本地 URL 和 Bearer Token 的 JSON。
4. 将配置添加到目标客户端，并重新加载其 MCP 连接。

服务只监听本机地址，默认端口为 37422。连接配置中的 Token 等同于当前工作区访问凭证，不要粘贴到公开对话或 Issue。怀疑泄漏时使用“重置访问 Token”，并更新所有客户端。

本地 MCP 的操作范围以设置中显示的当前工作区为准。切换工作区后，先确认服务显示的新范围，再允许外部客户端继续执行写入或删除。

安全

• 本地命令能以当前用户权限运行程序，只使用可信配置。
• 环境变量和请求头可能包含密钥，不要截图或公开导出配置。
• 只给远程 MCP 发送完成任务所需的最少上下文。
• 删除服务器不可撤销，但不会自动撤销第三方服务中的 Token。
• “外部服务器”让 NoteGen 调用别人提供的工具；“访问 NoteGen”方向相反，不要混淆两者的权限边界。