Model Context Protocol (MCP), yapay zeka sistemleri ve mevcut dijital araçlarımızla etkileşim şeklimizde önemli bir gelişmeyi temsil eder. Anthropic tarafından tanıtılan MCP, Claude gibi büyük dil modellerinin çeşitli uygulamalarla doğrudan etkileşim kurmasını sağlayarak, yapay zeka asistanları ile günlük olarak kullandığımız üretkenlik araçları arasında kesintisiz iş akışları oluşturur. Özellikle güçlü bir entegrasyon, Claude'un Notion çalışma alanınızdaki içeriği benzeri görülmemiş bir hassasiyet ve kontrolle okumasına, yazmasına ve işlemesine olanak tanıyan Notion ile olandır.
Bu kılavuz, ilk yapılandırmadan pratik kullanım durumlarına kadar, kendi Notion MCP sunucunuzu kurma sürecinin tamamında size yol gösterecektir. Sonunda, Claude Desktop'un Notion çalışma alanınızla doğrudan etkileşim kurmasını sağlayan, içerik kaydetmenize, veritabanlarını sorgulamanıza ve çok daha fazlasını yapmanıza olanak tanıyan işlevsel bir sisteme sahip olacaksınız.
Notion MCP sunucunuzu kurarken, API geliştirme araç setinizi yükseltmeyi de düşünebilirsiniz. Apidog, tüm API yaşam döngüsünü kolaylaştıran kapsamlı bir özellik paketi sunarak Postman'e güçlü bir hepsi bir arada alternatif olarak öne çıkıyor.
Sezgisel arayüzü ile Apidog, API tasarımı, dokümantasyon, hata ayıklama, otomatik test ve sahtekarlık yeteneklerini tek bir işbirliğine dayalı platformda birleştirir. Birden fazla uygulama gerektiren geleneksel API araçlarının aksine, Apidog'un entegre ortamı tasarımdan test etmeye kadar kesintisiz iş akışları sağlar. Bu bütüncül yaklaşım yalnızca üretkenliği artırmakla kalmaz, aynı zamanda API ekosisteminizde tutarlılık sağlar.
Notion MCP sunucunuzla etkileşim kuracak API'ler oluşturan geliştiriciler için, Apidog'un sağlam istek oluşturma, ortam değişkenleri ve ekip işbirliği özellikleri, MCP destekli iş akışınızı tamamlayan mükemmel bir yardımcı araç haline getirir. Apidog'u geliştirme yığınına dahil ederek, Notion entegrasyonlarınızın omurgasını oluşturacak API'leri oluşturabilir, test edebilir ve belgeleyebilirsiniz.
MCP Sunucusu Nedir? Açıklaması
Kurulum sürecine dalmadan önce, MCP'nin aslında ne olduğunu anlayalım. Model Context Protocol, büyük dil modellerinin harici uygulamalarla yapılandırılmış, öngörülebilir bir şekilde etkileşim kurmasını sağlayan standartlaştırılmış bir çerçevedir. MCP, ne olması gerektiği hakkında basitçe metin üretmek yerine, yapay zeka sistemlerinin bağlı uygulamalar içinde aktif olarak işlemler gerçekleştirmesini sağlar.
Notion'a uygulandığında, bu şu anlama gelir: Claude şunları yapabilir:
- Yeni sayfalar oluşturun ve içerik ekleyin
- Mevcut sayfaları okuyun ve bilgi çıkarın
- Belirli kriterlere göre veritabanlarını sorgulayın
- İçeriği gerçek zamanlı olarak güncelleyin
- Talimatlarınıza göre bilgileri düzenleyin
Yapay zeka asistanınız ve Notion arasındaki bu iki yönlü iletişim, otomasyon, bilgi yönetimi ve gelişmiş üretkenlik için sayısız olanak sunar.
Önkoşullar
Notion MCP sunucunuzu kurmadan önce, şunlara sahip olduğunuzdan emin olun:
- Bilgisayarınızda yüklü Claude Desktop
- Yüklü Node.js (sürüm 16.0 veya üzeri)
- Terminal/komut satırı işlemleri hakkında temel bilgi
- Çalışma alanı erişimi olan bir Notion hesabı
Adım 1: MCP Notion Sunucusunu Kurma
MCP Notion sunucu deposunu klonlayarak başlayın. Bu depo, Claude ile Notion çalışma alanınız arasında bir köprü oluşturmak için gerekli kodu içerir.
Terminalinizi açın ve şunu çalıştırın:
git clone https://github.com/suekou/mcp-notion-server.git
Klonlanmış depoya gidin:
cd mcp-notion-server
Şimdi, gerekli bağımlılıkları yükleyin ve sunucuyu oluşturun:
npm install
npm run build
Bu, MCP sunucunuzu çalıştıracak derlenmiş JavaScript dosyalarını içeren bir yapı dizini oluşturacaktır.
Adım 2: Bir Notion Entegrasyonu Oluşturma
MCP sunucusunun Notion çalışma alanınıza erişmesine izin vermek için, bir Notion entegrasyonu oluşturmanız ve bir API belirteci oluşturmanız gerekir:
- Notion Entegrasyonları sayfasına gidin
- "Yeni Entegrasyon"a tıklayın
- Entegrasyonunuza anlamlı bir ad verin (örneğin, "Claude MCP")
- Bağlanmak istediğiniz çalışma alanını seçin
- Entegrasyon türünü "Dahili" olarak bırakın (varsayılan ayar)
- Entegrasyonu oluşturmak için "Gönder"e tıklayın
Oluşturulduktan sonra, entegrasyonun ayrıntılar sayfasına yönlendirileceksiniz. "Dahili Entegrasyon Belirteci"nin yanındaki "Göster"e ve ardından "Kopyala"ya tıklayarak belirtecinizi bulun. Bu belirteç, MCP sunucusunun Notion çalışma alanınıza erişmesine izin verecektir.
Önemli: Bu belirteci güvenli tutun ve asla kamuya açık olarak paylaşmayın, çünkü Notion içeriğinize erişim sağlar.
Adım 3: Claude Desktop'u Yapılandırma
Claude Desktop, MCP sunucu bağlantılarını yönetmek için bir yapılandırma dosyası kullanır. Bu dosyayı Notion MCP sunucunuzu içerecek şekilde düzenlemeniz gerekir:
Sisteminizdeki Claude Desktop yapılandırma dosyasını bulun:
- macOS'ta:
~/Library/ApplicationSupport/Claude/claude_desktop_config.json - Windows'ta:
%APPDATA%\Claude\claude_desktop_config.json
- Dosyayı bir metin düzenleyicide açın. Dosya henüz yoksa, aşağıdaki yapıyla oluşturun:
{
"mcpServers": {
"notion": {
"command": "node",
"args": [
"/full/path/to/mcp-notion-server/notion/build/index.js"
],
"env": {
"NOTION_API_TOKEN": "your_notion_api_token"
}
}
}
}
/full/path/to/mcp-notion-server/notion/build/index.js ifadesini, sisteminizdeki oluşturulmuş index.js dosyasının gerçek yoluyla değiştirin. Bu, yapı dizinindeki index.js dosyasının tam, mutlak yoludur.
your_notion_api_token ifadesini, Notion entegrasyon sayfasından kopyaladığınız belirteçle değiştirin.
Not: Yolda, Windows'ta bile eğik çizgiler (/) kullandığınızdan emin olun.
Adım 4: Entegrasyonunuzu Notion Sayfalarına Bağlama
Artık sunucunuz yapılandırıldığına göre, Notion entegrasyonunuzu Claude'un erişmesini istediğiniz belirli sayfalara bağlamanız gerekir:
- Yeni bir Notion sayfası oluşturun (veya mevcut bir sayfayı kullanın)
- Sayfanın sağ üst köşesindeki "..." öğesine tıklayın
- "Bağlantı ekle"yi seçin
- Listeden entegrasyonunuzu seçin
Bağlandıktan sonra, entegrasyonunuz (ve dolayısıyla Claude), bu sayfaya ve içindeki tüm alt sayfalara erişebilecektir.
Bu sayfayı Claude için tanımlamak için, URL'den sayfa kimliğini kopyalayın. Örneğin, sayfa URL'niz şu şekildeyse:
https://www.notion.so/myworkspace/example-page-1234567890abcdef1234567890abcdef
Sayfa kimliği son kısımdır: 1234567890abcdef1234567890abcdef
Adım 5: Claude'u Yeniden Başlatma ve Bağlantıyı Test Etme
Her şeyi yapılandırdıktan sonra:
- Claude Desktop şu anda çalışıyorsa kapatın
- Claude Desktop'u yeniden başlatın
- Claude arayüzündeki araçlar simgesine (çekiç sembolü) tıklayın
- Araçlar menüsünde "Sunucudan" altında "notion"un görünüp görünmediğini kontrol edin
"notion" görünüyorsa, MCP sunucunuz başarıyla bağlanmıştır. Değilse, yapılandırmanızı kontrol edin ve sunucunun düzgün bir şekilde kurulduğundan emin olun.
Artık Claude'u Notion'a Bağlayabilirsiniz!
Notion MCP sunucunuz kurulduğuna göre, bazı pratik uygulamaları keşfedelim:
İçeriği Notion'a Kaydetme
Claude'dan bir makale, özet veya notlar gibi herhangi bir içerik yazmasını isteyin. Ardından, Claude'dan bu içeriği Notion'a kaydetmesini şu şekilde isteyin:
Bu içeriği [your-page-id] ile Notion'a kaydetmek istiyorum
Claude, Notion aracını kullanma izni isteyecektir. Onayladıktan sonra, Claude belirtilen Notion sayfanızda içerikle yeni bir sayfa oluşturacaktır.
Notion Veritabanlarını Sorgulama
Claude'u Notion veritabanlarından belirli bilgileri çıkarmak için de kullanabilirsiniz:
- Notion'da bir veritabanı oluşturun (örneğin, derecelendirmeleri olan bir film veritabanı)
- Veritabanına bazı girişler ekleyin
- Entegrasyonunuzu veritabanını içeren sayfaya bağlayın
- Claude'a veritabanı hakkında "Bana ⭐️⭐️⭐️⭐️⭐️ derecelendirilmiş filmleri söyle" gibi sorular sorun
Claude, veritabanını sorgulayacak ve yalnızca kriterlerinize uyan girişleri döndürecektir.
Notion MCP Sunucu Kurulumunuzu Yapılandırın
Notion MCP kurulumunuza daha aşina oldukça, bu gelişmiş yapılandırma seçeneklerini göz önünde bulundurun:
Ortam Değişkenleri
claude_desktop_config.json dosyasında ek ortam değişkenleri ayarlayabilirsiniz:
"env": {
"NOTION_API_TOKEN": "your_token",
"NODE_ENV": "production",
"NOTION_DEBUG": "true"
}
NOTION_DEBUG değerini "true" olarak ayarlamak, sorun gidermeye yardımcı olabilecek daha ayrıntılı günlüğe kaydı etkinleştirecektir.
Birden Fazla MCP Sunucusu
Claude Desktop, aynı anda birden fazla MCP sunucusunun çalışmasını destekler. Örneğin, hem Notion hem de SQLite kullanmak isteyebilirsiniz:
{
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": [
"mcp-server-sqlite",
"--db-path",
"/Users/USERNAME/test.db"
]
},
"notion": {
"command": "node",
"args": [
"/Users/USERNAME/Desktop/mcp-notion-server/notion/build/index.js"
],
"env": {
"NOTION_API_TOKEN": "API_TOKEN"
}
}
}
}
Bu yapılandırma, Claude'un hem Notion hem de bir SQLite veritabanı ile etkileşim kurmasını sağlar.
Notion MCP Sunucusu için Yaygın Sorunları Giderme
Notion MCP sunucunuzla ilgili sorunlarla karşılaşırsanız, bu sorun giderme adımlarını deneyin:
Sunucu Claude'da Görünmüyor
claude_desktop_config.jsondosyanızda sözdizimi hataları olup olmadığını kontrol edinindex.jsdosyanızın yolunun doğru ve mutlak olduğundan emin olun- Notion API belirtecinizin geçerli olduğunu doğrulayın
- Yapılandırma değişiklikleri yaptıktan sonra Claude Desktop'u yeniden başlatın
API Belirteci Sorunları
- Kimlik doğrulama hataları görürseniz, yeni bir Notion API belirteci oluşturun
- Ortam değişkeni adının
NOTION_API_TOKEN(NOTION_API_KEYdeğil) olduğundan emin olun - Entegrasyonunuzun Notion sayfalarınıza düzgün bir şekilde bağlandığını kontrol edin
Bağlantı Sorunları
- Node.js'nin düzgün bir şekilde yüklendiğini doğrulayın (sürüm 16.0+)
- İnternet bağlantınızı kontrol edin
- Hiçbir güvenlik duvarının bağlantıyı engellemediğinden emin olun
- Bir VPN kullanıyorsanız, geçici olarak devre dışı bırakmayı düşünün
M1/M2 Mac Sorunları
M1 veya M2 Mac kullanıyorsanız ve bağlantı sorunları yaşıyorsanız:
- Rosetta 2'nin yüklü olduğundan emin olun
- Yapılandırmanızda Node'un tam yolunu belirtmeyi deneyin:
"command": "/opt/homebrew/bin/node",
MCP ve Notion Entegrasyonunun Geleceği
Anthropic MCP'yi geliştirmeye devam ettikçe, Notion ve diğer üretkenlik araçlarıyla daha gelişmiş entegrasyonlar bekleyebiliriz. Mevcut uygulama temel CRUD işlemlerine (Oluştur, Oku, Güncelle, Sil) izin verir, ancak gelecekteki sürümler şunları içerebilir:
- Notion'ın UI öğelerinin doğrudan manipülasyonu
- Daha gelişmiş veritabanı sorguları ve filtreleri
- Notion'ın yapay zeka özellikleriyle entegrasyon
- Birden fazla MCP özellikli aracı içeren uygulamalar arası iş akışları
Sonuç
Bir Notion MCP sunucusu kurmak, Claude aracılığıyla Notion çalışma alanınızla etkileşim kurmanın güçlü yeni yollarını açar. Bu kılavuzu izleyerek, Claude'un Notion sayfalarınızdan ve veritabanlarınızdan okuyup yazmasını sağlayan bir köprü oluşturdunuz, daha verimli iş akışları ve daha az bağlam değiştirme sağladınız.
Kurulum süreci birkaç teknik adım gerektirse de, ortaya çıkan entegrasyon, Claude'un zekasını Notion'ın organizasyonel yetenekleriyle birleştiren kesintisiz bir deneyim yaratır. Bu entegrasyonu keşfederken, özel ihtiyaçlarınıza göre uyarlanmış benzersiz kullanım durumları keşfetmeniz olasıdır.
MCP'nin hala gelişmekte olduğunu ve Anthropic'in ölçeklenebilirlik için merkezi olmayan bir barındırma modeline doğru ilerlediğini unutmayın. Bu, Notion MCP sunucusu gibi topluluk tarafından oluşturulan sunucuların, ekosistemde giderek daha önemli bir rol oynayacağı ve çok çeşitli uygulamalarla özelleştirilmiş entegrasyonlara olanak sağlayacağı anlamına gelir.
Kendi Notion MCP sunucunuzu kurarak, yalnızca üretkenliğinizi artırmakla kalmıyor, aynı zamanda gelecekte dijital araçlarımızla nasıl etkileşim kuracağımızı şekillendirecek yapay zeka destekli iş akışlarının evrimine katılıyorsunuz.
