MCP 使用指南

Get 笔记 MCP 使用指南

适用于支持 MCP（Model Context Protocol） 协议的 AI 工具，如 Claude Desktop、Cursor、Windsurf 等。

---

第一步：安装 MCP 包

确保电脑已安装 Node.js（v18+），然后在终端执行：

npm install -g @getnote/mcp

验证安装成功：

npx @getnote/mcp --version

---

第二步：配置到 AI 工具

Claude Desktop

编辑配置文件（Mac 路径）：~/Library/Application Support/Claude/claude_desktop_config.json

添加以下内容（授权模式，推荐）：

{
  "mcpServers": {
    "getnote": {
      "command": "npx",
      "args": ["-y", "@getnote/mcp"]
    }
  }
}

保存后重启 Claude Desktop，左下角出现 🔨 图标说明配置成功。

Cursor

在 Cursor 设置中搜索 MCP，点击 Add MCP Server，填入：

• Name：getnote
• Command：npx -y @getnote/mcp

---

第三步：授权登录（推荐）

首次使用时，在对话框里说：

请帮我授权 Get笔记

MCP 会自动打开浏览器，用 Get 笔记账号登录完成授权，无需手动填写 API Key。

💡 授权模式更安全、更简单，推荐所有用户使用

---

使用示例

授权完成后，直接对话：

帮我把这段话保存到 Get 笔记：今天学到了一个新概念...

搜索一下我 Get 笔记里关于"机器学习"的内容

帮我查看最近 10 条笔记

把这个链接保存到笔记：https://example.com

---

支持的工具列表

工具名	功能
save_note	保存文本/链接/图片/分享链接
get_note	获取笔记详情
list_notes	查看笔记列表
search_notes	语义搜索笔记
update_note	更新笔记内容
delete_note	删除笔记
share_note	生成笔记分享链接
list_topics	查看知识库列表
add_to_topic	笔记加入知识库

---

注意事项

• Node.js 版本：需要 v18 或以上，可执行 node --version 确认
• 重启生效：修改配置后必须重启 Claude Desktop / Cursor
• 会员要求：需要 Get 笔记会员账号
• 授权失效：重新说"请帮我授权 Get笔记"即可

---

手动配置（高级）

如果你希望手动指定 API Key，在配置文件中加入环境变量：

{
  "mcpServers": {
    "getnote": {
      "command": "npx",
      "args": ["-y", "@getnote/mcp"],
      "env": {
        "GETNOTE_API_KEY": "gk_live_你的key",
        "GETNOTE_CLIENT_ID": "cli_你的clientid"
      }
    }
  }
}

API Key 和 Client ID 在 Get 笔记开放平台 创建应用后获取。

---

版本信息

• 当前版本：1.3.1
• npm：https://www.npmjs.com/package/@getnote/mcp
• GitHub：https://github.com/iswalle/getnote-mcp