Granola MCP

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

AI araçlarınızı Granola MCP ile Granola toplantı notlarınıza bağlayın. Bağlandıktan sonra şunları yapabilirsiniz: toplantı notlarınızda arama yapma, geçmiş toplantılarda tartışılan belirli konuları bulma, toplantı klasörlerine göz atma, notlarınızdan aksiyon maddeleri veya kararlar çıkarma, toplantı geçmişinize dayalı soruları yanıtlama 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 aşağıdaki erişim kapsamlarına tabi olarak, kullanıcının erişebildiği ve kullanıcının aktif Granola çalışma alanına ait notları döndürür.

Diğer Granola çalışma alanlarındaki notlar, paylaşım yoluyla aktif çalışma alanında 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ında sizinle paylaşılan özel klasörlerdeki notlar
Genel notlar	Aktif çalışma alanındaki herkes tarafından görülebilen 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ı kullandığını belirler:

Plan	MCP erişimi
Temel (Ücretsiz)	Son 30 günün 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 etkin değilse, üyeler Granola MCP'yi kullanamaz.

Bilgi

MCP, Granola uygulamasında seçilen 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ı
• Claude ve ChatGPT gibi MCP destekleyen AI aracı

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:

* [Akışkan HTTP taşıması](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) kullanan **MCP istemci protokolü**
* **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 çalışır; MCP için API anahtarı veya hizmet hesabı erişim yöntemi yoktur.

Bilgi

Komut dosyaları, otomasyonlar veya özel entegrasyonlar için API anahtarı erişimine ihtiyacınız varsa, bunun yerine Granola API bölümüne bakın.

Kurumsal Yönetimli Yetkilendirme

Kurumsal Yönetimli Yetkilendirme (EMA), şirketinizin kimlik sağlayıcısı (IdP) aracılığıyla Granola MCP'ye erişimi 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 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ı olmalıdır. Daha önce Granola ile şirket SSO'su kullanmadılarsa, EMA kullanmadan önce bir kez Granola'ya SSO ile oturum açmalarını isteyin.

EMA'yı yapılandırın

1. Granola'da Ayarlar → Çalışma Alanı → Genel → Uygulamalar ve bağlayıcılar → Üyeler için MCP erişimi bölümüne gidin. Ş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'si	https://mcp.granola.ai/mcp
Veren URL'si	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 bir 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 — Klasör kimliği, başlık, açıklama ve not sayısı dahil erişebildiğiniz klasörleri listeleyin.	Hangi toplantı klasörlerine erişimim var?
list_meetings	Toplantı kimliği, başlık, tarih ve katılımcılar dahil erişebildiğiniz toplantı notlarını listeleyin. Ücretli planlarda klasöre göre filtrelenebilir.	Geçen hafta Sam ile hangi toplantılarım oldu?
get_meetings	Toplantı kimliği, başlık, tarih, katılımcılar, özel notlar ve özetlenmiş notlar dahil erişebildiğiniz toplantı notlarını okuyun.	Bu projede her kişi için kalan aksiyon maddeleri nelerdir?
get_meeting_transcript	Yalnızca ücretli planlar — Transkriptlerinize yakınlaşın, şunları içerir: toplantı kimliği, ham transkript	Ekibin sorunu nasıl tanımladığına dair belirli alıntılar verin
get_account_info	Bu MCP oturumuna bağlı Granola hesabının e-postasını ve aktif çalışma alanını döndürür — birden fazla hesabınız olduğunda (örn. kişisel + iş) doğru Granola hesabına bağlandığınızı doğrulamak için yararlıdır	Hangi Granola hesabıyla oturum açtım?

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.

Bilgi

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

LLM aracınızın toplantı notlarınıza erişemediğine veya Granola MCP araçlarını kullanamadığına dair 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 Granola bağlayıcısını Claude'da 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 yapmanız gerekir.
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 tekrar **Bağlan**'ı seçin ve kimlik doğrulamayı tamamlayın.

Bilgi

Claude Team veya Enterprise planındaysanız, Granola'yı sizin için bağlantısını kesip yeniden bağlaması için bir çalışma alanı yöneticisi gerekebilir.

OAuth oturum açma akışını tamamladıktan sonra bu hatayı görürseniz, Granola hesabınızın kayıtlı olduğu e-posta adresinden 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 (macOS'ta <kbd>⌘</kbd> + <kbd>,</kbd>, Windows'ta <kbd>Ctrl</kbd> + <kbd>,</kbd>). 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ç 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 hesapta yanlış çalışma alanına bağlı olabilir.

AI aracınıza 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 üstteki ç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.
* **Tamamen yanlış e-posta**: Aşağıdaki **Claude'a yanlış hesapla oturum açıldı** akordeonundaki adımları izleyin (veya AI aracınızın eşdeğerini) ve doğru hesapla bağlantıyı kesip yeniden bağlayın.

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

1. Gizli/özel bir tarama penceresi açın ve claude.ai'ye oturum açın.
2. **Ayarlar -> Bağlayıcılar** bölümüne gidin ve Granola'nın bağlantısını kesin.
3. Hâlâ gizli moddayken Granola'yı yeniden bağlayın. Bu, tekrar oturum açmanızı isteyecektir, bu nedenle ana Granola hesap e-postanızı kullanın.
4. Bağlandıktan sonra normal tarayıcınıza geri dönün ve doğru hesapla çalışıyor olmalıdır.

Normal bir bağlantı kesme/yeniden bağlamanın bunu düzeltmemesinin nedeni, mevcut Granola oturumunuzun aktif kalması ve oturum açma adımını atlamasıdır. Gizli mod, doğru hesabı seçmenize olanak tanıyan yeni bir oturum açmayı zorlar.

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 kimlik doğrulamasını yaparsı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 ⌘ + ,, Windows'ta Ctrl + ,) — hesap e-postanız sol üstteki profil resminizin altında gösterilir. Öncelikle, hangi erişim kapsamlarının sizin için 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 not erişimi, çalışma alanındaki her özel notu içermez. Not sizin olmalı, sizinle doğrudan paylaşılmış olmalı veya sizinle paylaşılan özel bir klasörde bulunmalıdır. Herkese açık not erişimi, çalışma alanındaki herkesin görebildiği notları içerir; buna Ekip alanındaki notlar da dahildir.

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, Granola'da görebilseniz bile MCP onu mevcut çalışma alanınızdan döndürmez.

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

Bu anında gerçekleşmelidir 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 sırrı oluşturmanız veya girmeniz gerekmez.

İstemci kimliği ve istemci sırrı 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 kayıt olacaktı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, o istemcinin sağladığı URL'yi kullanın; kendiniz bir tane oluşturmanız veya bir istemci sırrı girmeniz gerekmez.

Kendi gizli MCP istemcinizi oluşturuyorsanız, İstemci Kimliği Meta Veri Belgesi'ni siz oluşturur ve barındırırsınız. Belgenin URL'si istemci kimliğidir ve istemci, Granola tarafından verilen bir istemci sırrı yerine özel anahtarıyla kimlik doğrular. Bkz. [Şirketiniz kendi MCP istemcisini oluşturuyorsa](#if-your-company-builds-its-own-mcp-client).

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önetimli 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](mailto: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 **Üyeler için 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.

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 etkinleştirene kadar üyelerin MCP erişimi yoktur. Kontroller **Ayarlar → Çalışma Alanı → Genel → Uygulamalar ve bağlayıcılar → Üyeler için 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. Hayır. Kontroller, 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.