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 trong 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 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ú của bạn, trả lời câu hỏi dựa trên lịch sử cuộc họp và hơn thế nữa.

Chúng tôi hiện chỉ hỗ trợ xác thực thông qua OAuth trình duyệt. Đối với các hình thức xác thực khác, vui lòng gửi phản hồi đến hey@granola.so.

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

Granola MCP kết nối với tư cách là người dùng cá nhân thông qua OAuth trình duyệt. Nó trả về ghi chú từ không gian làm việc Granola đang hoạt động của người dùng, tuân theo các phạm vi truy cập bên dưới.

Phạm vi truy cập	Những gì nó có thể truy cập
Ghi chú cá nhân	Ghi chú bạn sở hữu Ghi chú được chia sẻ trực tiếp với bạn Ghi chú trong các thư mục riêng tư đượ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 Ghi chú trong không gian Nhóm

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

Gói	Truy cập MCP
Cơ bản (Miễn phí)	Ghi chú cá nhân trong 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.
Doanh nghiệp lớn	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.

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 một câu hỏi khá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 đến 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ở 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 đến 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) 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 [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Xác thực OAuth 2.0** — máy chủ sử dụng OAuth dựa trên trình duyệt, vì vậy công cụ của bạn cần 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 để bao gồm trong các yêu cầu tiếp theo.

Mỗi người dùng xác thực riêng lẻ thông qua luồng OAuth trình duyệt. Không có phương thức truy cập khóa API hoặc 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 để thay thế.
</Info>

Công cụ và mô tả

Công cụ	Mô tả	Lời nhắc ví dụ
query_granola_meetings	Trò chuyện với Granola	Xem ví dụ trò chuyện đầy đủ tại đây
list_meeting_folders	Chỉ dành cho 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ể được 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 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 mỗi người trong dự án này là gì?
get_meeting_transcript	Chỉ dành cho 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 đã đă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ẽ thay đổi 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.

<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>

Nếu bạn nhận được thông báo rằng tác nhân LLM 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ị **Không có công cụ khả dụng**, hãy kết nối lại trình kết nối Granola trong Claude để đặt lại kết nối:

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 Claude desktop.
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 nơi khác, 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>

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

Để kiểm tra email nào 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 luồng OAuth.

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

Hỏi công cụ AI của bạn: **"Tôi đã đă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 không gian làm việc**: chuyển đổi không gian làm việc trong ứng dụng Granola desktop (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). MCP tuân 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 **Đã đă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 với tài khoản chính xác.

Đâ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ổ duyệt web ẩn danh/riêng tư và đăng nhập vào claude.ai.
2. Đi tới **Cài đặt -> Trình kết nối** và ngắt kết nối Granola.
3. Vẫn ở chế độ ẩn danh, kết nối lại Granola. Điều này sẽ nhắc bạn đăng nhập lại, vì vậy hãy sử dụng email tài khoản Granola chính của bạn.
4. Sau khi kết nối, chuyển trở lại trình duyệt bình thường của bạn và nó sẽ hoạt động với tài khoản chính xác.

Lý do ngắt kết nối/kết nối lại bình thường không khắc phục được điều này là vì 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. Chế độ ẩn danh buộc phải đăng nhập mới, cho phép bạn chọn tài khoản chính xác.

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 của mình. 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 có quyền truy cập. Để xác minh email nào 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 trong 30 ngày qua.
* **Doanh nghiệp:** Ghi chú cá nhân và ghi chú công khai.
* **Doanh nghiệp lớn:** Quản trị viên không gian làm việc 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 trong một 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 Nhóm.
Cũng 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ẽ diễn 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 giới hạn tốc độ được nâng cấp trong lần truy vấn tiếp theo. Không. Granola MCP sử dụng OAuth dựa trên trình duyệt với Đăng ký Máy khách Động (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 hay client secret nào.

Nếu bạn đang sử dụng nền tảng 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.

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 có thể truyền trực tuyến đều có thể kết nối với Granola MCP. Công cụ của bạn sẽ cần xử lý luồng xác thực trình duyệt OAuth 2.0 để mỗi người dùng có thể đăng nhập vào tài khoản Granola của họ. Xem phần "Các công cụ AI khác" ở trên để biết chi tiết kỹ thuật.

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 dành cho Doanh nghiệp

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

1. Đi tới **Cài đặt → Không gian làm việc → Chung**.
2. Tìm **Quyền truy cập MCP cho thành viên** 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 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, các thành viên sẽ 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 tùy chọn điều khiển nằm trong **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 cho thành viên**. Tất cả các thành viên trong không gian làm việc Doanh nghiệp đều có thể xem cài đặt, nhưng chỉ quản trị viên mới có thể thay đổi. Nếu bạn cần bật mộ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 tùy chọn điều khiển xác định những gì các thành viên không phải quản trị viên trong không gian làm việc có thể truy cập thông qua MCP. Quản trị viên doanh nghiệp có thể truy cập cả ghi chú cá nhân và ghi chú công khai thông qua MCP.