Granola MCP

Granola MCP

Kết nối Claude, ChatGPT và các công cụ AI khác với ghi chú cuộc họp Granola của bạn thông qua MCP. Truy vấn ghi chú, tìm kiếm bản ghi và nhận thông tin chi tiết về cuộc họp trong các trợ lý AI yêu thích của bạn.

Kết nối các công cụ AI của bạn với ghi chú cuộc họp Granola bằng Granola MCP. Sau khi kết nối, bạn có thể sử dụng để: tìm kiếm ghi chú cuộc họp, tìm các chủ đề cụ thể đã thảo luận trong các cuộc họp trước, duyệt thư mục cuộc họp, trích xuất mục hành động hoặc quyết định từ ghi chú, trả lời câu hỏi dựa trên lịch sử cuộc họp của bạn và hơn thế nữa.

Granola hỗ trợ OAuth dựa trên trình duyệt và Enterprise-Managed Authorization (EMA) cho các nhà cung cấp danh tính và MCP client tương thích.

MCP có thể truy cập những gì

Granola MCP kết nối như một người dùng cá nhân thông qua OAuth trình duyệt. Với EMA, nhà cung cấp danh tính của tổ chức quản lý quyền truy cập thay thế. Cả hai phương thức đều trả về ghi chú mà người dùng có thể truy cập và thuộc về không gian làm việc Granola đang hoạt động của người dùng, tùy thuộc vào phạm vi truy cập bên dưới.

Ghi chú từ các không gian làm việc Granola khác không được bao gồm, ngay cả khi chúng hiển thị trong không gian làm việc đang hoạt động thông qua chia sẻ.

Phạm vi truy cập	Có thể truy cập những gì
Ghi chú cá nhân	Ghi chú bạn sở hữu trong không gian làm việc đang hoạt động Ghi chú trong không gian làm việc đang hoạt động được chia sẻ trực tiếp với bạn Ghi chú trong thư mục riêng tư của không gian làm việc đang hoạt động được chia sẻ với bạn
Ghi chú công khai	Ghi chú hiển thị cho mọi người trong không gian làm việc đang hoạt động Ghi chú trong không gian Team của không gian làm việc đang hoạt động

Gói và cài đặt không gian làm việc của bạn xác định phạm vi MCP sử dụng:

Gói	Truy cập MCP
Cơ bản (Miễn phí)	Ghi chú cá nhân từ 30 ngày qua. Một số công cụ thư mục, tìm kiếm và bản ghi chỉ khả dụng trên các gói trả phí.
Doanh nghiệp	Ghi chú cá nhân và ghi chú công khai.
Enterprise	Quản trị viên không gian làm việc có thể cấu hình phạm vi nào khả dụng cho thành viên. Nếu không có phạm vi nào được bật, thành viên không thể sử dụng Granola MCP.

Thông tin

MCP tuân theo không gian làm việc đang hoạt động được chọn trong ứng dụng Granola. Nếu bạn thuộc nhiều hơn một không gian làm việc, hãy chuyển đổi không gian làm việc trong Granola trước khi hỏi công cụ AI của bạn câu hỏi khác. MCP không kết hợp ghi chú trên nhiều không gian làm việc.

Hướng dẫn thiết lập

Điều kiện tiên quyết

• Tài khoản Granola có ghi chú cuộc họp hiện có
• Công cụ AI hỗ trợ MCP, chẳng hạn như Claude và ChatGPT

Cách kết nối

1. Mở và đăng nhập vào Claude

2. Đi tới Cài đặt

3. Đi tới Trình kết nối, tìm kiếm Granola

4. Kết nối, xác thực và đảm bảo bạn đã bật khi
   trò chuyện

1. Mở và đăng nhập vào ChatGPT 2. Đi tới Cài đặt 3. Tìm kiếm 'Granola' và kết nối 4. Bây giờ bạn có thể @Granola hoặc chỉ cần yêu cầu tham chiếu các cuộc họp của bạn trong ChatGPT 1. Chạy `claude` trong terminal của bạn 2. Chạy lệnh này:

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

3. Mở một tab terminal mới và chạy `claude` lần nữa
4. Chạy `/mcp`, chọn granola MCP và chọn 'Xác thực'
5. Yêu cầu Claude tham chiếu các cuộc họp của bạn

Bạn có thể kết nối thủ công với Granola MCP bằng cách sử dụng URL công khai{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) như một kết nối tùy chỉnh.

Công cụ AI của bạn phải hỗ trợ:

* **Giao thức MCP client** sử dụng [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Xác thực OAuth 2.0 và khám phá siêu dữ liệu** — đối với kết nối tiêu chuẩn, công cụ của bạn phải có khả năng mở cửa sổ trình duyệt để người dùng đăng nhập vào Granola. Sau khi đăng nhập, công cụ nhận được bearer token để đưa vào các yêu cầu tiếp theo.

Khách hàng doanh nghiệp có thể sử dụng [Enterprise-Managed Authorization](#enterprise-managed-authorization) thay cho quy trình đăng nhập Granola tiêu chuẩn. Mỗi kết nối vẫn hoạt động thay mặt cho một người dùng Granola cá nhân; không có API key hoặc phương thức truy cập tài khoản dịch vụ cho MCP.

Thông tin

Nếu bạn cần truy cập API key cho script, tự động hóa hoặc tích hợp tùy chỉnh, hãy xem Granola API của chúng tôi.

Enterprise-Managed Authorization

Enterprise-Managed Authorization (EMA) cho phép công ty của bạn kiểm soát quyền truy cập vào Granola MCP thông qua nhà cung cấp danh tính (IdP). Người dùng đăng nhập vào MCP client của họ bằng tài khoản công ty và IdP quyết định xem họ có thể kết nối với Granola hay không.

IdP của bạn kiểm soát ai có thể kết nối. Cài đặt không gian làm việc của Granola kiểm soát ghi chú nào họ có thể truy cập.

Trước khi bắt đầu

Bạn cần:

• Không gian làm việc Granola Enterprise có SSO được cấu hình
• IdP và MCP client hỗ trợ EMA (Granola đã thử nghiệm với Claude & Okta)
• Quyền quản trị viên cho không gian làm việc Granola và IdP của bạn, hoặc sự trợ giúp từ quản trị viên liên quan

Mỗi người dùng nên đã có tài khoản Granola liên kết với danh tính công ty của họ. Nếu họ chưa từng sử dụng SSO công ty với Granola trước đây, hãy yêu cầu họ đăng nhập vào Granola bằng SSO một lần trước khi sử dụng EMA.

Cấu hình EMA

1. Trong Granola, đi tới Cài đặt → Không gian làm việc → Chung → Ứng dụng & trình kết nối → Truy cập MCP cho thành viên. Bật quyền truy cập ghi chú mà công ty bạn muốn cho phép.
2. Trong IdP của bạn, thêm hoặc chọn Granola và bật khả năng ủy quyền được quản lý hoặc máy chủ tài nguyên của nó.
3. Tạo kết nối tài nguyên được quản lý từ MCP client của bạn đến Granola.
4. Nhập các giá trị bên dưới. IdP của bạn có thể sử dụng tên trường khác hoặc tự động suy ra một số giá trị.

Trường	Giá trị
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	URL tài liệu siêu dữ liệu Client ID của MCP client

5. Gán người dùng hoặc nhóm phù hợp cho cả Granola và MCP client, sau đó kích hoạt kết nối tài nguyên được quản lý.

Với EMA, người dùng được gán không hoàn tất quy trình đồng ý OAuth Granola riêng biệt. Quyền truy cập của họ vẫn tuân theo cả chính sách IdP của bạn và quyền truy cập MCP được cấu hình trong Granola.

Nếu công ty bạn xây dựng MCP client riêng

Granola hỗ trợ confidential client xác thực bằng private_key_jwt thông qua Client ID Metadata Document (CIMD). Điều này cho phép client của bạn xác thực bằng cặp khóa riêng thay vì client secret do Granola cấp.

Client của bạn phải triển khai tiện ích mở rộng MCP EMA, lấy ID-JAG từ IdP của công ty và xuất bản tài liệu siêu dữ liệu HTTPS công khai khai báo private_key_jwt và jwks_uri. Sử dụng siêu dữ liệu OAuth của Granola để khám phá các khả năng và điểm cuối được hỗ trợ, đồng thời sử dụng issuer được quảng cáo chính xác làm audience cho client assertion.

Xem đặc tả MCP EMA để biết các yêu cầu giao thức đầy đủ.

Ví dụ: Claude và Okta

Granola đã thử nghiệm EMA với Claude và Okta Cross App Access (XAA):

1. Trong Okta, thêm tích hợp Granola.
2. Mở tab Resource server và bật Cross App Access (XAA).
3. Làm theo hướng dẫn của Okta để cấu hình trình kết nối máy chủ tài nguyên giữa Claude và Granola.
4. Sử dụng https://claude.ai/oauth/mcp-oauth-client-metadata làm Client ID at resource.

Công cụ và mô tả

Công cụ	Mô tả	Ví dụ lời nhắc
query_granola_meetings	Trò chuyện với Granola	Xem toàn bộ ví dụ trò chuyện tại đây
list_meeting_folders	Chỉ gói trả phí — Liệt kê các thư mục bạn có thể truy cập, bao gồm ID thư mục, tiêu đề, mô tả và số lượng ghi chú.	Tôi có quyền truy cập vào những thư mục cuộc họp nào?
list_meetings	Liệt kê ghi chú cuộc họp bạn có thể truy cập, bao gồm ID cuộc họp, tiêu đề, ngày và người tham dự. Có thể lọc theo thư mục trên các gói trả phí.	Tôi đã có những cuộc họp nào với Sam tuần trước?
get_meetings	Đọc ghi chú cuộc họp bạn có thể truy cập, bao gồm ID cuộc họp, tiêu đề, ngày, người tham dự, ghi chú riêng tư và ghi chú tóm tắt.	Các mục hành động còn lại cho từng người trong dự án này là gì?
get_meeting_transcript	Chỉ gói trả phí — Phóng to bản ghi của bạn, bao gồm: ID cuộc họp, bản ghi thô	Đưa ra các trích dẫn cụ thể về cách nhóm mô tả vấn đề
get_account_info	Trả về email và không gian làm việc đang hoạt động cho tài khoản Granola hiện được kết nối với phiên MCP này — hữu ích để xác nhận bạn đã kết nối đúng tài khoản Granola khi bạn có nhiều tài khoản (ví dụ: cá nhân + công việc)	Tôi đang đăng nhập bằng tài khoản Granola nào?

Hướng dẫn khắc phục sự cố

Giới hạn tốc độ sẽ khác nhau tùy thuộc vào gói đăng ký Granola của bạn và công cụ MCP bạn đang sử dụng. Giới hạn tốc độ hiện tại trung bình khoảng 100 yêu cầu mỗi phút trên tất cả các công cụ. Giới hạn tốc độ có thể thay đổi.

Thông tin

Nếu bạn đang sử dụng gói Cơ bản (Miễn phí), bạn chỉ có thể truy vấn ghi chú trong 30 ngày qua.

Nếu bạn nhận được thông báo rằng LLM agent của bạn không thể truy cập ghi chú cuộc họp hoặc sử dụng các công cụ Granola MCP, hãy thử xác thực lại. Nếu Granola đã được kết nối trong Claude nhưng hiển thị **No tools available**, hãy kết nối lại bộ kết nối Granola trong Claude để đặt lại kết nối:

1. Truy cập [cài đặt bộ kết nối Claude](https://claude.ai/customize/connectors) trên web. Bạn phải thực hiện việc này trên claude.ai ngay cả khi bạn dùng ứng dụng desktop Claude.
2. Chọn **Granola**.
3. Nhấp vào menu ba chấm ở góc trên bên phải.
4. Chọn **Disconnect**.
5. Không làm mới trang hoặc điều hướng đi nơi khác, chọn **Connect** lại và hoàn tất xác thực.

Thông tin

Nếu bạn đang dùng gói Claude Team hoặc Enterprise, bạn có thể cần quản trị viên không gian làm việc ngắt kết nối và kết nối lại Granola cho bạn.

Nếu bạn thấy lỗi này sau khi hoàn tất quy trình đăng nhập OAuth, bạn có thể đã xác thực bằng một địa chỉ email khác với email mà tài khoản Granola của bạn đã đăng ký.

Để kiểm tra email mà tài khoản Granola của bạn sử dụng, hãy mở ứng dụng Granola và đi tới **Settings** (<kbd>⌘</kbd> + <kbd>,</kbd> trên macOS, <kbd>Ctrl</kbd> + <kbd>,</kbd> trên Windows). Email tài khoản của bạn được hiển thị dưới ảnh hồ sơ ở góc trên bên trái.

Khi kết nối lại MCP, hãy đảm bảo bạn đăng nhập bằng chính email đó trong quy trình OAuth.

Nếu công cụ AI của bạn cho biết không tìm thấy ghi chú nào hoặc trả về không có kết quả khi bạn biết mình có cuộc họp, MCP có thể đang kết nối với sai tài khoản Granola hoặc sai không gian làm việc trong tài khoản đúng.

Hãy hỏi công cụ AI của bạn: **"Tôi đang đăng nhập bằng tài khoản Granola nào?"** Công cụ sẽ dùng công cụ `get_account_info` để trả về email và không gian làm việc đang hoạt động hiện được kết nối với MCP. Sau đó:

* **Đúng email, sai không gian làm việc**: chuyển không gian làm việc trong ứng dụng desktop Granola (nhấp vào tên không gian làm việc của bạn ở góc trên bên trái và chọn đúng không gian). MCP theo không gian làm việc đang hoạt động của bạn, vì vậy truy vấn tiếp theo sẽ sử dụng nó.
* **Sai email hoàn toàn**: làm theo các bước trong mục **Signed into Claude with the wrong account** bên dưới (hoặc tương đương cho công cụ AI của bạn) để ngắt kết nối và kết nối lại bằng tài khoản đúng.

Dưới đây là cách kết nối lại Claude MCP với một tài khoản Granola khác:

1. Mở cửa sổ ẩn danh/riêng tư và đăng nhập vào claude.ai.
2. Đi tới **Settings -> Connectors** và ngắt kết nối Granola.
3. Vẫn trong cửa sổ ẩn danh, kết nối lại Granola. Thao tác này sẽ nhắc bạn đăng nhập lại, vì vậy hãy dùng email tài khoản Granola chính của bạn.
4. Sau khi kết nối, quay lại trình duyệt thông thường của bạn và nó sẽ hoạt động với đúng tài khoản.

Lý do ngắt kết nối/kết nối lại thông thường không khắc phục được vấn đề này là phiên Granola hiện tại của bạn vẫn hoạt động, vì vậy nó bỏ qua bước đăng nhập. Cửa sổ ẩn danh buộc đăng nhập mới, cho phép bạn chọn đúng tài khoản.

Câu hỏi thường gặp chung

Không, bạn có thể dùng các tài khoản khác nhau cho công cụ AI và Granola. Bạn sẽ xác thực tài khoản Granola mà bạn muốn công cụ AI của mình truy cập. Để xác minh email mà tài khoản Granola của bạn sử dụng, hãy mở ứng dụng Granola và đi tới **Settings** (⌘ + , trên macOS, Ctrl + , trên Windows) — email tài khoản của bạn được hiển thị dưới ảnh hồ sơ ở góc trên bên trái. Trước tiên, hãy kiểm tra phạm vi truy cập áp dụng cho bạn:

* **Basic (Miễn phí):** Ghi chú cá nhân từ 30 ngày qua.
* **Business:** Ghi chú cá nhân và ghi chú công khai.
* **Enterprise:** Quản trị viên không gian làm việc định cấu hình phạm vi nào khả dụng cho thành viên.

Quyền truy cập ghi chú cá nhân không bao gồm mọi ghi chú riêng tư trong không gian làm việc. Ghi chú phải là của bạn, được chia sẻ trực tiếp với bạn hoặc nằm trong thư mục riêng tư được chia sẻ với bạn. Quyền truy cập ghi chú công khai bao gồm các ghi chú hiển thị cho mọi người trong không gian làm việc, bao gồm cả ghi chú trong không gian Team.

MCP cũng chỉ trả về các ghi chú thuộc không gian làm việc đang hoạt động. Nếu một ghi chú được tạo trong một không gian làm việc Granola khác, MCP sẽ không trả về ghi chú đó từ không gian làm việc hiện tại của bạn, ngay cả khi bạn có thể thấy nó trong Granola.

Đồng thời xác nhận rằng MCP được kết nối với đúng tài khoản và không gian làm việc đang hoạt động bằng cách hỏi công cụ AI của bạn: **"Tôi đang đăng nhập bằng tài khoản Granola nào?"**

Điều này sẽ xảy ra ngay lập tức và bạn sẽ có quyền truy cập vào các công cụ bổ sung cũng như giới hạn tốc độ được nâng cấp trong truy vấn tiếp theo của mình. Đối với kết nối OAuth trình duyệt tiêu chuẩn, không. Granola MCP sử dụng Dynamic Client Registration (DCR), nghĩa là thông tin xác thực được xử lý tự động. Bạn không cần tạo hoặc nhập bất kỳ client ID hoặc client secret nào.

Nếu bạn đang sử dụng nền tảng của bên thứ ba (như Composio) hiển thị các trường client ID và client secret, hãy để trống — nền tảng sẽ tự động đăng ký với Granola khi bạn kết nối.

Thiết lập EMA khác. Nhà cung cấp danh tính của bạn có thể yêu cầu **Client ID at resource** khi tạo kết nối được quản lý. Nhập URL Tài liệu siêu dữ liệu Client ID của máy khách MCP. Nếu bạn đang sử dụng máy khách MCP hiện có như Claude, hãy dùng URL do máy khách đó cung cấp; bạn không cần tự tạo hoặc nhập client secret.

Nếu bạn đang xây dựng máy khách MCP bảo mật của riêng mình, bạn tạo và lưu trữ Tài liệu siêu dữ liệu Client ID của nó. URL của tài liệu là client ID và máy khách xác thực bằng khóa riêng của nó thay vì client secret do Granola cấp. Xem [Nếu công ty của bạn tự xây dựng máy khách MCP](#if-your-company-builds-its-own-mcp-client).

Có — bất kỳ công cụ nào triển khai [đặc tả máy khách MCP](https://modelcontextprotocol.io/) với truyền tải HTTP Streamable đều có thể kết nối với Granola MCP. Công cụ của bạn có thể dùng OAuth trình duyệt hoặc EMA nếu nó hỗ trợ tiện ích mở rộng và tổ chức của bạn đã định cấu hình IdP tương thích. Xem các mục "Công cụ AI khác" và [Ủy quyền do doanh nghiệp quản lý](#enterprise-managed-authorization) ở trên.

Nếu bạn đang xây dựng tích hợp tùy chỉnh và cần trợ giúp, hãy liên hệ [hey@granola.so](mailto:hey@granola.so).

Câu hỏi thường gặp về Enterprise

Có. Quản trị viên Enterprise có thể định cấu hình quyền truy cập ghi chú khả dụng cho thành viên không gian làm việc:

1. Đi tới **Settings → Workspace → General**.
2. Tìm **MCP access for members** trong **Apps & connectors**.
3. Nhấp **Manage**.
4. Bật **Personal notes**, **Public notes**, cả hai hoặc không bật gì.

Quyền truy cập phụ thuộc vào cấu hình MCP hiện tại của không gian làm việc. Nếu không có phạm vi nào được bật, thành viên không có quyền truy cập MCP cho đến khi quản trị viên bật ghi chú cá nhân, ghi chú công khai hoặc cả hai. Các điều khiển nằm trong **Settings → Workspace → General → Apps & connectors → MCP access for members**. Tất cả thành viên không gian làm việc Enterprise đều có thể xem cài đặt này, nhưng chỉ quản trị viên mới có thể thay đổi nó. Nếu bạn cần bật phạm vi khác, hãy hỏi quản trị viên không gian làm việc của bạn. Không. Các điều khiển xác định những gì thành viên không gian làm việc không phải quản trị viên có thể truy cập qua MCP. Quản trị viên Enterprise có thể truy cập cả ghi chú cá nhân và ghi chú công khai qua MCP.