Granola MCP

官方

透過 MCP 將 Claude、ChatGPT 及其他 AI 工具連接到您的 Granola 會議記錄。查詢筆記、搜尋逐字稿，並在您喜愛的 AI 助手中獲取會議洞察。

你可以用 Granola MCP 做什麼？

搜尋會議筆記 — 請你的 AI 使用 query_granola_meetings 從過去的會議中找出特定主題或討論內容。
列出會議與資料夾 — 詢問你曾與誰開過會，或你可以存取哪些資料夾，透過 list_meetings 和 list_meeting_folders。
提取行動項目與決策 — 使用 get_meetings 查詢每個人待辦的行動項目，或會議筆記中的關鍵決策。
檢視共享畫面 — 使用 get_meeting_attachment 詢問會議中投影片或圖表的內容。
取得逐字稿引述 — 使用 get_meeting_transcript 索取會議原始逐字稿中的特定引述。
管理帳戶與工作區 — 詢問目前連接的是哪個 Granola 帳戶，或透過 get_account_info 和 switch_workspace 切換工作區。

託管 MCP 伺服器

npx add-mcp 'https://mcp.granola.ai/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

文件索引

在以下位置取得完整的文件索引：https://docs.granola.ai/llms.txt 在進一步探索前，請先使用此檔案探索所有可用頁面。

Granola MCP

透過 MCP 將 Claude、ChatGPT 及其他 AI 工具連接到你的 Granola 會議筆記。在你的 AI 助理中查詢筆記、搜尋逐字稿，並取得會議洞察。

將你的 AI 工具連接到 Granola 會議筆記，使用 Granola MCP。連接後，你可以用它來：搜尋你的會議筆記、找出過去會議中討論的特定主題、瀏覽會議資料夾、從筆記中提取行動項目或決策、根據你的會議歷史回答問題，以及更多功能。

Granola 支援瀏覽器式 OAuth 和企業管理授權（EMA），適用於相容的身分提供者和 MCP 用戶端。

MCP 可以存取什麼

Granola MCP 透過瀏覽器 OAuth 以個人使用者身分連接。使用 EMA 時，則由組織的身分提供者管理存取權限。兩種方法都會回傳使用者可以存取、且屬於使用者目前 Granola 工作區的筆記，並受下列存取範圍限制。

其他 Granola 工作區的筆記不會包含在內，即使透過共用功能在目前工作區中可見亦然。

存取範圍	可以存取什麼
個人筆記	你在目前工作區中擁有的筆記在目前工作區中直接與你共用的筆記在目前工作區中與你共用的私人資料夾內的筆記
公開筆記	目前工作區中所有人可見的筆記目前工作區的 Team 空間中的筆記

你的方案和工作區設定會決定 MCP 使用哪些範圍：

方案	MCP 存取權限
Basic（免費）	最近 30 天的個人筆記。部分資料夾、搜尋和逐字稿工具僅在付費方案中提供。
Business	個人筆記和公開筆記。
Enterprise	工作區管理員可以設定成員可用的範圍。如果兩個範圍都未啟用，成員將無法使用 Granola MCP。

MCP 會遵循 Granola 應用程式中選取的有效工作區。如果你屬於多個工作區，請在向 AI 工具提出下一個問題前，先在 Granola 中切換工作區。MCP 不會合併多個工作區的筆記。

設定指南

前置需求

具有既有會議筆記的 Granola 帳戶
支援 MCP 的 AI 工具，例如 Claude 和 ChatGPT

如何連接

1. 開啟並登入 Claude

2. 前往 Settings

3. 前往 Connectors，搜尋 Granola

4. 連接、驗證，並確保在聊天時已開啟

1. 開啟並登入 ChatGPT 2. 前往 Settings 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，然後選取「Authenticate」
5. 要求 Claude 參考你的會議

你可以使用公開 URL{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) 作為自訂連接，手動連接到 Granola MCP。

你的 AI 工具必須支援：

* **MCP 用戶端協定**，使用 [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **OAuth 2.0 驗證和中繼資料探索** — 若要進行標準連接，你的工具必須能開啟瀏覽器視窗，讓使用者登入 Granola。登入後，工具會收到一個 bearer token，用於後續請求。

企業用戶端可以使用[企業管理授權](#enterprise-managed-authorization)取代標準的 Granola 登入流程。每個連接仍以個別 Granola 使用者的身分運作；MCP 沒有 API 金鑰或服務帳戶的存取方式。

<Info>
  如果你需要 API 金鑰存取權限來用於腳本、自動化或自訂整合，請改用我們的 [Granola API](./granola-api)。
</Info>

企業管理授權

企業管理授權（EMA）讓你的公司可以透過其身分提供者（IdP）控制對 Granola MCP 的存取權限。使用者使用公司帳戶登入其 MCP 用戶端，由 IdP 決定他們是否可以連接到 Granola。

你的 IdP 控制誰可以連接。Granola 的工作區設定控制他們可以存取哪些筆記。

開始之前

你需要：

已設定 SSO 的 Granola Enterprise 工作區
支援 EMA 的 IdP 和 MCP 用戶端（Granola 已測試 Claude 和 Okta）
你的 Granola 工作區和 IdP 的管理員存取權限，或相關管理員的協助

每個使用者都應已擁有與其公司身分關聯的 Granola 帳戶。如果他們之前未曾使用公司 SSO 登入 Granola，請要求他們在使用 EMA 前，先使用 SSO 登入 Granola 一次。

設定 EMA

在 Granola 中，點擊左下角的工作區名稱，然後選取 Settings。前往 Settings → Workspace → General → Apps & connectors → MCP access，並啟用你的公司想要允許的筆記存取權限。
在你的 IdP 中，新增或選取 Granola，並啟用其受管理授權或資源伺服器功能。
從你的 MCP 用戶端建立到 Granola 的受管理資源連接。
輸入下列值。你的 IdP 可能使用不同的欄位名稱，或自動推斷部分值。

欄位	值
Resource URL	`https://mcp.granola.ai/mcp`
Issuer URL	`https://mcp-auth.granola.ai`
ID-JAG audience	`https://mcp-auth.granola.ai`
Scope	`mcp`
Client ID at resource	MCP 用戶端的 Client ID Metadata Document URL

將適當的使用者或群組指派給 Granola 和 MCP 用戶端，然後啟用受管理資源連接。

使用 EMA 時，被指派的使用者不需要完成額外的 Granola OAuth 同意流程。其存取權限仍受你的 IdP 政策和 Granola 中設定的 MCP 存取權限約束。

如果你的公司自行建置 MCP 用戶端

Granola 支援使用 private_key_jwt 透過 Client ID Metadata Document（CIMD）進行驗證的機密用戶端。這讓你的用戶端可以使用自己的金鑰對進行驗證，而非使用 Granola 發行的用戶端密鑰。

你的用戶端必須實作 MCP EMA 擴充功能、從公司的 IdP 取得 ID-JAG，並發布公開的 HTTPS 中繼資料文件，宣告 private_key_jwt 和 jwks_uri。使用 Granola 的 OAuth 中繼資料來探索支援的功能和端點，並使用確切公告的 issuer 作為用戶端斷言的 audience。

完整的協定需求請參閱 MCP EMA 規格。

範例：Claude 和 Okta

Granola 已測試 EMA 搭配 Claude 和 Okta Cross App Access（XAA）：

在 Okta 中，新增 Granola 整合。
開啟 Resource server 分頁，並啟用 Cross App Access (XAA)。
依照 Okta 的指示，設定 Claude 和 Granola 之間的資源伺服器連接器。
使用 https://claude.ai/oauth/mcp-oauth-client-metadata 作為 Client ID at resource。

工具和說明

工具	說明	範例提示
`query_granola_meetings`	與 Granola 聊天	在此查看完整的聊天範例
`list_meeting_folders`	僅限付費方案 — 列出你可以存取的資料夾，包括資料夾 ID、標題、說明和筆記數量。	我可以存取哪些會議資料夾？
`list_meetings`	列出你可以存取的會議筆記，包括會議 ID、標題、日期和與會者。付費方案可依資料夾篩選。	上週我和 Sam 有哪些會議？
`get_meetings`	讀取你可以存取的會議筆記，包括會議 ID、標題、日期、與會者、私人筆記和摘要筆記。	這個專案中每個人還有哪些待辦事項？
`get_meeting_attachment`	檢視會議期間分享的螢幕截圖，例如投影片、圖表或程式碼。	今天檢討會議中的定價投影片內容是什麼？
`get_meeting_transcript`	僅限付費方案 — 深入檢視你的逐字稿，包括：會議 ID、原始逐字稿	提供團隊描述問題時的具體引述
`get_account_info`	回傳目前連接到此 MCP 工作階段的 Granola 帳戶的電子郵件、有效工作區和已加入的工作區 — 當你有多個帳戶（例如個人 + 工作）時，可用於確認你連接的是正確的 Granola 帳戶	我目前登入的是哪個 Granola 帳戶？
`switch_workspace`	僅在屬於多個工作區時可用 — 變更你的有效 Granola 工作區。這也會變更 Granola 應用程式和連接到你帳戶的其他 AI 工具中的設定。	將我的 Granola 工作區切換為 Acme
`sign_out`	將此 AI 工具登出你的 Granola 帳戶。若要使用不同的帳戶，請之後重新連接 Granola。	將我登出 Granola

疑難排解指南

速率限制會因你的 Granola 訂閱方案和所使用的 MCP 工具而異。目前所有工具的速率限制平均約為每分鐘 100 個請求。速率限制可能隨時變更。

<Info>
  如果你使用 Basic（免費）方案，只能查詢最近 30 天內的筆記。
</Info>

如果你收到訊息，表示你的 LLM 代理程式無法存取你的會議筆記或使用 Granola MCP 工具，請嘗試重新驗證。如果 Granola 已在 Claude 中連接，但顯示 **No tools available**，請重新連接 Claude 中的 Granola 連接器以重設連線：

1. 前往網路上的 [Claude connector settings](https://claude.ai/customize/connectors)。即使你使用 Claude 桌面應用程式，也必須在 claude.ai 上執行此操作。
2. 選取 **Granola**。
3. 點擊右上角的三點選單。
4. 選擇 **Disconnect**。
5. 在不重新整理頁面或離開頁面的情況下，再次選擇 **Connect** 並完成驗證。

<Info>
  如果你使用 Claude Team 或 Enterprise 方案，可能需要工作區管理員為你中斷並重新連接 Granola。
</Info>

如果你在完成 OAuth 登入流程後看到此錯誤，可能是你使用的驗證電子郵件地址與 Granola 帳戶註冊的電子郵件地址不同。

若要檢查你的 Granola 帳戶使用哪個電子郵件，請開啟 Granola 應用程式並前往 **Settings**（macOS 上為 <kbd>⌘</kbd> + <kbd>,</kbd>，Windows 上為 <kbd>Ctrl</kbd> + <kbd>,</kbd>）。你的帳戶電子郵件會顯示在左上角個人資料照片下方。

重新連接 MCP 時，請確保在 OAuth 流程中使用相同的電子郵件地址登入。

如果你的 AI 工具表示找不到任何筆記，或在你確定有會議時卻回傳沒有結果，MCP 可能連接到錯誤的 Granola 帳戶，或連接到正確帳戶中的錯誤工作區。

詢問你的 AI 工具：**「我目前登入的是哪個 Granola 帳戶？」** 它會使用 `get_account_info` 工具回傳目前連接到 MCP 的電子郵件和有效工作區。然後：

電子郵件正確，但工作區錯誤：在 Granola 桌面應用程式中切換工作區（點擊左下角的工作區名稱，然後選擇正確的工作區）。MCP 會跟隨您目前使用中的工作區，因此下一次查詢就會使用它。您也可以要求您的 AI 工具為您切換工作區，例如：「將我的 Granola 工作區切換到 [工作區名稱]。」
電子郵件完全不正確：請依照下方 以錯誤帳戶登入 Claude 摺疊區塊中的步驟操作（或您 AI 工具的對應步驟），以中斷連線並使用正確的帳戶重新連線。
以下是如何使用不同的 Granola 帳戶重新連線 Claude MCP：
1. 要求 Claude 登出 Granola。
2. 點擊它提供的 mcp-auth.granola.ai/api/logout 連結。
3. 要求 Claude 重新連線至 Granola，並使用您主要的 Granola 帳戶電子郵件登入。
一般的中斷連線／重新連線無法解決此問題的原因，在於您現有的 Granola 工作階段仍保持啟用，因此會略過登入步驟。透過該連結登出會清除該工作階段，讓您能選擇正確的帳戶。

一般常見問題

不需要，您可以為您的 AI 工具和 Granola 使用不同的帳戶。您只需驗證您希望 AI 工具存取的 Granola 帳戶。若要確認您的 Granola 帳戶使用哪個電子郵件，請開啟 Granola 應用程式並前往 **設定**（在 macOS 上為 ⌘ + ,，在 Windows 上為 Ctrl + ,）— 您的帳戶電子郵件會顯示在左上角個人資料照片下方。首先，請檢查哪些存取範圍適用於您：

* **基本（免費）：** 過去 30 天的個人筆記。
* **商業：** 個人筆記和公開筆記。
* **企業：** 工作區管理員可設定成員可用的存取範圍。

個人筆記存取不包含工作區中的每一則私人筆記。筆記必須是您自己的、直接與您分享的，或位於與您分享的私人資料夾中。公開筆記存取包含工作區中所有成員可見的筆記，包括 Team 空間中的筆記。

MCP 也只會回傳屬於目前使用中工作區的筆記。如果筆記是在另一個 Granola 工作區中建立的，MCP 不會從您目前的工作區回傳它，即使您在 Granola 中看得到它。

也請透過詢問您的 AI 工具來確認 MCP 已連線至正確的帳戶和目前使用中的工作區：**「我目前登入的是哪個 Granola 帳戶？」**

這應該會立即發生，而您將在下次查詢時獲得額外的工具和升級的速率限制。對於標準的瀏覽器 OAuth 連線，不需要。Granola MCP 使用動態用戶端註冊（DCR），這表示憑證會自動處理。您不需要產生或輸入任何用戶端 ID 或用戶端密鑰。

如果您使用第三方平台（例如 Composio）且該平台顯示用戶端 ID 和用戶端密鑰欄位，請將它們留空 — 平台會在您連線時自動向 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. 啟用 **個人筆記**、**公開筆記**、兩者皆啟用，或兩者皆不啟用。

若要停止 AI 工具讀取會議逐字稿，請在同一個對話方塊中關閉 **會議逐字稿**。此設定適用於您工作區中的每場會議，以及所有可以存取的人員，包括管理員和與其分享筆記的人。筆記和摘要仍可使用。此設定預設為開啟。

存取權限取決於工作區目前的 MCP 設定。如果兩個範圍都未啟用，成員就沒有 MCP 存取權限，直到管理員啟用個人筆記、公開筆記或兩者皆啟用為止。控制項位於 **設定 → 工作區 → 一般 → 應用程式與連接器 → MCP 存取** 下。所有 Enterprise 工作區成員都可以看到此設定，但只有管理員可以變更它。如果您需要啟用其他範圍，請詢問您的工作區管理員。筆記存取控制項不會。它們決定非管理員工作區成員可以透過 MCP 存取的內容。Enterprise 管理員可以透過 MCP 存取個人筆記和公開筆記。

**會議逐字稿** 開關適用於所有人，包括管理員。

此文件是使用 Mintlify（一個開發者文件平台）建置和託管的。