SonicNote MCP Server

前置要求

Node.js >= 18（下载地址）

获取 API Key

打开妙记 App
进入「我的」→「API Key 管理」
点击「创建 Key」，复制生成的 Key（格式：sk-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx）

      重要：请妥善保管你的 API Key，它等同于登录密码。后续配置 AI 助手时需要用到。
    

更新方法

如果之前安装过旧版本，先卸载再重新安装：

npm uninstall -g sonicnote-mcp-server
npm install -g sonicnote-mcp-server-1.0.1.tgz

安装

点击上方按钮下载 sonicnote-mcp-server-1.0.1.tgz
打开终端，执行安装命令：

npm install -g sonicnote-mcp-server-1.0.1.tgz

验证安装：

sonicnote-mcp-server --version

配置 AI 助手

所有配置方式均需替换 sk-your-key-here 为你在上一步获取的 MCP Key。

Claude Code

在终端中执行一条命令即可：

claude mcp add --scope user sonicnote --env MCP_API_KEY=sk-your-key-here -- npx -y sonicnote-mcp-server

Claude Desktop

编辑配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sonicnote": {
      "command": "sonicnote-mcp-server",
      "env": {
        "MCP_API_KEY": "sk-your-key-here"
      }
    }
  }
}

Cursor

Settings → MCP 中添加：

{
  "mcpServers": {
    "sonicnote": {
      "command": "sonicnote-mcp-server",
      "env": {
        "MCP_API_KEY": "sk-your-key-here"
      }
    }
  }
}

自定义后端地址

如果使用私有部署，额外设置 BACKEND_BASE_URL：

{
  "mcpServers": {
    "sonicnote": {
      "command": "sonicnote-mcp-server",
      "env": {
        "MCP_API_KEY": "sk-your-key-here",
        "BACKEND_BASE_URL": "https://your-server.com"
      }
    }
  }
}

使用方法

配置 API Key 后，启动 AI 助手时会自动登录。直接在对话中发出指令即可：

查看我最近的录音

获取这条录音的转写内容

帮我看看上次那个会议的 AI 总结

给这条录音追加一条笔记：已跟进

AI 会自动调用对应工具完成操作，无需手动操作。

可用功能

功能	说明
登录	通过 API Key 认证
录音列表	浏览、搜索你的录音
录音详情	查看单条录音的完整信息
转写文本	获取录音的 AI 转写内容（含说话人、时间戳）
智能总结	获取会议/录音的 AI 总结
笔记读写	查看和编辑录音笔记
模板浏览	查看总结模板分类

常见问题

Q: API Key 在哪里获取？

A: 妙记 App → 我的 → API Key 管理中创建。

Q: 可以为不同 AI 助手创建不同的 Key 吗？

A: 可以，在 API Key 管理中创建多个 Key，按需分配给不同助手。

Q: 找不到 claude 命令？

A: 需要先安装 Claude Code。

Q: 添加 MCP 时没有配置 API Key，工具提示需要鉴权怎么办？

A: 有两种方式解决：
1. 在对话中直接告诉 AI 你的 API Key，它会自动完成认证；
2. 编辑 MCP 配置文件，添加 MCP_API_KEY 环境变量后重启 AI 工具。

卸载

npm uninstall -g sonicnote-mcp-server