SuperAPI AI 工具集

granola

办公与效率

查看项目

更新于 10-26 18:17

技能介绍

Granola 用于通过托管的 Granola MCP 服务器(https://mcp.granola.ai/mcp)搜索 Granola 会议笔记、摘要和转录文本。

用途

该工具面向会议内容的检索与阅读,可搜索 Granola 中的会议笔记、摘要和转录文本。它不用于日历排期或未来活动规划。

主要能力

通过 granola-cli 命令行工具提供两类操作。连接管理包括:granola-cli status(查看连接状态)、granola-cli authorize-url(获取授权链接)、granola-cli exchange-code --code <code> [--redirect-uri <url>](手动交换授权码)、granola-cli refresh(刷新令牌)、granola-cli disconnect(断开连接)。MCP 操作包括:granola-cli list-tools(列出可用工具目录及每个工具的 input_schema)、granola-cli call-tool --name <tool> --arguments-json '<json-object>'(调用指定工具)。

在具体工具层面,query_granola_meetings 适合自然语言提问;list_meetings 用于获取会议元数据,默认范围为最近 30 天;get_meetings 用于已知会议 ID 的场景;get_meeting_transcript 仅在用户需要逐字细节时使用;get_account_info 用于回答当前连接的是哪个账户或工作区,并在结果为空时检查 mcp_note_access.scopes——若工作区的 MCP 访问为 public-only,则个人笔记会被排除。

使用方式

认证由 authd 通过动态客户端注册(Dynamic Client Registration)加 PKCE(S256)处理,凭证保存在 authd 之后,不应读取或编辑连接器的认证文件。

首次使用流程:先运行 granola-cli status;若状态为 not_connected,运行 granola-cli authorize-url,当返回 connect_url 时,将 <connect_url> 替换为返回的 URL,并仅以 Markdown 链接形式分享:Connect Granola,不要单独粘贴原始 URL;等待用户完成授权。用户授权后,浏览器经 Muse 中继回调到本 VM,authd 自动完成代码交换,令牌落地后代理继续。随后重新运行 granola-cli status,当状态变为 connected 时,输出还会包含发现的 MCP 工具目录。对于中继未接通的手动环境,在收到授权码后调用 granola-cli exchange-code --code <auth-code>。

操作规则:任何 MCP 工作前先运行 granola-cli status,未连接则先完成设置流程;除非已知工具名称及其参数结构,否则先调用 list-tools 再调用 call-tool,不要猜测工具名称;arguments-json 必须是 JSON 对象,数组或标量会被拒绝,每个参数都需正确包装;在面向用户的回答中保留 Granola 引用链接。list_meetings 默认最近 30 天,若返回零会议,应改用 time_range: "custom" 并配合 custom_start 和 custom_end 重试,再下结论,同时可用 list_meeting_folders 查看工作区实际内容。令牌在 401 时自动刷新;若 call-tool 持续因未授权失败,可显式运行 granola-cli refresh 或请用户重新授权。

适用场景

适合需要检索会议笔记、摘要、转录文本,或查询已连接账户与工作区信息的场景。

限制

不适用于日历排期或未来活动规划。arguments-json 仅接受 JSON 对象。工作区 MCP 访问为 public-only 时无法访问个人笔记。关于收费、价格、平台支持范围等信息,资料暂未提供。