Granola MCP
chính thứcKế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 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.
Bạn có thể làm gì với Granola MCP?
- Tìm kiếm ghi chú cuộc họp — Yêu cầu AI của bạn tìm các chủ đề hoặc cuộc thảo luận cụ thể từ các cuộc họp trước bằng
query_granola_meetings. - Liệt kê cuộc họp và thư mục — Hỏi bạn đã có cuộc họp nào với ai đó hoặc bạn có thể truy cập những thư mục nào qua
list_meetingsvàlist_meeting_folders. - Trích xuất mục hành động và quyết định — Yêu cầu các mục hành động còn lại theo từng người hoặc các quyết định chính từ ghi chú của một cuộc họp bằng
get_meetings. - Xem lại màn hình được chia sẻ — Hỏi nội dung trên một slide hoặc biểu đồ được trình bày trong cuộc họp bằng
get_meeting_attachment. - Lấy trích dẫn chính xác từ bản ghi — Yêu cầu các trích dẫn cụ thể từ bản ghi thô của cuộc họp bằng
get_meeting_transcript. - Quản lý tài khoản và không gian làm việc — Hỏi tài khoản Granola nào đang được kết nối hoặc yêu cầu chuyển đổi không gian làm việc qua
get_account_infovàswitch_workspace.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://mcp.granola.ai/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
Mục lục tài liệu
Tải toàn bộ mục lục tài liệu tại: https://docs.granola.ai/llms.txt Sử dụng tệp này để khám phá tất cả các trang có sẵn trước khi tìm hiểu sâu hơn.
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 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 qua các thư mục cuộc họp, trích xuất các 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à Ủy quyền do doanh nghiệp quản lý (EMA) cho các nhà cung cấp danh tính và máy khách MCP tương thích.
MCP có thể truy cập những gì
Granola MCP kết nối với tư cách 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 pháp đề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 các 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ú công khai |
|
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 | Quyền 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. |
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 Claude2. Đ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
```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
[https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) làm kết nối tùy chỉnh.
Công cụ AI của bạn phải hỗ trợ:
* **Giao thức máy khách MCP** sử dụng [truyền tải Streamable HTTP](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 mã thông báo bearer để đưa vào các yêu cầu tiếp theo.
Máy khách doanh nghiệp có thể sử dụng [Ủy quyền do doanh nghiệp quản lý](#enterprise-managed-authorization) thay vì 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ó khóa API hoặc phương thức truy cập tài khoản dịch vụ cho MCP.
<Info>
Nếu bạn cần quyền truy cập khóa API cho tập lệnh, tự động hóa hoặc tích hợp tùy chỉnh, hãy xem [Granola API](./granola-api) của chúng tôi.
</Info>
Ủy quyền do doanh nghiệp quản lý
Ủy quyền do doanh nghiệp quản lý (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 máy khách MCP 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à máy khách MCP hỗ trợ EMA (Granola đã thử nghiệm với Claude & Okta)
- Quyền truy cập quản trị viên vào không gian làm việc Granola và IdP của bạn, hoặc sự trợ giúp từ các 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
- Trong Granola, nhấp vào tên không gian làm việc của bạn ở góc dưới bên trái, sau đó chọn Cài đặt. Đi tới Cài đặt → Không gian làm việc → Chung → Ứng dụng & trình kết nối → Quyền truy cập MCP và bật quyền truy cập ghi chú mà công ty của bạn muốn cho phép.
- 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ó.
- Tạo kết nối tài nguyên được quản lý từ máy khách MCP của bạn đến Granola.
- 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ị |
|---|---|
| URL tài nguyên | https://mcp.granola.ai/mcp |
| URL nhà phát hành | https://mcp-auth.granola.ai |
| Đối tượng ID-JAG | https://mcp-auth.granola.ai |
| Phạm vi | mcp |
| ID máy khách tại tài nguyên | URL Tài liệu siêu dữ liệu ID máy khách của máy khách MCP |
- Gán người dùng hoặc nhóm phù hợp cho cả Granola và máy khách MCP, 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 của bạn tự xây dựng máy khách MCP
Granola hỗ trợ máy khách bảo mật xác thực bằng private_key_jwt thông qua Tài liệu siêu dữ liệu ID máy khách (CIMD). Điều này cho phép máy khách của bạn xác thực bằng cặp khóa riêng của nó thay vì bí mật máy khách do Granola cấp.
Máy khách của bạn phải triển khai tiện ích mở rộng EMA MCP, 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 chính xác nhà phát hành được quảng cáo làm đối tượng của xác nhận máy khách.
Xem đặc tả EMA MCP để 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):
- Trong Okta, thêm tích hợp Granola.
- Mở tab Máy chủ tài nguyên và bật Cross App Access (XAA).
- 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.
- Sử dụng
https://claude.ai/oauth/mcp-oauth-client-metadatalàm ID máy khách tại tài nguyên.
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 các ví dụ trò chuyện đầy đủ 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ê cá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 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 vào tuần trước? |
get_meetings | Đọc cá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_attachment | Xem ảnh chụp màn hình được chia sẻ trong cuộc họp, chẳng hạn như slide, biểu đồ hoặc mã. | Nội dung trên slide định giá trong buổi đánh giá hôm nay 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, không gian làm việc đang hoạt động và các không gian làm việc đã tham gia 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? |
switch_workspace | Chỉ khả dụng nếu bạn thuộc nhiều hơn một không gian làm việc — Thay đổi không gian làm việc Granola đang hoạt động của bạn. Điều này cũng thay đổi trong ứng dụng Granola và trong bất kỳ công cụ AI nào khác được kết nối với tài khoản của bạn. | Chuyển không gian làm việc Granola của tôi sang Acme |
sign_out | Đăng xuất công cụ AI này khỏi tài khoản Granola của bạn. Để sử dụng tài khoản khác, hãy kết nối lại Granola sau đó. | Đăng xuất tôi khỏi Granola |
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 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.<Info>
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.
</Info>
1. Đi tới [cài đặt trình 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 sử dụng ứng dụng máy tính để bàn 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 **Ngắt kết nối**.
5. Không làm mới trang hoặc điều hướng đi, chọn **Kết nối** lại
và hoàn tất xác thực.
<Info>
Nếu bạn đang sử 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.
</Info>
Để 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 **Cài đặt** (<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ơ của bạn ở 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 cùng địa chỉ email đó trong quy trình OAuth.
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?"** Nó sẽ 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 workspace: hãy chuyển workspace trong ứng dụng desktop Granola (nhấp vào tên workspace của bạn ở góc dưới bên trái và chọn đúng workspace). MCP tuân theo workspace đang hoạt động của bạn, vì vậy truy vấn tiếp theo sẽ sử dụng nó. Bạn cũng có thể yêu cầu công cụ AI của mình chuyển workspace cho bạn, ví dụ: "Chuyển workspace Granola của tôi sang [tên workspace]."
- Sai hoàn toàn email: hãy làm theo các bước trong mục Đã đăng nhập vào Claude bằng tài khoản sai 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.
- Yêu cầu Claude đăng xuất khỏi Granola.
- Nhấp vào liên kết mcp-auth.granola.ai/api/logout mà nó cung cấp.
- Yêu cầu Claude kết nối lại với Granola và đăng nhập bằng email tài khoản Granola chính của bạ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 điều 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. Đăng xuất qua liên kết sẽ xóa phiên đó, 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ể sử 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 **Cài đặt** (⌘ + , 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ơ của bạn ở góc trên bên trái. Trước tiên, hãy kiểm tra phạm vi truy cập nào áp dụng cho bạn:* **Cơ bản (Miễn phí):** Ghi chú cá nhân từ 30 ngày qua.
* **Doanh nghiệp:** Ghi chú cá nhân và ghi chú công khai.
* **Enterprise:** Quản trị viên workspace cấu hình phạm vi nào có sẵn 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 workspace. 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 workspace, bao gồm cả ghi chú trong không gian Nhóm.
MCP cũng chỉ trả về các ghi chú thuộc workspace đang hoạt động. Nếu một ghi chú được tạo trong một workspace Granola khác, MCP sẽ không trả về nó từ workspace hiện tại của bạn, ngay cả khi bạn có thể thấy nó trong Granola.
Cũng xác nhận rằng MCP được kết nối với đúng tài khoản và workspace đ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?"**
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 chú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 tại tài nguyên** khi tạo kết nối được quản lý. Nhập URL Tài liệu Client ID Metadata 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 sử dụng URL do máy khách đó cung cấp; bạn không cần tự tạo một URL 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 Client ID Metadata 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).
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ệ với [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ể cấu hình quyền truy cập ghi chú có sẵn cho thành viên workspace:1. Đi tới **Cài đặt → Workspace → Chung**.
2. Tìm **MCP access** trong **Ứng dụng & trình kết nối**.
3. Nhấp vào **Quản lý**.
4. Bật **Ghi chú cá nhân**, **Ghi chú công khai**, cả hai hoặc không cái nào.
Để ngăn công cụ AI đọc bản ghi cuộc họp, hãy tắt **Bản ghi cuộc họp** trong cùng hộp thoại. Nó áp dụng cho mọi cuộc họp trong workspace của bạn, cho mọi người có thể truy cập, bao gồm cả quản trị viên và những người mà ghi chú được chia sẻ. Ghi chú và tóm tắt vẫn có sẵn. Nó được bật theo mặc định.
Công tắc **Bản ghi cuộc họp** áp dụng cho mọi người, bao gồm cả quản trị viên.
Tài liệu này được xây dựng và lưu trữ trên Mintlify, một nền tảng tài liệu dành cho nhà phát triển.