Granola MCP

Granola MCP

Hubungkan Claude, ChatGPT, dan alat AI lainnya ke catatan rapat Granola Anda melalui MCP. Telusuri catatan Anda, cari 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 di seluruh 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 masih banyak lagi.

Saat ini kami hanya mendukung autentikasi melalui OAuth browser. Untuk bentuk autentikasi lainnya, silakan kirim masukan ke hey@granola.so.

Apa yang dapat diakses MCP

Granola MCP terhubung sebagai pengguna individu melalui OAuth browser. Ini mengembalikan catatan dari ruang kerja Granola aktif pengguna, sesuai dengan cakupan akses di bawah ini.

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

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 di paket berbayar.
Business	Catatan pribadi dan catatan publik.
Enterprise	Admin ruang kerja dapat mengonfigurasi cakupan mana yang tersedia untuk anggota. Jika tidak ada cakupan yang diaktifkan, anggota tidak dapat menggunakan Granola MCP.

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

Panduan penyiapan

Prasyarat

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

Cara menghubungkan

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 [Transport HTTP Streamable](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Autentikasi OAuth 2.0** — server menggunakan OAuth berbasis browser, jadi alat Anda harus dapat membuka jendela browser agar pengguna dapat masuk ke Granola. Setelah masuk, alat menerima token pembawa untuk disertakan dalam permintaan selanjutnya.

Setiap pengguna melakukan autentikasi secara individual melalui alur OAuth browser. 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 [API Granola](./granola-api) kami sebagai gantinya.
</Info>

Alat dan deskripsi

Alat	Deskripsi	Contoh prompt
query_granola_meetings	Mengobrol dengan Granola	Lihat contoh obrolan lengkap di sini
list_meeting_folders	Hanya paket berbayar — Cantumkan folder yang dapat Anda akses, termasuk ID folder, judul, deskripsi, dan jumlah catatan.	Folder rapat apa yang dapat saya akses?
list_meetings	Cantumkan 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 yang diringkas.	Apa item tindakan yang tersisa untuk setiap orang di proyek ini?
get_meeting_transcript	Hanya paket berbayar — Perbesar ke 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 Anda menghubungkan akun Granola yang tepat saat Anda memiliki banyak (misalnya pribadi + kantor)	Akun Granola mana yang saya gunakan untuk masuk?

Panduan pemecahan masalah

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

<Info>
  Jika Anda menggunakan paket Basic (Gratis), Anda hanya dapat menanyakan 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 menunjukkan **Tidak ada alat yang tersedia**, sambungkan kembali konektor Granola di Claude untuk mengatur ulang koneksi:

1. Buka [pengaturan konektor Claude](https://claude.ai/customize/connectors) di web. Anda harus melakukan ini di claude.ai meskipun 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 keluar, pilih **Hubungkan** lagi
   dan selesaikan autentikasi.

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

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

Untuk memeriksa email mana 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 gambar profil Anda 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 saat Anda tahu memiliki rapat, MCP mungkin terhubung ke akun Granola yang salah atau ruang kerja yang salah dalam akun yang tepat.

Tanyakan alat AI Anda: **"Akun Granola mana yang saya gunakan untuk masuk?"** Ini akan menggunakan alat `get_account_info` untuk mengembalikan email dan ruang kerja aktif yang saat ini terhubung ke MCP. Kemudian:

* **Email benar, ruang kerja salah**: ganti ruang kerja di aplikasi desktop Granola (klik nama ruang kerja Anda di kiri atas dan pilih yang tepat). MCP mengikuti ruang kerja aktif Anda, jadi kueri berikutnya akan menggunakannya.
* **Email sepenuhnya salah**: 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. Buka jendela penjelajahan pribadi/incognito dan masuk ke claude.ai.
2. Buka **Pengaturan -> Konektor** dan putuskan Granola.
3. Masih dalam mode incognito, sambungkan kembali Granola. Ini akan meminta Anda untuk masuk lagi, jadi gunakan email akun Granola utama Anda.
4. Setelah terhubung, kembali ke browser normal Anda dan itu seharusnya berfungsi dengan akun yang tepat.

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

FAQ Umum

Tidak, Anda dapat menggunakan akun yang berbeda untuk alat AI dan Granola Anda. Anda akan mengautentikasi akun Granola yang ingin Anda berikan akses ke alat AI Anda. Untuk memverifikasi email mana yang digunakan akun Granola Anda, buka aplikasi Granola dan buka **Pengaturan** (⌘ + , di macOS, Ctrl + , di Windows) — email akun Anda ditampilkan di bawah gambar profil Anda 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 ruang kerja mengonfigurasi cakupan mana yang tersedia untuk anggota.

Akses catatan pribadi tidak mencakup setiap catatan pribadi di ruang kerja. 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 ruang kerja, termasuk catatan di ruang Tim.

Juga konfirmasikan bahwa MCP terhubung ke akun yang benar dan ruang kerja aktif dengan bertanya ke alat AI Anda: **"Saya masuk dengan akun Granola yang mana?"**

Ini akan terjadi segera, dan Anda akan memiliki akses ke alat tambahan serta batas laju yang ditingkatkan pada kueri berikutnya. Tidak. Granola MCP menggunakan OAuth berbasis peramban dengan 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 ke Granola secara otomatis saat Anda terhubung.

Ya — alat apa pun yang mengimplementasikan [spesifikasi klien MCP](https://modelcontextprotocol.io/) dengan transport HTTP Streamable dapat terhubung ke Granola MCP. Alat Anda perlu menangani alur autentikasi peramban OAuth 2.0 sehingga setiap pengguna dapat masuk ke akun Granola mereka. Lihat bagian "Alat AI lainnya" di atas untuk detail teknis.

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

FAQ Perusahaan

Ya. Admin perusahaan dapat mengonfigurasi akses catatan yang tersedia untuk anggota ruang kerja:

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

Akses bergantung pada konfigurasi MCP ruang kerja saat ini. Jika tidak ada cakupan yang diaktifkan, anggota tidak memiliki akses MCP hingga admin mengaktifkan catatan pribadi, catatan publik, atau keduanya. Kontrolnya berada di bawah **Pengaturan → Ruang Kerja → Umum → Aplikasi & konektor → Akses MCP untuk anggota**. Semua anggota ruang kerja Perusahaan dapat melihat pengaturan tersebut, tetapi hanya admin yang dapat mengubahnya. Jika Anda memerlukan cakupan lain yang diaktifkan, tanyakan kepada admin ruang kerja Anda. Tidak. Kontrol tersebut menentukan apa yang dapat diakses oleh anggota ruang kerja non-admin melalui MCP. Admin perusahaan dapat mengakses catatan pribadi dan catatan publik melalui MCP.