选择适合你的接入方式
第一次使用推荐先看“MCP”,无需安装程序。每个客户端按提示独立完成个人授权。
让 AI 助手连接声掌门
使用 WorkBuddy 等支持MCP 与扫码授权的工具,可直接连接,无需安装 CLI。不同工具和版本的界面可能不同。
方法一:让 WorkBuddy 帮你接入
把下面这段话发送给 WorkBuddy。能否自动修改配置取决于其版本和权限;遇到确认提示请自行核对,扫码授权也需要本人操作。
请帮我接入 AIVoice 声掌门会议 MCP:
远程服务地址是 https://open.qipanshi.com/mcp。
请先检查现有 MCP 配置,保留其他服务,添加名为 AIVoiceRemote 的远程服务。如果助手说无法修改配置、要求手动操作,或没有出现授权提示,请按下面的方法操作;不要把登录密码或访问令牌发给助手。
方法二:手动在 WorkBuddy 中添加
以下是已在当前测试环境中验证的 WorkBuddy 接入方式;其他版本界面可能不同。此方法无需先安装 CLI。
- 打开 MCP 配置
在电脑上打开 WorkBuddy,进入“MCP 服务管理”,点击“添加 MCP”,打开 JSON 配置编辑界面。
- 添加远程地址并保存
如果配置中还没有其他 MCP,可复制下面整段;如果已有其他服务,只将
AIVoiceRemote项加入已有的mcpServers,不要覆盖其他项。{ "mcpServers": { "AIVoiceRemote": { "url": "https://open.qipanshi.com/mcp" } } }服务地址也可以单独复制:
https://open.qipanshi.com/mcp - 使用微信扫码授权
在 MCP 列表中找到 AIVoiceRemote,按连接或授权提示打开浏览器。使用绑定声掌门账号的微信扫码,在小程序确认权限后回到 WorkBuddy。CLI 登录不会自动授权其他客户端。
- 验证连接并开始使用
在 WorkBuddy 中输入:“请用声掌门查询我最近 5 条会议,并读取其中一条已有报告。”查看工具调用是否使用 AIVoiceRemote,并将结果与小程序中的本人记录对照。首次没有记录时,先确认该账号已有设备记录和已生成报告。
找到 MCP 或插件管理中的 HTTP 入口,填写上面的远程地址;若支持 OAuth,按提示扫码。仅能填 URL 和请求头不一定代表支持 OAuth。如果无法授权,可以选择上方“本地 stdio 桥接”;具体工具版本需要实测。
它不能证明该版本支持 OAuth。可改用“本地 stdio 桥接”,先在终端登录,再让工具启动桥接程序。不要在配置中填写小程序登录令牌。
在终端查询自己的会议
适合开发者、脚本和自动化流程。安装脚本自动准备独立运行环境;无需预装 Node.js 或 npm。结果以 JSON 输出,便于继续处理。
- 安装 CLI
在自己的电脑终端执行对应系统的安装命令。安装到个人目录,不修改系统现有 Node.js。
irm https://open.qipanshi.com/install.ps1 | iex aivoice --versioncurl -fsSL https://open.qipanshi.com/install.sh | sh安装完成后重新打开终端,再执行
aivoice --version。安装脚本会校验下载文件,并优先从开放平台下载运行环境;平台未提供对应文件时,会提示并尝试 Node.js 官方下载站。 - 登录并验证连接
aivoice login aivoice status浏览器打开后微信扫码确认。授权保存在当前系统用户的个人目录,后续使用会自动尝试刷新。
- 查询与读取
aivoice meetings --start 2026-11-01 --end 2026-11-06 aivoice transcript 1001 aivoice report 1001 --kind standard aivoice report 1001 --kind industry会议 ID 从查询结果获取。返回
nextOffset时,用--offset继续读取下一页或下一段。退出使用aivoice logout。
命令参数怎么填写
先用 aivoice <命令> --help 查看该命令的完整参数。下列参数都可省略,只有读取正文时的会议 ID 必填。
| 适用命令 | 参数 | 默认与取值 |
|---|---|---|
| 所有命令 | --server / --profile | 官方 MCP 地址 / default |
| login | --no-browser / --callback-port | 自动打开浏览器 / 0 自动选端口 |
| meetings | --start / --end / --keyword | 不设置筛选;日期 YYYY-MM-DD |
| meetings | --offset / --limit | 0 / 20;每页 1–50 条 |
| transcript / report | --offset / --limit | 0 / 12000;每段 100–24000 字符 |
| report | --kind | standard 普通 / industry 行业 |
| logout | --local | 默认远端撤销;此选项仅删本地凭证 |
卸载 CLI
先关闭正在使用 AIVoice CLI 的工作台或终端任务,再在电脑终端执行对应系统的命令。以下适用于 CLI 0.3.1 及以上版本的默认安装目录。
& "$env:LOCALAPPDATA\AIVoice\uninstall.ps1"sh "$HOME/.local/share/aivoice/uninstall.sh"卸载只移除程序,保留本地登录凭证和远端授权。完成后重新打开终端,使命令路径更新生效。
若旧版提示找不到卸载脚本,可先用上方安装命令更新,再执行卸载。
让支持本地命令的工具连接 MCP
工具启动本机 CLI,CLI 负责连接远程服务与刷新个人授权。业务数据仍由声掌门按用户权限校验。
- 先安装并登录
irm https://open.qipanshi.com/install.ps1 | iex aivoice login aivoice statusmacOS / Linux 先执行
curl -fsSL https://open.qipanshi.com/install.sh | sh,重新打开终端后登录。 - 填写 MCP 配置
界面字段:命令填
aivoice,参数填mcp。使用通用 JSON 入口时可参考:{ "mcpServers": { "AIVoice": { "command": "aivoice", "args": ["mcp"] } } }各工具字段名以其版本文档为准。Windows 若工具不能启动
aivoice.cmd,可用下方说明中的私有运行时完整路径配置。 - 回到助手使用
保存配置并启用插件。出现三个只读工具后,即可在对话中请求读取与整理本人会议。
开放的是成果读取能力
| 工具 | 用途 | 对应 CLI |
|---|---|---|
list_meetings | 按日期、标题查询本人的设备会议 | aivoice meetings |
get_transcript | 分段读取已保存的转写 | aivoice transcript |
get_report | 读取已有普通报告或行业报告 | aivoice report |
报告尚未生成时会返回未就绪;此接入方式不发起转写、报告或 PPT 生成。周报、待办合并等整理工作由你使用的助手完成。
客户端配置参考
| 工具 | 已知配置入口 | 接入建议 |
|---|---|---|
| WorkBuddy | MCP 服务管理 / JSON | 优先参考上方远程地址示例;也可用 stdio |
| 千问工作 | JSON / Stdio / HTTP / SSE | 尝试 HTTP + OAuth,或本地 stdio |
| 豆包工作 | 插件管理 / HTTP / STDIO | HTTP 需确认 OAuth;也可尝试 STDIO |
| DSH | 取决于 MCP 客户端或插件版本 | 单用户下,支持 command 即可尝试桥接 |
| 其他 MCP 工具 | 标准远程 HTTP 或本地命令 | 按协议能力选择,完成实际授权验证 |
接入时,你可能会遇到
需要每次提问都扫码吗?
通常首次连接时确认一次;授权有效时可继续使用。更换工具或授权失效时,按该工具提示重新扫码。每个人必须使用自己的声掌门账号授权。
为什么提示 AIVoice 暂未开放?
这表示当前服务环境暂未启用开放平台,请联系服务维护人员确认。个人授权可在声掌门小程序“我的 → 开放平台”查看;扫码时请确认使用的是自己的账号。
AI 会自动选择声掌门吗?
AI 会根据问题及可用工具判断,并非必须包含固定关键词。如果连接了多个会议工具,可在提问中说“使用声掌门”或“使用 AIVoiceRemote”,并查看工具调用记录确认。
工作台找不到 aivoice 命令怎么办?
安装后重启工作台,让它重新加载 PATH。Windows 若不支持 .cmd 启动器,命令填写 %LOCALAPPDATA%/AIVoice/versions/<版本>/runtime/node.exe 展开后的完整路径,其中版本替换为本机实际安装版本;参数填写同版本目录下 app/dist/main.js 的完整路径及 mcp。不要把百分号变量原样填到不支持变量展开的工具里。
为什么已经登录,工作台仍提示未授权?
确认工作台和登录终端使用相同系统用户、服务地址与 profile。需要区分配置时先执行 aivoice login --profile work,工作台参数也添加 --profile work。不要复制其他人的凭证。
如何在无浏览器的服务器上登录?
CLI 的回调监听在运行 CLI 的机器上。可在自己的电脑用 SSH 转发固定回调端口,再在服务器执行 aivoice login --no-browser --callback-port 19231。请依据仓库 CLI 文档配置转发;仅把授权链接复制到另一台电脑不够。
为什么没有查到某一条会议或报告?
先确认登录账号、日期范围,以及该条记录是否属于本人并具有既有设备来源。转写、报告尚未保存时不会触发补生成;返回了 nextOffset 时需要继续读取。
开源后,任何人都能读取数据吗?
不能。MIT 许可适用于代码;读取数据需个人授权及服务端逐次校验。源码公开不代表账号、设备记录或访问令牌公开。
GitHub 链接暂时无法访问?
项目仓库公开前需要仓库访问权限。遇到接入问题可联系 50075604@qq.com,请勿发送密码或访问令牌。
把已完成的会议,接入下一步工作。
从你的常用工具开始,连接自己的声掌门成果。