Granola MCP

官方

通过MCP将Claude、ChatGPT及其他AI工具连接到你的Granola会议笔记。查询笔记、搜索转录内容，并在你喜爱的AI助手中获取会议洞察。

访问 granola.ai试用此 MCP赞助

你可以用 Granola MCP 做什么？

搜索会议笔记 — 让助手使用 query_granola_meetings 查找过往会议中的特定主题、决策或讨论。
列出会议文件夹 — 使用 list_meeting_folders 浏览可访问的文件夹，包括标题、描述和笔记数量（仅限付费计划）。
获取会议详情 — 使用 get_meetings 调取特定会议的笔记、参会者、日期和摘要内容。
提取行动项 — 通过 get_meetings 询问项目中各会议中每位成员待办的行动项或决策。
访问转录文本 — 使用 get_meeting_transcript 获取原始转录，以引用确切语句或澄清讨论（仅限付费计划）。
验证账户连接 — 使用 get_account_info 确认当前激活的 Granola 账户和工作区。

文档

Granola MCP

将 Claude、ChatGPT 及其他 AI 工具通过 MCP 连接到你的 Granola 会议笔记。在常用 AI 助手中查询笔记、搜索转录文本并获取会议洞察。

通过 Granola MCP 将你的 AI 工具连接到 Granola 会议笔记。连接后，你可以：搜索会议笔记、查找过去会议中讨论过的特定主题、浏览会议文件夹、从笔记中提取行动项或决策、基于会议历史回答问题等。

Granola 支持基于浏览器的 OAuth 和企业托管授权（EMA），适用于兼容的身份提供商和 MCP 客户端。

MCP 可以访问的内容

Granola MCP 通过浏览器 OAuth 以个人用户身份连接。使用 EMA 时，由组织的身份提供商管理访问权限。两种方式都会返回用户可访问且属于用户当前 Granola 工作区的笔记，具体受以下访问范围限制。

来自其他 Granola 工作区的笔记不会被包含，即使通过共享在当前工作区中可见也不会包含。

访问范围	可访问内容
个人笔记	你在当前工作区拥有的笔记当前工作区中直接与你共享的笔记当前工作区中与你共享的私人文件夹中的笔记
公开笔记	当前工作区中对所有人可见的笔记当前工作区团队空间中的笔记

你的套餐和工作区设置决定 MCP 使用哪些范围：

套餐	MCP 访问权限
基础版（免费）	最近 30 天的个人笔记。部分文件夹、搜索和转录工具仅对付费套餐开放。
商业版	个人笔记和公开笔记。
企业版	工作区管理员可以配置成员可用的范围。如果两个范围均未启用，成员将无法使用 Granola MCP。

信息

MCP 遵循 Granola 应用中选择的当前工作区。如果你属于多个工作区，请在向 AI 工具提问前先在 Granola 中切换工作区。MCP 不会合并多个工作区的笔记。

设置指南

前提条件

一个包含现有会议笔记的 Granola 账户
支持 MCP 的 AI 工具，如 Claude 和 ChatGPT

如何连接

1. 打开并登录 Claude

2. 进入设置

3. 进入连接器，搜索 Granola

4. 连接、认证，并确保在聊天时已开启

1. 打开并登录 ChatGPT 2. 进入设置 3. 搜索“Granola”并连接 4. 现在你可以在 ChatGPT 中 @Granola 或直接要求引用你的会议 1. 在终端中运行 `claude` 2. 运行以下命令：

```bash theme={null}
  claude mcp add granola --transport http https://mcp.granola.ai/mcp
```

3. 打开一个新的终端标签页并再次运行 `claude`
4. 运行 `/mcp`，选择 granola MCP，然后选择“认证”
5. 让 Claude 引用你的会议

你可以通过使用公共 URL{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) 作为自定义连接来手动连接到 Granola MCP。

你的 AI 工具必须支持：

* **MCP 客户端协议**，使用 [Streamable HTTP 传输](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **OAuth 2.0 认证和元数据发现** — 对于标准连接，你的工具必须能够打开浏览器窗口供用户登录 Granola。登录后，工具会收到一个 bearer 令牌，用于后续请求。

企业客户端可以使用[企业托管授权](#enterprise-managed-authorization)代替标准的 Granola 登录流程。每次连接仍然代表单个 Granola 用户操作；MCP 没有 API 密钥或服务账户访问方式。

信息

如果你需要用于脚本、自动化或自定义集成的 API 密钥访问，请参阅Granola API。

企业托管授权

企业托管授权（EMA）让你的公司通过其身份提供商（IdP）控制对 Granola MCP 的访问。用户使用公司账户登录其 MCP 客户端，由 IdP 决定他们是否可以连接到 Granola。

你的 IdP 控制谁可以连接。Granola 的工作区设置控制他们可以访问哪些笔记。

开始之前

你需要：

一个已配置 SSO 的 Granola 企业工作区
一个支持 EMA 的 IdP 和 MCP 客户端（Granola 已与 Claude 和 Okta 完成测试）
你的 Granola 工作区和 IdP 的管理员访问权限，或相关管理员的帮助

每个用户应已拥有与其公司身份关联的 Granola 账户。如果他们之前未使用公司 SSO 登录过 Granola，请先让他们使用 SSO 登录一次 Granola，然后再使用 EMA。

配置 EMA

在 Granola 中，进入 设置 → 工作区 → 常规 → 应用和连接器 → 成员的 MCP 访问权限。启用你的公司希望允许的笔记访问权限。
在你的 IdP 中，添加或选择 Granola，并启用其托管授权或资源服务器功能。
从你的 MCP 客户端创建到 Granola 的托管资源连接。
输入以下值。你的 IdP 可能使用不同的字段名称，或自动推断某些值。

字段	值
资源 URL	`https://mcp.granola.ai/mcp`
签发者 URL	`https://mcp-auth.granola.ai`
ID-JAG 受众	`https://mcp-auth.granola.ai`
范围	`mcp`
资源处的客户端 ID	MCP 客户端的客户端 ID 元数据文档 URL

将适当的用户或组同时分配给 Granola 和 MCP 客户端，然后激活托管资源连接。

使用 EMA 时，被分配的用户无需完成单独的 Granola OAuth 同意流程。他们的访问权限仍受你的 IdP 策略和 Granola 中配置的 MCP 访问权限的双重约束。

如果你的公司自行构建 MCP 客户端

Granola 支持通过客户端 ID 元数据文档（CIMD）使用 private_key_jwt 进行认证的机密客户端。这允许你的客户端使用自己的密钥对进行认证，而不是使用 Granola 签发的客户端密钥。

你的客户端必须实现 MCP EMA 扩展，从公司的 IdP 获取 ID-JAG，并发布一个公开的 HTTPS 元数据文档，声明 private_key_jwt 和 jwks_uri。使用 Granola 的 OAuth 元数据来发现支持的功能和端点，并使用确切公布的签发者作为客户端断言的受众。

有关完整协议要求，请参阅 MCP EMA 规范。

示例：Claude 和 Okta

Granola 已使用 Claude 和 Okta Cross App Access（XAA）测试了 EMA：

在 Okta 中，添加 Granola 集成。
打开资源服务器标签页，启用Cross App Access（XAA）。
按照 Okta 的说明在 Claude 和 Granola 之间配置资源服务器连接器。
使用 https://claude.ai/oauth/mcp-oauth-client-metadata 作为资源处的客户端 ID。

工具及说明

工具	说明	示例提示词
`query_granola_meetings`	与 Granola 聊天	查看完整聊天示例
`list_meeting_folders`	仅限付费套餐 — 列出你可以访问的文件夹，包括文件夹 ID、标题、描述和笔记数量。	我可以访问哪些会议文件夹？
`list_meetings`	列出你可以访问的会议笔记，包括会议 ID、标题、日期和参与者。付费套餐可按文件夹筛选。	上周我和 Sam 有哪些会议？
`get_meetings`	读取你可以访问的会议笔记，包括会议 ID、标题、日期、参与者、私人笔记和摘要笔记。	这个项目上每个人还有哪些待办事项？
`get_meeting_transcript`	仅限付费套餐 — 深入查看你的转录文本，包括：会议 ID、原始转录文本	给出团队描述该问题的具体引述
`get_account_info`	返回当前连接到此 MCP 会话的 Granola 账户的邮箱和当前工作区 — 当你有多个账户（例如个人 + 工作）时，可用于确认你连接的是正确的 Granola 账户。	我当前登录的是哪个 Granola 账户？

故障排除指南

速率限制会因你的 Granola 订阅套餐和你使用的 MCP 工具而有所不同。目前所有工具的速率限制平均约为每分钟 100 个请求。速率限制可能会发生变化。

信息

如果你使用的是基础版（免费）套餐，只能查询最近 30 天内的笔记。

如果你收到提示说你的 LLM 代理无法访问你的会议笔记或无法使用 Granola MCP 工具，请尝试重新认证。如果 Granola 已在 Claude 中连接，但显示 **没有可用工具**，请重新连接 Claude 中的 Granola 连接器以重置连接：

1. 在网页上前往 [Claude 连接器设置](https://claude.ai/customize/connectors)。即使你使用 Claude 桌面应用，也必须登录 claude.ai 完成此操作。
2. 选择 **Granola**。
3. 点击右上角的三个点菜单。
4. 选择 **断开连接**。
5. 在不刷新页面或离开当前页面的情况下，再次选择 **连接** 并完成身份验证。

信息

如果你使用的是 Claude Team 或 Enterprise 套餐，可能需要工作区管理员为你断开并重新连接 Granola。

如果你在完成 OAuth 登录流程后看到此错误，可能是因为你使用的认证邮箱与 Granola 账户注册时使用的邮箱不同。

要查看你的 Granola 账户使用哪个邮箱，请打开 Granola 应用并前往 **设置**（macOS 上为 <kbd>⌘</kbd> + <kbd>,</kbd>，Windows 上为 <kbd>Ctrl</kbd> + <kbd>,</kbd>）。你的账户邮箱显示在左上角个人资料图片下方。

重新连接 MCP 时，请确保在 OAuth 流程中使用相同的邮箱登录。

如果你的 AI 工具提示找不到任何笔记，或者在你确定有会议的情况下返回空结果，则 MCP 可能连接到了错误的 Granola 账户，或连接到了正确账户中的错误工作区。

请向你的 AI 工具提问：**“我当前登录的是哪个 Granola 账户？”** 它将使用 `get_account_info` 工具返回当前连接到 MCP 的邮箱和活动工作区。然后：

* **邮箱正确，工作区错误**：在 Granola 桌面应用中切换工作区（点击左上角的工作区名称并选择正确的工作区）。MCP 会跟随你的活动工作区，因此下一次查询将使用该工作区。
* **邮箱完全错误**：按照下方 **使用错误的账户登录 Claude** 折叠部分中的步骤（或你所用 AI 工具的对应步骤）断开连接，并使用正确的账户重新连接。

以下是如何使用不同的 Granola 账户重新连接 Claude MCP：

1. 打开一个隐身/私密浏览窗口并登录 claude.ai。
2. 前往 **设置 -> 连接器** 并断开 Granola。
3. 仍在隐身窗口中，重新连接 Granola。系统将提示你重新登录，请使用你的主要 Granola 账户邮箱。
4. 连接成功后，切换回你的常规浏览器，此时应已使用正确的账户正常工作。

普通的断开/重新连接无法解决此问题的原因是，你现有的 Granola 会话仍然有效，因此会跳过登录步骤。隐身窗口会强制进行全新登录，从而让你选择正确的账户。

常见问题

不需要，你可以为 AI 工具和 Granola 使用不同的账户。你只需认证你希望 AI 工具访问的 Granola 账户。要确认你的 Granola 账户使用哪个邮箱，请打开 Granola 应用并前往 **设置**（macOS 上为 ⌘ + ,，Windows 上为 Ctrl + ,）——你的账户邮箱显示在左上角个人资料图片下方。首先，请确认适用于你的访问范围：

* **基础版（免费）：** 最近 30 天的个人笔记。
* **商业版：** 个人笔记和公开笔记。
* **企业版：** 工作区管理员配置成员可用的访问范围。

个人笔记访问权限不包括工作区中的所有私人笔记。笔记必须是你的、直接与你共享的，或位于与你共享的私人文件夹中。公开笔记访问权限包括工作区中所有成员可见的笔记，包括团队空间中的笔记。

MCP 还只返回属于活动工作区的笔记。如果笔记是在另一个 Granola 工作区中创建的，即使你在 Granola 中可以看到它，MCP 也不会从当前工作区返回该笔记。

此外，请通过向你的 AI 工具提问来确认 MCP 已连接到正确的账户和活动工作区：**“我当前登录的是哪个 Granola 账户？”**

这应该会立即生效，你将在下一次查询时获得额外的工具和更高的速率限制。对于标准的浏览器 OAuth 连接，不需要。Granola MCP 使用动态客户端注册（DCR），这意味着凭据会自动处理。你无需生成或输入任何客户端 ID 或客户端密钥。

如果你使用的是显示客户端 ID 和客户端密钥字段的第三方平台（如 Composio），请将这些字段留空——平台会在你连接时自动向 Granola 注册。

EMA 设置则不同。你的身份提供商在创建托管连接时可能会要求提供 **资源客户端 ID**。请输入 MCP 客户端的客户端 ID 元数据文档 URL。如果你使用的是现有的 MCP 客户端（如 Claude），请使用该客户端提供的 URL；你无需自行创建或输入客户端密钥。

如果你正在构建自己的机密 MCP 客户端，则需要创建并托管其客户端 ID 元数据文档。该文档的 URL 即为客户端 ID，客户端使用其私钥进行身份验证，而非使用 Granola 签发的客户端密钥。请参阅 [如果你的公司构建自己的 MCP 客户端](#if-your-company-builds-its-own-mcp-client)。

可以——任何实现了 [MCP 客户端规范](https://modelcontextprotocol.io/) 并支持 Streamable HTTP 传输的工具都可以连接到 Granola MCP。你的工具可以使用浏览器 OAuth，或者如果它支持该扩展且你的组织已配置兼容的 IdP，也可以使用 EMA。请参阅上方的“其他 AI 工具”和 [企业托管授权](#enterprise-managed-authorization) 部分。

如果你正在构建自定义集成并需要帮助，请联系 [hey@granola.so](mailto:hey@granola.so)。

企业常见问题

可以。企业管理员可以配置工作区成员可用的笔记访问权限：

1. 前往 **设置 → 工作区 → 常规**。
2. 在 **应用与连接器** 下找到 **成员的 MCP 访问权限**。
3. 点击 **管理**。
4. 启用 **个人笔记**、**公开笔记**、两者或都不启用。

访问权限取决于工作区当前的 MCP 配置。如果两个范围均未启用，则成员没有 MCP 访问权限，直到管理员启用个人笔记、公开笔记或两者。相关控件位于 **设置 → 工作区 → 常规 → 应用与连接器 → 成员的 MCP 访问权限** 下。所有企业工作区成员都可以查看该设置，但只有管理员可以更改。如果你需要启用其他范围，请联系你的工作区管理员。不会。这些控件决定的是非管理员工作区成员可以通过 MCP 访问的内容。企业管理员可以通过 MCP 访问个人笔记和公开笔记。