Granola MCP

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

Dokümantasyon Dizini

Tam dokümantasyon dizinini şu adresten alın: https://docs.granola.ai/llms.txt Daha fazla keşfe çıkmadan önce mevcut tüm sayfaları bulmak için bu dosyayı kullanın.

Granola MCP

Claude, ChatGPT ve diğer AI araçlarınızı MCP üzerinden Granola toplantı notlarınıza bağlayın. Notlarınızı sorgulayın, transkriptlerde arama yapın ve favori AI asistanlarınızda toplantı içgörüleri elde edin.

AI araçlarınızı Granola MCP ile Granola toplantı notlarınıza bağlayın. Bağlandıktan sonra bunu şunlar için kullanabilirsiniz: toplantı notlarınızda arama yapmak, geçmiş toplantılarda tartışılan belirli konuları bulmak, toplantı klasörlerine göz atmak, notlarınızdan aksiyon maddeleri veya kararlar çıkarmak, toplantı geçmişinize dayalı soruları yanıtlamak ve daha fazlası.

Granola, uyumlu kimlik sağlayıcıları ve MCP istemcileri için tarayıcı tabanlı OAuth ve Kurumsal Yönetimli Yetkilendirme (EMA) destekler.

MCP neleri erişebilir

Granola MCP, tarayıcı OAuth aracılığıyla bireysel bir kullanıcı olarak bağlanır. EMA ile kuruluşun kimlik sağlayıcısı erişimi bunun yerine yönetir. Her iki yöntem de kullanıcının erişebildiği ve kullanıcının aktif Granola çalışma alanına ait notları döndürür; aşağıdaki erişim kapsamlarına tabidir.

Diğer Granola çalışma alanlarındaki notlar, aktif çalışma alanında paylaşım yoluyla görünür olsalar bile dahil edilmez.

Erişim kapsamı	Neleri erişebilir
Kişisel notlar	Aktif çalışma alanında sahip olduğunuz notlar Aktif çalışma alanında sizinle doğrudan paylaşılan notlar Aktif çalışma alanındaki özel klasörlerde sizinle paylaşılan notlar
Genel notlar	Aktif çalışma alanındaki herkese görünür notlar Aktif çalışma alanının Ekip alanındaki notlar

Planınız ve çalışma alanı ayarlarınız MCP'nin hangi kapsamları kullanacağını belirler:

Plan	MCP erişimi
Temel (Ücretsiz)	Son 30 güne ait kişisel notlar. Bazı klasör, arama ve transkript araçları yalnızca ücretli planlarda kullanılabilir.
İş	Kişisel notlar ve genel notlar.
Kurumsal	Çalışma alanı yöneticileri, üyelerin kullanabileceği kapsamları yapılandırabilir. Hiçbir kapsam etkinleştirilmezse, üyeler Granola MCP'yi kullanamaz.

MCP, Granola uygulamasında seçili olan aktif çalışma alanını takip eder. Birden fazla çalışma alanına aitseniz, AI aracınıza başka bir soru sormadan önce Granola'da çalışma alanlarını değiştirin. MCP, birden fazla çalışma alanındaki notları birleştirmez.

Kurulum rehberi

Ön koşullar

• Mevcut toplantı notları olan bir Granola hesabı
• MCP'yi destekleyen bir AI aracı, örneğin Claude ve ChatGPT

Nasıl bağlanılır

1. Claude'u açın ve oturum açın

2. Ayarlar'a gidin

3. Bağlayıcılar'a gidin, Granola'yı arayın

4. Bağlanın, kimlik doğrulayın ve sohbet ederken açık olduğunuzdan emin olun

1. ChatGPT'yi açın ve oturum açın 2. Ayarlar'a gidin 3. 'Granola'yı arayın ve bağlanın 4. Artık ChatGPT'de toplantılarınıza atıfta bulunmak için @Granola yapabilir veya sadece sorabilirsiniz 1. Terminalinizde `claude` komutunu çalıştırın 2. Bu komutu çalıştırın:

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

3. Yeni bir terminal sekmesi açın ve `claude` komutunu tekrar çalıştırın
4. `/mcp` komutunu çalıştırın, granola MCP'yi seçin ve 'Kimlik Doğrula'yı seçin
5. Claude'dan toplantılarınıza atıfta bulunmasını isteyin

Genel URL'yi kullanarak Granola MCP'ye manuel olarak bağlanabilirsiniz{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) özel bir bağlantı olarak.

AI aracınız şunları desteklemelidir:

* **MCP istemci protokolü** [Streamable HTTP taşıması](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) kullanarak
* **OAuth 2.0 kimlik doğrulama ve meta veri keşfi** — standart bir bağlantı için, aracınız kullanıcının Granola'ya oturum açması için bir tarayıcı penceresi açabilmelidir. Oturum açtıktan sonra araç, sonraki isteklere dahil etmek üzere bir taşıyıcı belirteci alır.

Kurumsal istemciler, standart Granola oturum açma akışı yerine [Kurumsal Yönetimli Yetkilendirme](#enterprise-managed-authorization) kullanabilir. Her bağlantı yine de bireysel bir Granola kullanıcısı adına hareket eder; MCP için API anahtarı veya hizmet hesabı erişim yöntemi yoktur.

<Info>
  Komut dosyaları, otomasyonlar veya özel entegrasyonlar için API anahtarı erişimine ihtiyacınız varsa, bunun yerine [Granola API](./granola-api) bölümüne bakın.
</Info>

Kurumsal Yönetimli Yetkilendirme

Kurumsal Yönetimli Yetkilendirme (EMA), şirketinizin Granola MCP'ye erişimi kimlik sağlayıcısı (IdP) aracılığıyla kontrol etmesini sağlar. Kullanıcılar MCP istemcilerine şirket hesaplarıyla oturum açarlar ve IdP, Granola'ya bağlanıp bağlanamayacaklarına karar verir.

IdP'niz kimlerin bağlanabileceğini kontrol eder. Granola'nın çalışma alanı ayarları hangi notlara erişebileceklerini kontrol eder.

Başlamadan önce

Şunlara ihtiyacınız var:

• SSO yapılandırılmış bir Granola Kurumsal çalışma alanı
• EMA'yı destekleyen bir IdP ve MCP istemcisi (Granola, Claude ve Okta ile test etmiştir)
• Granola çalışma alanınıza ve IdP'nize yönetici erişimi veya ilgili yöneticilerden yardım

Her kullanıcının şirket kimliğiyle ilişkili bir Granola hesabı zaten olmalıdır. Daha önce Granola ile şirket SSO'sunu kullanmadılarsa, EMA'yı kullanmadan önce bir kez Granola'ya SSO ile oturum açmalarını isteyin.

EMA'yı yapılandırın

1. Granola'da, sol alt köşedeki çalışma alanı adınıza tıklayın, ardından Ayarlar'ı seçin. Ayarlar → Çalışma Alanı → Genel → Uygulamalar ve bağlayıcılar → MCP erişimi bölümüne gidin ve şirketinizin izin vermek istediği not erişimini etkinleştirin.
2. IdP'nizde Granola'yı ekleyin veya seçin ve yönetimli yetkilendirme veya kaynak sunucu özelliğini etkinleştirin.
3. MCP istemcinizden Granola'ya yönetimli bir kaynak bağlantısı oluşturun.
4. Aşağıdaki değerleri girin. IdP'niz farklı alan adları kullanabilir veya bazı değerleri otomatik olarak çıkarabilir.

Alan	Değer
Kaynak URL	https://mcp.granola.ai/mcp
Veren URL	https://mcp-auth.granola.ai
ID-JAG hedef kitlesi	https://mcp-auth.granola.ai
Kapsam	mcp
Kaynaktaki istemci kimliği	MCP istemcisinin İstemci Kimliği Meta Veri Belgesi URL'si

5. Uygun kullanıcıları veya grupları hem Granola'ya hem de MCP istemcisine atayın, ardından yönetimli kaynak bağlantısını etkinleştirin.

EMA ile atanan kullanıcılar ayrı bir Granola OAuth onay akışı tamamlamaz. Erişimleri hem IdP politikanıza hem de Granola'da yapılandırılan MCP erişimine tabidir.

Şirketiniz kendi MCP istemcisini oluşturuyorsa

Granola, bir İstemci Kimliği Meta Veri Belgesi (CIMD) aracılığıyla private_key_jwt ile kimlik doğrulayan gizli istemcileri destekler. Bu, istemcinizin Granola tarafından verilen bir istemci sırrı yerine kendi anahtar çiftiyle kimlik doğrulamasını sağlar.

İstemciniz MCP EMA uzantısını uygulamalı, şirketin IdP'sinden bir ID-JAG almalı ve private_key_jwt ve bir jwks_uri bildiren genel bir HTTPS meta veri belgesi yayınlamalıdır. Desteklenen yetenekleri ve uç noktaları keşfetmek için Granola'nın OAuth meta verilerini kullanın ve istemci iddiasının hedef kitlesi olarak tam olarak reklamı yapılan vereni kullanın.

Tam protokol gereksinimleri için MCP EMA spesifikasyonuna bakın.

Örnek: Claude ve Okta

Granola, EMA'yı Claude ve Okta Cross App Access (XAA) ile test etmiştir:

1. Okta'da Granola entegrasyonunu ekleyin.
2. Kaynak sunucu sekmesini açın ve Cross App Access (XAA) özelliğini etkinleştirin.
3. Claude ve Granola arasında kaynak sunucu bağlayıcısı yapılandırmak için Okta'nın talimatlarını izleyin.
4. Kaynaktaki istemci kimliği olarak https://claude.ai/oauth/mcp-oauth-client-metadata kullanın.

Araçlar ve açıklamalar

Araç	Açıklama	Örnek istemler
query_granola_meetings	Granola ile sohbet edin	Tam sohbet örneklerini burada görün
list_meeting_folders	Yalnızca ücretli planlar — Erişebildiğiniz klasörleri listeleyin; klasör kimliği, başlık, açıklama ve not sayısı dahil.	Hangi toplantı klasörlerine erişimim var?
list_meetings	Erişebildiğiniz toplantı notlarını listeleyin; toplantı kimliği, başlık, tarih ve katılımcılar dahil. Ücretli planlarda klasöre göre filtrelenebilir.	Geçen hafta Sam ile hangi toplantılarım oldu?
get_meetings	Erişebildiğiniz toplantı notlarını okuyun; toplantı kimliği, başlık, tarih, katılımcılar, özel notlar ve özetlenmiş notlar dahil.	Bu projedeki her kişi için kalan aksiyon maddeleri neler?
get_meeting_attachment	Bir toplantı sırasında paylaşılan ekranların ekran görüntülerini görüntüleyin; slaytlar, grafikler veya kod gibi.	Bugünkü incelemede fiyatlandırma slaytında ne vardı?
get_meeting_transcript	Yalnızca ücretli planlar — Transkriptlerinizi yakınlaştırın; toplantı kimliği, ham transkript dahil	Ekibin sorunu nasıl tanımladığına dair belirli alıntılar ver
get_account_info	Bu MCP oturumuna bağlı Granola hesabı için e-postayı, aktif çalışma alanını ve katılılan çalışma alanlarını döndürür — birden fazla hesabınız olduğunda (ör. kişisel + iş) doğru Granola hesabını bağladığınızı doğrulamak için kullanışlıdır	Hangi Granola hesabıyla oturum açtım?
switch_workspace	Yalnızca birden fazla çalışma alanına aitseniz kullanılabilir — Aktif Granola çalışma alanınızı değiştirin. Bu, Granola uygulamasında ve hesabınıza bağlı diğer AI araçlarında da değişiklik yapar.	Granola çalışma alanımı Acme olarak değiştir
sign_out	Bu AI aracını Granola hesabınızdan çıkış yapın. Farklı bir hesap kullanmak için Granola'yı daha sonra yeniden bağlayın.	Beni Granola'dan çıkış yap

Sorun giderme rehberi

Hız sınırları, Granola abonelik planınıza ve kullandığınız MCP aracına bağlı olarak değişir. Hız sınırları şu anda tüm araçlarda dakikada ortalama 100 istek civarındadır. Hız sınırları değişebilir.

<Info>
  Temel (Ücretsiz) plandaysanız, yalnızca son 30 gündeki notları
  sorgulayabilirsiniz.
</Info>

LLM aracınızın toplantı notlarınıza erişemediğini veya Granola MCP araçlarını kullanamadığını belirten bir mesaj alıyorsanız, yeniden kimlik doğrulamayı deneyin. Granola Claude'da bağlıysa ancak **Kullanılabilir araç yok** gösteriyorsa, bağlantıyı sıfırlamak için Claude'daki Granola bağlayıcısını yeniden bağlayın:

1. Web'de [Claude bağlayıcı ayarlarına](https://claude.ai/customize/connectors) gidin. Claude masaüstü uygulamasını kullansanız bile bunu claude.ai üzerinde yapmalısınız.
2. **Granola**'yı seçin.
3. Sağ üstteki üç nokta menüsüne tıklayın.
4. **Bağlantıyı kes**'i seçin.
5. Sayfayı yenilemeden veya başka bir yere gitmeden **Bağlan**'ı tekrar seçin
   ve kimlik doğrulamayı tamamlayın.

<Info>
  Claude Team veya Kurumsal plandaysanız, Granola'yı sizin için bağlantısını
  kesip yeniden bağlamak üzere bir çalışma alanı yöneticisine ihtiyacınız olabilir.
</Info>

OAuth oturum açma akışını tamamladıktan sonra bu hatayı görürseniz, Granola hesabınızın kayıtlı olduğu e-postadan farklı bir e-posta adresiyle kimlik doğrulamış olabilirsiniz.

Granola hesabınızın hangi e-postayı kullandığını kontrol etmek için Granola uygulamasını açın ve **Ayarlar**'a gidin (<kbd>⌘</kbd> + <kbd>,</kbd> macOS'ta, <kbd>Ctrl</kbd> + <kbd>,</kbd> Windows'ta). Hesap e-postanız sol üstteki profil resminizin altında gösterilir.

MCP'yi yeniden bağlarken, OAuth akışı sırasında aynı e-posta adresiyle oturum açtığınızdan emin olun.

AI aracınız hiçbir not bulamadığını söylüyorsa veya toplantılarınız olduğunu bildiğiniz halde sonuç döndürmüyorsa, MCP yanlış Granola hesabına veya doğru hesaptaki yanlış çalışma alanına bağlanmış olabilir.

AI aracınıza şunu sorun: **"Hangi Granola hesabıyla oturum açtım?"** Araç, MCP'ye bağlı e-postayı ve aktif çalışma alanını döndürmek için `get_account_info` aracını kullanacaktır. Ardından:

• Doğru e-posta, yanlış çalışma alanı: Granola masaüstü uygulamasında çalışma alanını değiştirin (sol alt köşedeki çalışma alanı adınıza tıklayın ve doğru olanı seçin). MCP, aktif çalışma alanınızı takip eder, bu nedenle bir sonraki sorgu onu kullanacaktır. Ayrıca AI aracınızdan sizin için çalışma alanlarını değiştirmesini isteyebilirsiniz, örneğin: "Granola çalışma alanımı [çalışma alanı adı] olarak değiştir."
• Tamamen yanlış e-posta: Aşağıdaki Claude'a yanlış hesapla oturum açıldı akordeonundaki adımları izleyin (veya AI aracınız için eşdeğerini) ve doğru hesapla bağlantıyı kesip yeniden bağlanın.

Farklı bir Granola hesabıyla Claude MCP'yi yeniden bağlamak için şu adımları izleyin:

1. Claude'dan Granola'dan çıkış yapmasını isteyin.
2. Size verdiği mcp-auth.granola.ai/api/logout bağlantısına tıklayın.
3. Claude'dan Granola'ya yeniden bağlanmasını isteyin ve ana Granola hesabı e-postanızla oturum açın.

Normal bir bağlantı kesme/yeniden bağlanmanın bunu düzeltmeme nedeni, mevcut Granola oturumunuzun aktif kalması ve oturum açma adımını atlamasıdır. Bağlantı üzerinden çıkış yapmak bu oturumu temizler ve doğru hesabı seçmenize olanak tanır.

Genel SSS

Hayır, AI aracınız ve Granola için farklı hesaplar kullanabilirsiniz. AI aracınızın erişmesini istediğiniz Granola hesabının kimliğini doğrularsınız. Granola hesabınızın hangi e-postayı kullandığını doğrulamak için Granola uygulamasını açın ve **Ayarlar**'a gidin (⌘ + , macOS'ta, Ctrl + , Windows'ta) — hesap e-postanız sol üstteki profil resminizin altında gösterilir. Öncelikle, sizin için hangi erişim kapsamlarının geçerli olduğunu kontrol edin:

• Temel (Ücretsiz): Son 30 güne ait kişisel notlar.
• İş: Kişisel notlar ve herkese açık notlar.
• Kurumsal: Çalışma alanı yöneticileri, üyeler için hangi kapsamların kullanılabilir olduğunu yapılandırır.

Kişisel notlara erişim, çalışma alanındaki her özel notu içermez. Not size ait olmalı, doğrudan sizinle paylaşılmış olmalı veya sizinle paylaşılan özel bir klasörde bulunmalıdır. Herkese açık notlara erişim, çalışma alanındaki herkesin görebildiği notları, Ekip alanındaki notlar dahil, içerir.

MCP ayrıca yalnızca aktif çalışma alanına ait notları döndürür. Bir not başka bir Granola çalışma alanında oluşturulduysa, MCP onu mevcut çalışma alanınızdan döndürmez, Granola'da görebilseniz bile.

Ayrıca, AI aracınıza sorarak MCP'nin doğru hesaba ve aktif çalışma alanına bağlı olduğunu doğrulayın: "Hangi Granola hesabıyla oturum açtım?"

Bu anında gerçekleşmeli ve bir sonraki sorgunuzda ekstra araçlara ve yükseltilmiş hız sınırlarına erişiminiz olacaktır. Standart bir tarayıcı OAuth bağlantısı için hayır. Granola MCP, Dinamik İstemci Kaydı (DCR) kullanır; bu, kimlik bilgilerinin otomatik olarak yönetildiği anlamına gelir. Herhangi bir istemci kimliği veya istemci gizli anahtarı oluşturmanız veya girmeniz gerekmez.

İstemci kimliği ve istemci gizli anahtarı alanları gösteren üçüncü taraf bir platform (Composio gibi) kullanıyorsanız, bunları boş bırakın — platform, bağlandığınızda Granola ile otomatik olarak kaydolacaktır.

EMA kurulumu farklıdır. Kimlik sağlayıcınız, yönetilen bağlantıyı oluştururken bir Kaynakta İstemci Kimliği isteyebilir. MCP istemcisinin İstemci Kimliği Meta Veri Belgesi URL'sini girin. Claude gibi mevcut bir MCP istemcisi kullanıyorsanız, bu istemcinin sağladığı URL'yi kullanın; kendiniz bir tane oluşturmanız veya bir istemci gizli anahtarı girmeniz gerekmez.

Kendi gizli MCP istemcinizi oluşturuyorsanız, İstemci Kimliği Meta Veri Belgesi'ni oluşturur ve barındırırsınız. Belgenin URL'si istemci kimliğidir ve istemci, Granola tarafından verilen bir istemci gizli anahtarı yerine özel anahtarıyla kimlik doğrular. Bkz. Şirketiniz kendi MCP istemcisini oluşturuyorsa.

Evet — Streamable HTTP aktarımıyla [MCP istemci spesifikasyonunu](https://modelcontextprotocol.io/) uygulayan herhangi bir araç Granola MCP'ye bağlanabilir. Aracınız tarayıcı OAuth kullanabilir veya uzantıyı destekliyorsa ve kuruluşunuz uyumlu bir IdP yapılandırdıysa EMA kullanabilir. Yukarıdaki "Diğer AI araçları" ve [Kurumsal Yönetilen Yetkilendirme](#enterprise-managed-authorization) bölümlerine bakın.

Özel bir entegrasyon oluşturuyorsanız ve yardıma ihtiyacınız varsa, hey@granola.so adresine ulaşın.

Kurumsal SSS

Evet. Kurumsal yöneticiler, çalışma alanı üyelerinin kullanabileceği not erişimini yapılandırabilir:

1. Ayarlar → Çalışma Alanı → Genel bölümüne gidin.
2. Uygulamalar ve bağlayıcılar altında MCP erişimi'ni bulun.
3. Yönet'e tıklayın.
4. Kişisel notlar, Herkese açık notlar, her ikisini veya hiçbirini etkinleştirin.

AI araçlarının toplantı transkriptlerini okumasını durdurmak için aynı iletişim kutusunda Toplantı transkriptleri'ni kapatın. Bu, çalışma alanınızdaki her toplantı için, erişebilen herkes için geçerlidir; yöneticiler ve bir notun paylaşıldığı kişiler dahil. Notlar ve özetler kullanılabilir kalır. Varsayılan olarak açıktır.

Erişim, çalışma alanının mevcut MCP yapılandırmasına bağlıdır. Hiçbir kapsam etkin değilse, bir yönetici kişisel notları, herkese açık notları veya her ikisini de etkinleştirene kadar üyelerin MCP erişimi yoktur. Kontroller **Ayarlar → Çalışma Alanı → Genel → Uygulamalar ve bağlayıcılar → MCP erişimi** altındadır. Tüm Kurumsal çalışma alanı üyeleri ayarı görebilir, ancak yalnızca yöneticiler değiştirebilir. Başka bir kapsamın etkinleştirilmesi gerekiyorsa, çalışma alanı yöneticinize sorun. Not erişim kontrolleri etkilemez. Bunlar, yönetici olmayan çalışma alanı üyelerinin MCP aracılığıyla neleri erişebileceğini belirler. Kurumsal yöneticiler, MCP aracılığıyla hem kişisel notlara hem de herkese açık notlara erişebilir.

Toplantı transkriptleri anahtarı, yöneticiler dahil herkes için geçerlidir.

Bu dokümantasyon, bir geliştirici dokümantasyon platformu olan Mintlify üzerinde oluşturulmuş ve barındırılmıştır.