MCP 协议 — 连接外部工具和服务
MCP 是什么
MCP 是 Model Context Protocol 的缩写，一个让 AI 模型连接外部工具和服务的开放协议。有了 MCP，NoteGen 的 Agent 可以：
- 查数据库、执行 SQL
- 调 API 获取实时数据
- 执行代码
- 控制浏览器自动化
- 搜索网络内容
- 操作文件系统
- 调用各种第三方服务
两种 MCP 形态
| 形态 | 说明 | 支持平台 |
|---|---|---|
| HTTP MCP | 连接远程 MCP 服务，通过 HTTP/SSE 通信 | 桌面端 + 移动端 |
| stdio MCP | 本地启动命令行程序，通过标准输入输出通信 | 仅桌面端（需要本地运行时） |
移动端只支持 HTTP MCP。如果看到某个 MCP 需要 node/python 环境启动，那是 stdio 类型，移动端用不了。
配置 MCP
在设置中打开 MCP 配置面板：
- 添加新的 MCP 服务器
- 选择 HTTP 或 stdio 类型
- HTTP 类型填服务器地址和鉴权信息
- stdio 类型填启动命令和参数（如
npx @modelcontextprotocol/server-filesystem /path/to/dir） - 测试连接
- 连接成功后，在 AI 对话/Agent 工具栏中启用
常见 MCP 服务器
一些热门的 MCP 服务器配置示例：
文件系统
{
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "F:/my-notes"]
}GitHub
{
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "你的 Token" }
}命令行执行
{
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-shell"]
}安全注意
- 不要从不可信来源导入会执行本地命令的 MCP 配置
- stdio MCP 可以启动本机程序——只连接你完全信任的服务器
- 定期检查已启用 MCP 的连接状态，不再需要的及时关闭
- MCP Bearer Token 应按工作区访问凭证保护
环境变量和 JSON 格式
MCP 配置中的环境变量和请求头必须是有效 JSON。常见错误：
- 引号没转义
- 逗号多了或少了
- 布尔值写成了字符串
NoteGen 的 MCP 配置面板会做 JSON 校验，格式错误时会提示。