Granola MCP

Granola MCP

Hubungkan Claude, ChatGPT, dan alat AI lainnya ke catatan rapat Granola Anda melalui MCP. Cari catatan Anda, telusuri transkrip, dan dapatkan wawasan rapat di asisten AI favorit Anda.

Hubungkan alat AI Anda ke catatan rapat Granola dengan Granola MCP. Setelah terhubung, Anda dapat menggunakannya untuk: mencari catatan rapat Anda, menemukan topik spesifik yang dibahas dalam rapat sebelumnya, menjelajahi folder rapat, mengekstrak item tindakan atau keputusan dari catatan Anda, menjawab pertanyaan berdasarkan riwayat rapat Anda, dan banyak lagi.

Granola mendukung OAuth berbasis browser dan Enterprise-Managed Authorization (EMA) untuk penyedia identitas dan klien MCP yang kompatibel.

Apa yang dapat diakses MCP

Granola MCP terhubung sebagai pengguna individu melalui OAuth browser. Dengan EMA, penyedia identitas organisasi yang mengelola akses. Kedua metode mengembalikan catatan yang dapat diakses pengguna dan yang termasuk dalam ruang kerja Granola aktif pengguna, sesuai dengan cakupan akses di bawah ini.

Catatan dari ruang kerja Granola lainnya tidak disertakan, meskipun terlihat di ruang kerja aktif melalui berbagi.

Cakupan akses	Apa yang dapat diakses
Catatan pribadi	Catatan yang Anda miliki di ruang kerja aktif Catatan di ruang kerja aktif yang dibagikan langsung kepada Anda Catatan di folder pribadi di ruang kerja aktif yang dibagikan kepada Anda
Catatan publik	Catatan yang terlihat oleh semua orang di ruang kerja aktif Catatan di ruang Tim ruang kerja aktif

Paket dan pengaturan ruang kerja Anda menentukan cakupan mana yang digunakan MCP:

Paket	Akses MCP
Basic (Gratis)	Catatan pribadi dari 30 hari terakhir. Beberapa alat folder, pencarian, dan transkrip hanya tersedia pada paket berbayar.
Bisnis	Catatan pribadi dan catatan publik.
Perusahaan	Admin ruang kerja dapat mengonfigurasi cakupan mana yang tersedia untuk anggota. Jika tidak ada cakupan yang diaktifkan, anggota tidak dapat menggunakan Granola MCP.

Info

MCP mengikuti ruang kerja aktif yang dipilih di aplikasi Granola. Jika Anda termasuk dalam lebih dari satu ruang kerja, ganti ruang kerja di Granola sebelum mengajukan pertanyaan lain ke alat AI Anda. MCP tidak menggabungkan catatan di beberapa ruang kerja.

Panduan penyiapan

Prasyarat

• Akun Granola dengan catatan rapat yang ada
• Alat AI yang mendukung MCP, seperti Claude dan ChatGPT

Cara terhubung

1. Buka dan masuk ke Claude

2. Buka Pengaturan

3. Buka Konektor, cari Granola

4. Hubungkan, autentikasi, dan pastikan Anda aktif saat
   mengobrol

1. Buka dan masuk ke ChatGPT 2. Buka Pengaturan 3. Cari 'Granola' dan hubungkan 4. Anda sekarang dapat @Granola atau cukup minta untuk merujuk rapat Anda di ChatGPT 1. Jalankan `claude` di terminal Anda 2. Jalankan perintah ini:

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

3. Buka tab terminal baru dan jalankan `claude` lagi
4. Jalankan `/mcp`, pilih granola MCP, dan pilih 'Autentikasi'
5. Minta Claude untuk merujuk rapat Anda

Anda dapat terhubung secara manual ke Granola MCP dengan menggunakan URL publik{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) sebagai koneksi khusus.

Alat AI Anda harus mendukung:

* **Protokol klien MCP** menggunakan [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Autentikasi OAuth 2.0 dan penemuan metadata** — untuk koneksi standar, alat Anda harus dapat membuka jendela browser agar pengguna dapat masuk ke Granola. Setelah masuk, alat menerima token pembawa untuk disertakan dalam permintaan berikutnya.

Klien perusahaan dapat menggunakan [Enterprise-Managed Authorization](#enterprise-managed-authorization) alih-alih alur masuk Granola standar. Setiap koneksi tetap bertindak atas nama pengguna Granola individu; tidak ada kunci API atau metode akses akun layanan untuk MCP.

Info

Jika Anda memerlukan akses kunci API untuk skrip, otomatisasi, atau integrasi khusus, lihat Granola API sebagai gantinya.

Enterprise-Managed Authorization

Enterprise-Managed Authorization (EMA) memungkinkan perusahaan Anda mengontrol akses ke Granola MCP melalui penyedia identitasnya (IdP). Pengguna masuk ke klien MCP mereka dengan akun perusahaan mereka, dan IdP memutuskan apakah mereka dapat terhubung ke Granola.

IdP Anda mengontrol siapa yang dapat terhubung. Pengaturan ruang kerja Granola mengontrol catatan mana yang dapat mereka akses.

Sebelum memulai

Anda memerlukan:

• Ruang kerja Granola Enterprise dengan SSO yang dikonfigurasi
• IdP dan klien MCP yang mendukung EMA (Granola telah menguji dengan Claude & Okta)
• Akses administrator ke ruang kerja Granola dan IdP Anda, atau bantuan dari admin terkait

Setiap pengguna seharusnya sudah memiliki akun Granola yang terkait dengan identitas perusahaan mereka. Jika mereka belum pernah menggunakan SSO perusahaan dengan Granola, minta mereka untuk masuk ke Granola dengan SSO sekali sebelum menggunakan EMA.

Konfigurasi EMA

1. Di Granola, buka Pengaturan → Ruang Kerja → Umum → Aplikasi & konektor → Akses MCP untuk anggota. Aktifkan akses catatan yang ingin diizinkan perusahaan Anda.
2. Di IdP Anda, tambahkan atau pilih Granola dan aktifkan kemampuan otorisasi terkelola atau server sumber dayanya.
3. Buat koneksi sumber daya terkelola dari klien MCP Anda ke Granola.
4. Masukkan nilai di bawah ini. IdP Anda mungkin menggunakan nama bidang yang berbeda atau menyimpulkan beberapa nilai secara otomatis.

Bidang	Nilai
URL Sumber Daya	https://mcp.granola.ai/mcp
URL Penerbit	https://mcp-auth.granola.ai
Audiens ID-JAG	https://mcp-auth.granola.ai
Cakupan	mcp
ID Klien di sumber daya	URL Dokumen Metadata ID Klien klien MCP

5. Tetapkan pengguna atau grup yang sesuai ke Granola dan klien MCP, lalu aktifkan koneksi sumber daya terkelola.

Dengan EMA, pengguna yang ditetapkan tidak menyelesaikan alur persetujuan OAuth Granola terpisah. Akses mereka tetap tunduk pada kebijakan IdP Anda dan akses MCP yang dikonfigurasi di Granola.

Jika perusahaan Anda membangun klien MCP sendiri

Granola mendukung klien rahasia yang mengautentikasi dengan private_key_jwt melalui Client ID Metadata Document (CIMD). Ini memungkinkan klien Anda mengautentikasi dengan pasangan kuncinya sendiri alih-alih rahasia klien yang diterbitkan oleh Granola.

Klien Anda harus mengimplementasikan ekstensi EMA MCP, mendapatkan ID-JAG dari IdP perusahaan, dan menerbitkan dokumen metadata HTTPS publik yang menyatakan private_key_jwt dan jwks_uri. Gunakan metadata OAuth Granola untuk menemukan kemampuan dan titik akhir yang didukung, dan gunakan penerbit yang diiklankan secara tepat sebagai audiens dari asersi klien.

Lihat spesifikasi EMA MCP untuk persyaratan protokol lengkap.

Contoh: Claude dan Okta

Granola telah menguji EMA dengan Claude dan Okta Cross App Access (XAA):

1. Di Okta, tambahkan integrasi Granola.
2. Buka tab Server sumber daya dan aktifkan Cross App Access (XAA).
3. Ikuti instruksi Okta untuk mengonfigurasi konektor server sumber daya antara Claude dan Granola.
4. Gunakan https://claude.ai/oauth/mcp-oauth-client-metadata sebagai ID Klien di sumber daya.

Alat dan deskripsi

Alat	Deskripsi	Contoh prompt
query_granola_meetings	Chat dengan Granola	Lihat contoh chat lengkap di sini
list_meeting_folders	Hanya paket berbayar — Daftar folder yang dapat Anda akses, termasuk ID folder, judul, deskripsi, dan jumlah catatan.	Folder rapat apa yang dapat saya akses?
list_meetings	Daftar catatan rapat yang dapat Anda akses, termasuk ID rapat, judul, tanggal, dan peserta. Dapat difilter berdasarkan folder pada paket berbayar.	Rapat apa yang saya miliki dengan Sam minggu lalu?
get_meetings	Baca catatan rapat yang dapat Anda akses, termasuk ID rapat, judul, tanggal, peserta, catatan pribadi, dan catatan ringkasan.	Apa item tindakan yang tersisa untuk setiap orang dalam proyek ini?
get_meeting_transcript	Hanya paket berbayar — Perbesar transkrip Anda, termasuk: ID rapat, transkrip mentah	Berikan kutipan spesifik tentang bagaimana tim menggambarkan masalah tersebut
get_account_info	Mengembalikan email dan ruang kerja aktif untuk akun Granola yang saat ini terhubung ke sesi MCP ini — berguna untuk mengonfirmasi bahwa Anda terhubung ke akun Granola yang benar ketika Anda memiliki beberapa (misalnya pribadi + kerja)	Akun Granola mana yang saya gunakan untuk masuk?

Panduan pemecahan masalah

Batas kecepatan akan bervariasi tergantung pada paket langganan Granola Anda dan alat MCP yang Anda gunakan. Batas kecepatan saat ini rata-rata sekitar 100 permintaan per menit di semua alat. Batas kecepatan dapat berubah.

Info

Jika Anda menggunakan paket Basic (Gratis), Anda hanya dapat mengkueri catatan dalam 30 hari terakhir.

Jika Anda mendapatkan pesan bahwa agen LLM Anda tidak dapat mengakses catatan rapat Anda atau menggunakan alat Granola MCP, coba autentikasi ulang. Jika Granola terhubung di Claude tetapi menampilkan **No tools available**, sambungkan kembali konektor Granola di Claude untuk mengatur ulang koneksi:

1. Buka [pengaturan konektor Claude](https://claude.ai/customize/connectors) di web. Anda harus melakukannya di claude.ai meskipun Anda menggunakan aplikasi desktop Claude.
2. Pilih **Granola**.
3. Klik menu tiga titik di pojok kanan atas.
4. Pilih **Disconnect**.
5. Tanpa menyegarkan halaman atau berpindah, pilih **Connect** lagi
   dan selesaikan autentikasi.

Info

Jika Anda menggunakan paket Claude Team atau Enterprise, Anda mungkin perlu admin workspace untuk memutuskan dan menyambungkan kembali Granola untuk Anda.

Jika Anda melihat kesalahan ini setelah menyelesaikan alur masuk OAuth, Anda mungkin telah melakukan autentikasi dengan alamat email yang berbeda dari email yang terdaftar pada akun Granola Anda.

Untuk memeriksa email yang digunakan akun Granola Anda, buka aplikasi Granola dan masuk ke **Settings** (<kbd>⌘</kbd> + <kbd>,</kbd> di macOS, <kbd>Ctrl</kbd> + <kbd>,</kbd> di Windows). Email akun Anda ditampilkan di bawah foto profil di kiri atas.

Saat menyambungkan kembali MCP, pastikan Anda masuk dengan alamat email yang sama selama alur OAuth.

Jika alat AI Anda mengatakan tidak dapat menemukan catatan apa pun, atau tidak mengembalikan hasil apa pun padahal Anda tahu Anda memiliki rapat, MCP mungkin terhubung ke akun Granola yang salah atau workspace yang salah dalam akun yang benar.

Tanyakan pada alat AI Anda: **"Dengan akun Granola mana saya masuk?"** Alat tersebut akan menggunakan alat `get_account_info` untuk mengembalikan email dan workspace aktif yang saat ini terhubung ke MCP. Lalu:

* **Email benar, workspace salah**: ganti workspace di aplikasi desktop Granola (klik nama workspace Anda di kiri atas dan pilih yang benar). MCP mengikuti workspace aktif Anda, sehingga kueri berikutnya akan menggunakannya.
* **Email sepenuhnya salah**: ikuti langkah-langkah di bagian **Signed into Claude with the wrong account** di bawah (atau yang setara untuk alat AI Anda) untuk memutuskan dan menyambungkan kembali dengan akun yang benar.

Berikut cara menyambungkan kembali Claude MCP dengan akun Granola yang berbeda:

1. Buka jendela penjelajahan incognito/pribadi dan masuk ke claude.ai.
2. Buka **Settings -> Connectors** dan putuskan sambungan Granola.
3. Masih dalam mode incognito, sambungkan kembali Granola. Ini akan meminta Anda masuk lagi, jadi gunakan email akun Granola utama Anda.
4. Setelah terhubung, kembali ke browser normal Anda dan seharusnya sudah berfungsi dengan akun yang benar.

Alasan pemutusan/penyambungan normal tidak memperbaiki ini adalah karena sesi Granola Anda yang ada tetap aktif, sehingga melewati langkah masuk. Mode incognito memaksa masuk baru, yang memungkinkan Anda memilih akun yang benar.

FAQ Umum

Tidak, Anda dapat menggunakan akun yang berbeda untuk alat AI dan Granola. Anda akan melakukan autentikasi akun Granola yang ingin diakses oleh alat AI Anda. Untuk memverifikasi email yang digunakan akun Granola Anda, buka aplikasi Granola dan masuk ke **Settings** (⌘ + , di macOS, Ctrl + , di Windows) — email akun Anda ditampilkan di bawah foto profil di kiri atas. Pertama, periksa cakupan akses mana yang berlaku untuk Anda:

* **Basic (Gratis):** Catatan pribadi dari 30 hari terakhir.
* **Business:** Catatan pribadi dan catatan publik.
* **Enterprise:** Admin workspace mengonfigurasi cakupan mana yang tersedia untuk anggota.

Akses catatan pribadi tidak mencakup setiap catatan pribadi di workspace. Catatan tersebut harus milik Anda, dibagikan langsung kepada Anda, atau berada di folder pribadi yang dibagikan kepada Anda. Akses catatan publik mencakup catatan yang terlihat oleh semua orang di workspace, termasuk catatan di ruang Tim.

MCP juga hanya mengembalikan catatan yang termasuk dalam workspace aktif. Jika catatan dibuat di workspace Granola lain, MCP tidak akan mengembalikannya dari workspace Anda saat ini, meskipun Anda dapat melihatnya di Granola.

Juga pastikan MCP terhubung ke akun dan workspace aktif yang benar dengan bertanya pada alat AI Anda: **"Dengan akun Granola mana saya masuk?"**

Ini seharusnya terjadi segera, dan Anda akan memiliki akses ke alat tambahan dan batas kecepatan yang ditingkatkan pada kueri berikutnya. Untuk koneksi OAuth browser standar, tidak. Granola MCP menggunakan Dynamic Client Registration (DCR), yang berarti kredensial ditangani secara otomatis. Anda tidak perlu membuat atau memasukkan client ID atau client secret apa pun.

Jika Anda menggunakan platform pihak ketiga (seperti Composio) yang menampilkan kolom client ID dan client secret, biarkan kosong — platform akan mendaftar dengan Granola secara otomatis saat Anda terhubung.

Pengaturan EMA berbeda. Penyedia identitas Anda mungkin meminta **Client ID at resource** saat membuat koneksi terkelola. Masukkan URL Dokumen Metadata Client ID dari klien MCP. Jika Anda menggunakan klien MCP yang sudah ada seperti Claude, gunakan URL yang disediakan oleh klien tersebut; Anda tidak perlu membuatnya sendiri atau memasukkan client secret.

Jika Anda membangun klien MCP rahasia Anda sendiri, Anda membuat dan menghosting Dokumen Metadata Client ID-nya. URL dokumen tersebut adalah client ID, dan klien melakukan autentikasi dengan kunci privatnya, bukan dengan client secret yang diterbitkan Granola. Lihat [Jika perusahaan Anda membangun klien MCP sendiri](#if-your-company-builds-its-own-mcp-client).

Ya — alat apa pun yang mengimplementasikan [spesifikasi klien MCP](https://modelcontextprotocol.io/) dengan transport Streamable HTTP dapat terhubung ke Granola MCP. Alat Anda dapat menggunakan OAuth browser, atau EMA jika mendukung ekstensi tersebut dan organisasi Anda telah mengonfigurasi IdP yang kompatibel. Lihat bagian "Alat AI lainnya" dan [Enterprise-Managed Authorization](#enterprise-managed-authorization) di atas.

Jika Anda membangun integrasi khusus dan memerlukan bantuan, hubungi [hey@granola.so](mailto:hey@granola.so).

FAQ Enterprise

Ya. Admin Enterprise dapat mengonfigurasi akses catatan yang tersedia untuk anggota workspace:

1. Buka **Settings → Workspace → General**.
2. Temukan **MCP access for members** di bawah **Apps & connectors**.
3. Klik **Manage**.
4. Aktifkan **Personal notes**, **Public notes**, keduanya, atau tidak keduanya.

Akses tergantung pada konfigurasi MCP workspace saat ini. Jika tidak ada cakupan yang diaktifkan, anggota tidak memiliki akses MCP sampai admin mengaktifkan catatan pribadi, catatan publik, atau keduanya. Kontrolnya ada di bawah **Settings → Workspace → General → Apps & connectors → MCP access for members**. Semua anggota workspace Enterprise dapat melihat pengaturan ini, tetapi hanya admin yang dapat mengubahnya. Jika Anda memerlukan cakupan lain diaktifkan, tanyakan pada admin workspace Anda. Tidak. Kontrol menentukan apa yang dapat diakses oleh anggota workspace non-admin melalui MCP. Admin Enterprise dapat mengakses catatan pribadi dan catatan publik melalui MCP.