Obsidian MCP Sunucusu Nasıl Kullanılır

Obsidian, bilgi yönetimi için popüler bir araç haline geldi ve Obsidian MCP Server ile artık bilgi tabanınızı doğrudan yapay zeka asistanlarına bağlayabilirsiniz. Obsidian için Model Context Protocol (MCP) sunucusu, yapay zeka araçlarının Obsidian kasalarınızla etkileşim kurmasını sağlayarak notları ve etiketleri okuma, oluşturma, düzenleme ve yönetme yetenekleri sunar. Bu entegrasyon, geliştiricilerin belgelerini nasıl düzenleyip erişebilecekleri konusunda önemli bir adım temsil ediyor.

Obsidian MCP Server'ı Bilgi Yönetimi için Anlamak

Obsidian MCP Server, Obsidian kasanız ile Claude gibi yapay zeka asistanları arasında bir bağlantı kurarak çalışır. Yapılandırıldıktan sonra, yapay zeka notlarınıza erişebilir, içerikte arama yapabilir ve hatta bilgi tabanınızı yönetmenize yardımcı olabilir. Bu işlevsellik, API spesifikasyonları ve geliştirme notları dahil olmak üzere projeleri hakkında kapsamlı belgeler tutan geliştiriciler için özellikle değerlidir.

Kurulum sürecine dalmadan önce, Obsidian MCP Server'ın kasanıza hem okuma hem de yazma erişimi olduğu için dikkatli bir şekilde ele alınması gerektiğini belirtmek önemlidir. Bu aracı kullanmadan önce her zaman Obsidian kasanızın yedeğini alın. Git gibi bir sürüm kontrol sistemi önerilir, ancak herhangi bir yedekleme yöntemi yeterli olacaktır. Araçlar test edilmiş olsa da, hala aktif geliştirme aşamasındadır ve değerli belgelerinize yazma erişimi verirken dikkatli olunması tavsiye edilir.

Sunucu, geliştirme araç setinize güçlü bir ekleme yapmasını sağlayan bir dizi özellik sunar:

• İçerik Erişimi: Kasanızdaki notları okuyun ve arayın
• İçerik Oluşturma: Gerektiğinde yeni notlar ve dizinler oluşturun
• İçerik Yönetimi: Mevcut notları düzenleyin, dosyaları taşıyın ve içeriği silin
• Etiket Organizasyonu: Kasanız genelinde etiket ekleyin, kaldırın ve yeniden adlandırın
• Arama Yetenekleri: Kasa içeriği genelinde kapsamlı aramalar yapın

Bu yetenekler, Obsidian MCP Server'ı, geliştirme süreci boyunca kapsamlı belgeleri koruması ve bunlara erişmesi gereken geliştiriciler için değerli bir araç haline getirir.

Obsidian MCP Server'ı Kurma: Adım Adım Kılavuz

Obsidian MCP Server'ı kurmak birkaç teknik adım gerektirir, ancak bu talimatları dikkatlice takip ederseniz süreç basittir. Sunucu, düzgün çalışması için Node.js 20 veya daha yüksek bir sürüm ve mevcut bir Obsidian kasası gerektirir.

Obsidian MCP Server için Manuel Kurulum Süreci

Obsidian MCP Server'ı kurmanın en güvenilir yolu, manuel yapılandırmadır. Bu yaklaşım, kurulum süreci üzerinde tam kontrol sağlar ve sunucunun belirli kasanıza düzgün bir şekilde bağlanmasını sağlar.

Claude Desktop yapılandırma dosyanızı bulun:

• macOS'ta: ~/Library/Application Support/Claude/claude_desktop_config.json konumuna gidin
• Windows'ta: Dosyayı %APPDATA%\Claude\claude_desktop_config.json konumunda bulun

MCP sunucu yapılandırmasını dosyanıza ekleyin:

{
   "mcpServers": {
       "obsidian": {
           "command": "npx",
           "args": ["-y", "obsidian-mcp", "/path/to/your/vault"]
       }
   }
}

Kasa yolunu değiştirin Obsidian kasanızın mutlak yolu ile:

• macOS/Linux için: /Users/kullanıcıadı/Documents/MyVault formatını kullanın
• Windows için: C:\\Users\\kullanıcıadı\\Documents\\MyVault formatını kullanın (çift ters eğik çizgilere dikkat edin)

Yapılandırma dosyasını kaydedin ve değişiklikleri uygulamak için Claude Desktop'u yeniden başlatın.

Bağlantıyı doğrulayın: Yeniden başlattıktan sonra, MCP sunucusunun başarıyla bağlandığını gösteren Claude Desktop'ta bir çekiç simgesi görmelisiniz.

Herhangi bir bağlantı sorunuyla karşılaşırsanız, şu konumdaki günlükleri kontrol edin:

• MacOS: ~/Library/Logs/Claude/mcp*.log
• Windows: %APPDATA%\Claude\logs\mcp*.log

Bu günlükler, sunucunun düzgün bir şekilde bağlanmasını engelleyebilecek şeyler hakkında değerli bilgiler sağlayabilir.

Smithery Aracılığıyla Alternatif Kurulum

Manuel kurulum çoğu kullanıcı için önerilirken, Obsidian MCP Server'ı Smithery kullanarak otomatik olarak da kurabilirsiniz. Bu yöntem bazı kullanıcılar için daha uygun olabilir, ancak manuel yaklaşım kadar kapsamlı bir şekilde test edilmemiştir.

Smithery aracılığıyla kurmak için, terminalinizde aşağıdaki komutu çalıştırın:

npx -y @smithery/cli install obsidian-mcp --client claude

Bu komut, MCP sunucusunu Claude Desktop ile kullanım için otomatik olarak yapılandıracaktır. Ancak, kurulumdan sonra yapılandırmanın doğru kasa yolunu gösterdiğini yine de doğrulamanız gerekir.

API Geliştirme için Obsidian MCP Server'dan Yararlanma

Obsidian MCP Server'ı başarıyla kurduktan sonra, API geliştirme iş akışınızı geliştirmek için kullanmaya başlayabilirsiniz. Sunucu, API belgeleriyle çalışan geliştiriciler için özellikle faydalı olabilecek çeşitli araçlar sağlar:

• read-note: Kasanızda saklanan API belgelerine erişin
• search-vault: Belgeleriniz genelinde belirli API uç noktalarını veya parametrelerini bulun
• create-note: API uç noktaları için yeni belgeler oluşturun
• edit-note: Uç noktalarınız geliştikçe mevcut API belgelerini güncelleyin
• manage-tags: API belgelerinizi tutarlı etiketleme ile düzenleyin

Bu araçlar, Obsidian'da kapsamlı API belgeleri tutmanıza ve geliştirme süreciniz sırasında doğrudan yapay zeka asistanları aracılığıyla erişmenize olanak tanır. Bu, özellikle kapsamlı belge gereksinimleri olan karmaşık API'lerle çalışırken iş akışınızı önemli ölçüde kolaylaştırabilir.

Ancak, Obsidian MCP Server genel bilgi yönetimi için değerli işlevsellik sağlarken, API geliştirme için özel özelliklerden yoksundur. İşte bu noktada, API geliştiricileri için özel olarak tasarlanmış daha güçlü bir alternatif olarak Apidog MCP Server devreye giriyor.

Apidog MCP Server: Yapay Zeka Destekli API Geliştirme için Üstün Çözüm

Obsidian MCP bilgi yönetimini geliştirirken, Apidog MCP Server özellikle API geliştirme yaşam döngüsünü kolaylaştırmaya odaklanır. Apidog tarafından geliştirilen bu MCP sunucusu, yapay zeka asistanlarını doğrudan API spesifikasyonlarınıza bağlayan bir köprü görevi görür. Spesifikasyonlarınız bir Apidog projesinde saklansa, çevrimiçi Apidog belgeleri olarak yayınlansa veya yerel/uzak OpenAPI/Swagger dosyaları olarak mevcut olsa da, Apidog MCP Server bunları yapay zekaya erişilebilir hale getirir.

Bu bağlantı, API destekli geliştirme için dönüştürücüdür. API gereksinimlerini manuel olarak koda çevirmek veya sürekli olarak belgelere başvurmak yerine, geliştiriciler yapay zekaya bu görevleri doğrudan API spesifikasyonunu tek gerçek kaynak olarak kullanarak gerçekleştirmesini emredebilir. Bu, hataları önemli ölçüde azaltır, tutarlılığı sağlar ve geliştirme sürecini hızlandırır. Yapay zekanın önerilerini ve oluşturduğu kodu, API'nizin gerçek tasarımına sıkı bir şekilde dayandırarak yapay zeka kodlamasının kalitesini artırır.

Apidog MCP Server'ın Temel Yetenekleri

Apidog MCP Server, yapay zekayı API'lerinizle ilgili derin anlayış ve etkileşim yetenekleriyle güçlendirir:

• Spesifikasyon Farkındalığı: Sunucu, API spesifikasyon verilerini yerel olarak okur ve önbelleğe alır, böylece yapay zeka uç noktaları, şemaları, parametreleri ve açıklamaları sorgulayabilir.
• Kod Oluşturma: API spesifikasyonuna göre istemci/sunucu kod parçacıkları, veri aktarım nesneleri (DTO'lar), kayıt türleri veya tüm denetleyiciler oluşturun. Örnek: "Sipariş' şeması için Java kayıtları oluşturmak için MCP'yi kullanın."
• Kod Değişikliği: API spesifikasyonundaki değişiklikleri yansıtacak şekilde mevcut kodu (DTO'lar veya hizmet arayüzleri gibi) güncelleyin. Örnek: "API spesifikasyonuna göre, 'Sipariş' DTO'suna MCP kullanarak 'indirimKodu' alanını ekleyin."
• Belge Yardımı: API spesifikasyonundaki açıklamalara göre koda yorumlar veya belge blokları ekleyin. Örnek: "MCP aracılığıyla API spesifikasyonuna göre 'ProductService' yöntemlerine Javadoc yorumları ekleyin."
• Akıllı Arama: Belirli uç noktalar, şemalar veya alanlar için API spesifikasyonunda arama yapın.

Not: Spesifikasyonlar önbelleğe alındığından, API tasarımınızı Apidog'da güncellerseniz, yapay zekadan en son sürümle çalıştığından emin olmak için MCP veri kaynağını yenilemesini istemeyi unutmayın.

Apidog MCP Server'ı Kurma: Kapsamlı Bir Kılavuz

Apidog MCP Server, farklı geliştirme ihtiyaçlarını karşılamak için esnek yapılandırma seçenekleri sunar. Sunucu, iş akışınıza en uygun yaklaşımı seçmenize olanak tanıyan üç ana veri kaynağını destekler.

Apidog MCP Server için Önkoşullar

Apidog MCP Server'ı kurmadan önce, şunlara sahip olduğunuzdan emin olun:

• Node.js sürüm 18 veya daha yüksek (en son LTS sürümü önerilir)
• Cursor veya Cline eklentisiyle VS Code gibi MCP'yi destekleyen bir IDE

1. Seçenek: Veri Kaynağı Olarak Apidog Projesi Kullanma

Bu yaklaşım, yapay zekayı Apidog ekibinizdeki API spesifikasyonlarına erişmek için kullanmak istediğinizde idealdir.

Bir API Erişim Jetonu Oluşturun:

• Apidog'u açın ve Hesap Ayarları → API Erişim Jetonu'na gidin
• Yeni bir API erişim jetonu oluşturun

Apidog Proje Kimliğinizi Alın:

• Hedef projenizi Apidog'da açın
• Sol kenar çubuğunda "Proje Ayarları"na tıklayın
• "Temel Ayarlar"dan Proje Kimliğini kopyalayın

IDE'nizde MCP'yi Yapılandırın:

• IDE'nizin MCP yapılandırmasını açın
• Aşağıdaki yapılandırmayı ekleyin (yer tutucuları gerçek değerlerinizle değiştirerek):

{
 "mcpServers": {
   "API specification": {
     "command": "npx",
     "args": [
       "-y",
       "apidog-mcp-server@latest",
       "--project=<project-id>"
     ],
     "env": {
       "APIDOG_ACCESS_TOKEN": "<access-token>"
     }
   }
 }
}

Yapılandırmayı doğrulayın yapay zekadan MCP aracılığıyla API spesifikasyonlarını getirmesini isteyerek

2. Seçenek: Veri Kaynağı Olarak Çevrimiçi API Belgelerini Kullanma

Bu yaklaşım, Apidog aracılığıyla yayınlanan genel kullanıma açık API belgelerine erişmeniz gerektiğinde iyi sonuç verir.

MCP Hizmetini Etkinleştirin:

• Apidog projenize gidin
• Belgeleri Paylaş → Belgeleri Sitelerde Yayınla → LLM dostu Özellikler'e gidin
• "MCP" hizmetini etkinleştirin

Yapılandırma Dosyasını Alın:

• Çevrimiçi belgelerinize erişin
• "Vibe Coding(via MCP)" düğmesine tıklayın
• Sağlanan yapılandırmayı kopyalayın

IDE'nizde MCP'yi Yapılandırın kopyalanan yapılandırmayı kullanarak:

{
 "mcpServers": {
   "apidog-site-123456": {
     "command": "npx",
     "args": [
       "-y",
       "apidog-mcp-server@latest",
       "--site-id=123456"
     ]
   }
 }
}

Bağlantıyı test edin yapay zekadan MCP aracılığıyla API belgelerini getirmesini isteyerek

3. Seçenek: Veri Kaynağı Olarak Swagger/OpenAPI Dosyalarını Kullanma

Bu seçenek, Apidog projelerinden bağımsız olarak yerel veya çevrimiçi Swagger/OpenAPI dosyalarıyla çalışmak için mükemmeldir.

OpenAPI Dosyanızı Hazırlayın:

• Bir Swagger/OpenAPI dosyasına bir URL'niz veya yerel yolunuz olduğundan emin olun
• Desteklenen formatlar arasında JSON ve YAML bulunur

IDE'nizde MCP'yi Yapılandırın:

• Aşağıdaki yapılandırmayı ekleyin (yer tutucuyu gerçek dosya yolunuz veya URL'nizle değiştirerek):

{
 "mcpServers": {
   "API specification": {
     "command": "npx",
     "args": [
       "-y",
       "apidog-mcp-server@latest",
       "--oas=https://petstore.swagger.io/v2/swagger.json"
     ]
   }
 }
}

Yapılandırmayı doğrulayın yapay zekadan MCP aracılığıyla API belgelerini getirmesini isteyerek

Sonuç: MCP Sunucularıyla Geleceği Kucaklamak

Obsidian MCP Server ve Apidog MCP Server gibi Model Context Protocol sunucuları, insan-yapay zeka işbirliğinde önemli bir sıçramayı temsil eder. Genel yapay zeka asistanları ile günlük olarak kullandığımız belirli araçlar ve veri kaynakları arasındaki engelleri yıkarak, daha kişiselleştirilmiş ve verimli iş akışlarının önünü açıyorlar.

Obsidian MCP Server, kullanıcıların kişisel bilgi tabanlarını etkileşimli bir ortama dönüştürmelerini sağlayarak, yapay zekanın Obsidian kasalarında bilgi düzenlemede, alıp getirmede ve hatta oluşturmada yardımcı olmasına olanak tanır. Bu, proje belgelerini yöneten geliştiriciler dahil olmak üzere, yapılandırılmış notlara güvenen herkesin verimliliğini artırır.

Geliştirme ekipleri için, Apidog MCP Server, API geliştirme yaşam döngüsünü hızlandırmak için hedeflenmiş bir çözüm sunar. Yapay zekaya doğrudan API spesifikasyonlarına erişim sağlayarak, Apidog gerçekten API destekli geliştirmeyi mümkün kılar. Bu, daha hızlı kodlamaya, gelişmiş doğruluğa, daha fazla tutarlılığa ve sonuç olarak daha yüksek kaliteli yazılıma yol açar. Modern asistanların yapay zeka kodlama yetenekleri, ekibinizin Apidog MCP bağlantılı API'lerinin belirli bağlamına dayandırıldığında önemli ölçüde daha güçlü hale gelir.