Granola MCP
官方透過 MCP 將 Claude、ChatGPT 及其他 AI 工具連接到您的 Granola 會議記錄。查詢筆記、搜尋逐字稿，並在您喜愛的 AI 助手中獲取會議洞察。
你可以用 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，以及適用於相容身分提供者和 MCP 用戶端的企業管理授權（EMA）。
MCP 可以存取什麼
Granola MCP 以個別使用者身分透過瀏覽器 OAuth 連接。使用 EMA 時，則由組織的身分提供者管理存取權限。兩種方法都會傳回使用者可以存取、且屬於使用者目前使用中 Granola 工作區的筆記，並受下列存取範圍限制。
其他 Granola 工作區的筆記不會包含在內，即使透過共用而在目前使用中的工作區中可見亦然。
| 存取範圍 | 可以存取什麼 |
|---|---|
| 個人筆記 |
|
| 公開筆記 |
|
你的方案和工作區設定會決定 MCP 使用哪些範圍：
| 方案 | MCP 存取權限 |
|---|---|
| Basic（免費） | 最近 30 天的個人筆記。部分資料夾、搜尋和逐字稿工具僅在付費方案中提供。 |
| Business | 個人筆記和公開筆記。 |
| Enterprise | 工作區管理員可以設定成員可用的範圍。如果兩個範圍都未啟用，成員將無法使用 Granola MCP。 |
資訊
MCP 會遵循 Granola 應用程式中選取的目前使用中工作區。如果你屬於多個工作區，請在向 AI 工具提出下一個問題之前，先在 Granola 中切換工作區。MCP 不會合併多個工作區的筆記。
設定指南
前置需求
- 具有既有會議筆記的 Granola 帳戶
- 支援 MCP 的 AI 工具，例如 Claude 和 ChatGPT
如何連接
1. 開啟並登入 Claude2. 前往「設定」
3. 前往「Connectors」，搜尋 Granola
4. 連接、驗證，並確認在聊天時已開啟
```bash theme={null}
claude mcp add granola --transport http https://mcp.granola.ai/mcp
```
3. 開啟新的終端機分頁，並再次執行 `claude`
4. 執行 `/mcp`，選取 granola MCP，然後選取「Authenticate」
5. 要求 Claude 參考你的會議
[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 token，並在後續請求中一併傳送。
企業用戶端可以使用[企業管理授權](#enterprise-managed-authorization)取代標準的 Granola 登入流程。每次連接仍以個別 Granola 使用者的名義運作；MCP 沒有 API 金鑰或服務帳戶的存取方法。
資訊
如果你需要 API 金鑰存取權限來用於指令碼、自動化或自訂整合，請參閱我們的 Granola API。
企業管理授權
企業管理授權（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 → Workspace → General → Apps & connectors → MCP access for members。啟用你的公司想要允許的筆記存取權限。
- 在你的 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 支援透過 Client ID Metadata Document（CIMD）使用 private_key_jwt 驗證的機密用戶端。這讓你的用戶端可以使用自己的金鑰組進行驗證，而不是使用 Granola 發行的用戶端密鑰。
你的用戶端必須實作 MCP EMA 擴充功能、從公司的 IdP 取得 ID-JAG，並發布公開的 HTTPS 中繼資料文件，宣告 private_key_jwt 和 jwks_uri。使用 Granola 的 OAuth 中繼資料來探索支援的功能和端點，並使用確切公告的 issuer 作為用戶端宣告的 audience。
完整的協定需求請參閱 MCP EMA 規格。
範例：Claude 和 Okta
Granola 已使用 Claude 和 Okta Cross App Access（XAA）測試 EMA：
- 在 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_transcript | 僅限付費方案 — 深入檢視你的逐字稿，包括：會議 ID、原始逐字稿 | 請提供團隊描述這個問題時的具體引述 |
get_account_info | 傳回目前連接到此 MCP 工作階段的 Granola 帳戶的電子郵件和目前使用中工作區 — 當你有多個帳戶（例如個人 + 工作）時，可用於確認你連接了正確的 Granola 帳戶 | 我目前登入的是哪個 Granola 帳戶？ |
疑難排解指南
速率限制會因你的 Granola 訂閱方案和所使用的 MCP 工具而異。目前所有工具的速率限制平均約為每分鐘 100 個請求。速率限制可能隨時變更。如果你收到訊息，表示你的 LLM 代理程式無法存取你的會議筆記或使用 Granola MCP 工具，請嘗試重新驗證。 如果 Granola 已在 Claude 中連接，但顯示**沒有可用的工具**，請在 Claude 中重新連接 Granola 連接器以重設連線：資訊
如果你使用 Basic（免費）方案，只能查詢最近 30 天內的筆記。
1. 前往網頁版 [Claude 連接器設定](https://claude.ai/customize/connectors)。即使您使用 Claude 桌面應用程式，也必須在 claude.ai 上執行此操作。
2. 選擇 **Granola**。
3. 點擊右上角的三點選單。
4. 選擇**中斷連線**。
5. 在不重新整理頁面或離開頁面的情況下，再次選擇**連接**並完成驗證。
如果您在完成 OAuth 登入流程後看到此錯誤，可能是您使用的電子郵件地址與 Granola 帳戶註冊的電子郵件不同。資訊
如果您使用的是 Claude Team 或 Enterprise 方案，可能需要工作區管理員為您中斷並重新連接 Granola。
若要查看您的 Granola 帳戶使用哪個電子郵件，請開啟 Granola 應用程式並前往**設定**（在 macOS 上為 <kbd>⌘</kbd> + <kbd>,</kbd>，在 Windows 上為 <kbd>Ctrl</kbd> + <kbd>,</kbd>）。您的帳戶電子郵件會顯示在左上角個人資料照片下方。
重新連接 MCP 時，請確保在 OAuth 流程中使用相同的電子郵件地址登入。
詢問您的 AI 工具：**「我目前登入的是哪個 Granola 帳戶？」** 它會使用 `get_account_info` 工具回傳目前連接 MCP 的電子郵件和啟用中的工作區。然後：
* **電子郵件正確，工作區錯誤**：在 Granola 桌面應用程式中切換工作區（點擊左上角的工作區名稱並選擇正確的工作區）。MCP 會跟隨您啟用中的工作區，因此下一次查詢就會使用它。
* **電子郵件完全不正確**：依照下方**使用錯誤帳戶登入 Claude** 摺疊區塊中的步驟（或您 AI 工具的對應步驟）中斷連線，並使用正確的帳戶重新連接。
1. 開啟無痕/私密瀏覽視窗並登入 claude.ai。
2. 前往**設定 → 連接器**並中斷 Granola 的連線。
3. 仍在無痕視窗中，重新連接 Granola。這會提示您再次登入，因此請使用您的主要 Granola 帳戶電子郵件。
4. 連接完成後，切換回您的正常瀏覽器，它應該就能使用正確的帳戶運作。
一般的中斷/重新連接無法解決此問題的原因在於，您現有的 Granola 工作階段仍處於啟用狀態，因此會略過登入步驟。無痕模式會強制進行全新的登入，讓您可以選擇正確的帳戶。
一般常見問題
不需要，您可以為 AI 工具和 Granola 使用不同的帳戶。您只需驗證您希望 AI 工具存取的 Granola 帳戶。若要確認您的 Granola 帳戶使用哪個電子郵件，請開啟 Granola 應用程式並前往**設定**（在 macOS 上為 ⌘ + ,，在 Windows 上為 Ctrl + ,）— 您的帳戶電子郵件會顯示在左上角個人資料照片下方。 首先，請確認適用於您的存取範圍：* **基本（免費）：** 過去 30 天的個人筆記。
* **商業：** 個人筆記和公開筆記。
* **企業：** 工作區管理員會設定成員可用的範圍。
個人筆記存取不包含工作區中的每一則私人筆記。筆記必須是您自己的、直接與您分享的，或位於與您分享的私人資料夾中。公開筆記存取包含工作區中所有成員可見的筆記，包括 Team 空間中的筆記。
MCP 也只會回傳屬於啟用中工作區的筆記。如果筆記是在另一個 Granola 工作區中建立的，MCP 不會從您目前的工作區回傳它，即使您在 Granola 中可以看到它。
另外，請透過詢問您的 AI 工具來確認 MCP 已連接到正確的帳戶和啟用中的工作區：**「我目前登入的是哪個 Granola 帳戶？」**
如果您使用的是第三方平台（例如 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)。
如果您正在建置自訂整合並需要協助，請聯絡 [hey@granola.so](mailto:hey@granola.so)。
企業常見問題
可以。企業管理員可以設定工作區成員可用的筆記存取權限：1. 前往**設定 → 工作區 → 一般**。
2. 在**應用程式與連接器**下找到**成員的 MCP 存取權限**。
3. 點擊**管理**。
4. 啟用**個人筆記**、**公開筆記**、兩者皆啟用，或兩者皆不啟用。