Granola MCP

npx add-mcp 'https://mcp.granola.ai/mcp'

Indeks Dokumentasi

Ambil indeks dokumentasi lengkap di: https://docs.granola.ai/llms.txt Gunakan berkas ini untuk menemukan semua halaman yang tersedia sebelum menjelajah lebih lanjut.

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 sebagai gantinya. Kedua metode mengembalikan catatan yang dapat diakses pengguna dan milik workspace Granola aktif pengguna, sesuai dengan cakupan akses di bawah ini.

Catatan dari workspace Granola lain tidak disertakan, meskipun terlihat di workspace aktif melalui berbagi.

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

Paket dan pengaturan workspace Anda menentukan cakupan yang digunakan MCP:

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

MCP mengikuti workspace aktif yang dipilih di aplikasi Granola. Jika Anda tergabung dalam lebih dari satu workspace, alihkan workspace di Granola sebelum mengajukan pertanyaan lain ke alat AI Anda. MCP tidak menggabungkan catatan di beberapa workspace.

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 mengaktifkannya 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 kustom.

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 Enterprise dapat menggunakan [Enterprise-Managed Authorization](#enterprise-managed-authorization) sebagai ganti 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 kustom, lihat [Granola API](./granola-api) sebagai gantinya.
</Info>

Enterprise-Managed Authorization

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

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

Sebelum memulai

Anda memerlukan:

• Workspace Granola Enterprise dengan SSO yang dikonfigurasi
• IdP dan klien MCP yang mendukung EMA (Granola telah menguji dengan Claude & Okta)
• Akses administrator ke workspace 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, klik nama workspace Anda di sudut kiri bawah, lalu pilih Pengaturan. Buka Pengaturan → Workspace → Umum → Aplikasi & konektor → Akses MCP dan 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 Dokumen Metadata ID Klien (CIMD). Ini memungkinkan klien Anda mengautentikasi dengan pasangan kunci 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 mendeklarasikan 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 di 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 di proyek ini?
get_meeting_attachment	Lihat tangkapan layar dari layar yang dibagikan selama rapat, seperti slide, bagan, atau kode.	Apa yang ada di slide harga dalam tinjauan hari 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, workspace aktif, dan workspace yang diikuti 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 akun (misalnya pribadi + kerja)	Akun Granola mana yang saya gunakan untuk masuk?
switch_workspace	Hanya tersedia jika Anda tergabung dalam lebih dari satu workspace — Ubah workspace Granola aktif Anda. Ini juga mengubahnya di aplikasi Granola dan di alat AI lain yang terhubung ke akun Anda.	Alihkan workspace Granola saya ke Acme
sign_out	Keluarkan alat AI ini dari akun Granola Anda. Untuk menggunakan akun yang berbeda, hubungkan kembali Granola setelahnya.	Keluarkan saya dari Granola

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.
</Info>

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 **Tidak ada alat yang tersedia**, hubungkan 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 bahkan jika Anda menggunakan aplikasi desktop Claude.
2. Pilih **Granola**.
3. Klik menu tiga titik di kanan atas.
4. Pilih **Putuskan**.
5. Tanpa menyegarkan halaman atau menavigasi ke tempat lain, pilih **Hubungkan** lagi
   dan selesaikan autentikasi.

<Info>
  Jika Anda menggunakan paket Claude Team atau Enterprise, Anda mungkin memerlukan admin
  workspace untuk memutuskan dan menghubungkan kembali Granola untuk Anda.
</Info>

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

Untuk memeriksa email yang digunakan akun Granola Anda, buka aplikasi Granola dan buka **Pengaturan** (<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 menghubungkan 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 mengembalikan tanpa hasil padahal Anda tahu Anda memiliki rapat, MCP mungkin terhubung ke akun Granola yang salah atau workspace yang salah dalam akun yang benar.

Tanyakan ke alat AI Anda: **"Akun Granola mana yang saya gunakan untuk masuk?"** Ini 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 pojok kiri bawah dan pilih yang benar). MCP mengikuti workspace aktif Anda, jadi kueri berikutnya akan menggunakannya. Anda juga dapat meminta alat AI Anda untuk mengganti workspace untuk Anda, misalnya: "Ganti workspace Granola saya ke [nama workspace]."

• Email salah sepenuhnya: ikuti langkah-langkah di akordeon Masuk ke Claude dengan akun yang salah 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. Minta Claude untuk keluar dari Granola.
  2. Klik tautan mcp-auth.granola.ai/api/logout yang diberikannya.
  3. Minta Claude untuk menyambungkan kembali ke Granola, dan masuk dengan email akun Granola utama Anda.

  Alasan pemutusan/penyambungan ulang normal tidak memperbaiki ini adalah karena sesi Granola Anda yang ada tetap aktif, sehingga melewati langkah masuk. Keluar melalui tautan tersebut menghapus sesi itu, yang memungkinkan Anda memilih akun yang benar.

FAQ Umum

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

* **Dasar (Gratis):** Catatan pribadi dari 30 hari terakhir.
* **Bisnis:** Catatan pribadi dan catatan publik.
* **Perusahaan:** 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 dengan Anda, atau berada di folder pribadi yang dibagikan dengan 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 konfirmasikan bahwa MCP terhubung ke akun dan workspace aktif yang benar dengan bertanya ke alat AI Anda: **"Dengan akun Granola mana saya masuk?"**

Ini seharusnya terjadi segera, dan Anda akan memiliki akses ke alat tambahan dan batas kueri 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 klien MCP. Jika Anda menggunakan klien MCP yang 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 mengautentikasi dengan kunci privatnya daripada 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 [Otorisasi Terkelola Perusahaan](#enterprise-managed-authorization) di atas.

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

FAQ Perusahaan

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

1. Buka **Pengaturan → Workspace → Umum**.
2. Temukan **Akses MCP** di bawah **Aplikasi & konektor**.
3. Klik **Kelola**.
4. Aktifkan **Catatan pribadi**, **Catatan publik**, keduanya, atau tidak keduanya.

Untuk menghentikan alat AI membaca transkrip rapat, matikan **Transkrip rapat** di dialog yang sama. Ini berlaku untuk setiap rapat di workspace Anda, untuk semua orang yang dapat mengaksesnya, termasuk admin dan orang yang berbagi catatan. Catatan dan ringkasan tetap tersedia. Ini aktif secara default.

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. Kontrol berada di bawah **Pengaturan → Workspace → Umum → Aplikasi & konektor → Akses MCP**. Semua anggota workspace Perusahaan dapat melihat pengaturan, tetapi hanya admin yang dapat mengubahnya. Jika Anda memerlukan cakupan lain diaktifkan, tanyakan admin workspace Anda. Kontrol akses catatan tidak. Mereka menentukan apa yang dapat diakses anggota non-admin workspace melalui MCP. Admin Perusahaan dapat mengakses catatan pribadi dan catatan publik melalui MCP.

Sakelar **Transkrip rapat** berlaku untuk semua orang, termasuk admin.

Dokumentasi ini dibangun dan dihosting di Mintlify, platform dokumentasi pengembang.