MCP entegrasyonu

Neler öğreneceksiniz

Verdent for VS Code'daki Model Context Protocol (MCP) entegrasyonuna genel bakış; kurulum, yapılandırma ve genişletilebilirlik seçenekleri dahil.

MCP (Model Context Protocol) nedir?

Model Context Protocol (MCP), Verdent'in yeteneklerini harici araçlara, veri kaynaklarına ve hizmetlere bağlanarak genişleten bir entegrasyon sistemidir.

Temel kavram: MCP, Verdent'in yerleşik araç setinin ötesindeki sistemlerle etkileşime girmesini sağlayarak şunlarla sorunsuz entegrasyona olanak tanır:

• Harici API'ler ve web hizmetleri
• Veritabanı sistemleri
• Bulut platformları (AWS, Azure, GCP)
• Proje yönetimi araçları
• CI/CD ardışık düzenleri
• Özel dahili araçlar

Mimari: MCP sunucuları, Verdent ile harici sistemler arasında köprü görevi görür. Her MCP sunucusu, Verdent'in kodlama oturumları sırasında çağırabileceği belirli yetenekleri açığa çıkarır; tıpkı file_read veya bash gibi yerleşik araçlar gibi.

Yapılandırma depolama: MCP sunucu yapılandırmaları ~/.verdent/mcp.json içinde saklanır ve Ayarlar menüsü üzerinden yönetilir.

MCP entegrasyonunun faydaları

Genişletilmiş yetenekler

Harici sistemlere erişim: Verdent'i yerleşik işlevsellik aracılığıyla bulunmayan araçlara ve hizmetlere bağlayın. Kodlama iş akışınızdan ayrılmadan veritabanlarını sorgulayın, bulut hizmetleriyle etkileşime geçin veya projeye özgü API'leri entegre edin.

Özel araç geliştirme: Projenizin benzersiz gereksinimlerine uyarlanmış MCP sunucuları oluşturun. Dahili araçlar, özel API'ler veya alana özgü sistemler için özelleştirilmiş entegrasyonlar geliştirin.

Birlikte çalışabilirlik

Ekosistemden yararlanma: Büyüyen MCP ekosisteminden yararlanın. Topluluk tarafından geliştirilen MCP sunucuları, popüler araçlar ve hizmetler için hazır entegrasyonlar sunar.

Standartlaştırılmış protokol: MCP, araç entegrasyonu için tutarlı bir arabirim sağlayarak yeni yeteneklerin Verdent'in mevcut araç sistemiyle sorunsuz entegre olmasını güvence altına alır.

İş akışı otomasyonu

Sorunsuz entegrasyon: MCP sunucuları, Verdent'in araç setinin bir parçası haline gelir. Aracı, uygun olduğunda MCP araçlarını otomatik olarak kullanır veya belirli görevler için bunları açıkça çağırabilirsiniz.

Bağlam farkındalıklı işlemler: MCP entegrasyonları, kod tabanınızın bağlamını anlar ve mevcut geliştirme durumuna dayalı olarak harici sistemlerle akıllı etkileşimlere olanak tanır.

MCP sunucularını kurma

Yapılandırma süreci

MCP ayarlarına erişim:

1. Verdent içinde Ayarlar menüsünü açın
2. MCP Servers bölümüne gidin
3. ~/.verdent/mcp.json yapılandırmasını görüntüleyin veya değiştirin

Yapılandırma dosyası: MCP sunucuları, sunucu bağlantılarını, kimlik doğrulamayı ve entegrasyon parametrelerini tanımlayan ~/.verdent/mcp.json dosyası aracılığıyla yapılandırılır.

Yapılandırma yönetimi

Sunucu ekleme: mcp.json içine bağlantı ayrıntıları ve kimlik doğrulama bilgileriyle girişler ekleyerek yeni MCP sunucuları yapılandırın.

Birden çok sunucu: Verdent, aynı anda birden çok MCP sunucusunu destekler ve birkaç harici sistemle eş zamanlı entegrasyona olanak tanır.

Bağlantıları test etme: Geliştirme iş akışlarında kullanmadan önce başarılı bağlantıları sağlamak için MCP sunucu yapılandırmalarını doğrulayın.

MCP eklentileri ve uzantıları

Mevcut eklentiler

MCP eklentileri, yaygın araçlar ve hizmetler için hazır entegrasyonlar sunar.

Beklenen eklenti kategorileri:

• Veritabanı entegrasyonları: PostgreSQL, MySQL, MongoDB sorgu araçları
• Bulut hizmetleri: AWS, Azure, GCP API etkileşimleri
• Geliştirici araçları: GitHub, GitLab, Jira, Linear entegrasyonları
• CI/CD platformları: Jenkins, GitHub Actions, CircleCI
• İzleme hizmetleri: Datadog, New Relic, Sentry
• İletişim: Slack, Discord, Microsoft Teams bildirimleri

Eklenti kurulumu

Kurulum yöntemleri: Eklentiler, MCP Ayarlar arabirimi üzerinden kurulur ve yapılandırılır; genellikle şunlar gerekir:

• Eklenti tanımlayıcısı veya kaynağı
• Yapılandırma parametreleri
• Kimlik doğrulama bilgileri (varsa)

Bağımlılık yönetimi: MCP eklentilerinin harici hizmetlere veya kitaplıklara bağımlılıkları olabilir. Kurulum süreçleri mümkün olduğunda bağımlılık çözümünü otomatik olarak yönetir.

Özel MCP sunucu geliştirme

Özel sunucular oluşturma

İleri düzey kullanıcılar, özel araçları veya alana özgü sistemleri entegre etmek için özel MCP sunucuları oluşturabilir.

Geliştirme yaklaşımı: Özel MCP sunucuları, MCP protokol spesifikasyonunu uygulayarak Verdent'in çağırabileceği araç yeteneklerini açığa çıkarır.

Özel sunucular için kullanım senaryoları:

• Dahili API entegrasyonu: Şirkete özgü API'ler ve hizmetlere bağlanın
• Eski sistem köprüleri: Verdent'in eski altyapıyla etkileşime girmesini sağlayın
• Özel veri kaynakları: Özel veritabanlarına veya veri ambarlarına erişin
• İş akışı otomasyonu: Özel derleme, dağıtım veya test ardışık düzenlerini tetikleyin

Entegrasyon kalıpları

Çalışma alanı düzeyinde yapılandırma: MCP sunucuları, projeye özgü entegrasyonlar için çalışma alanı düzeyinde yapılandırılabilir ve ekiplerin MCP yapılandırmalarını sürüm kontrolü aracılığıyla paylaşmasına olanak tanır.

Araç birlikte çalışabilirliği: MCP tarafından sağlanan araçlar, Verdent'in yerleşik araçlarıyla (file_read, bash, spawn_subagent) sorunsuz entegre olur ve birden çok araç türünü birleştiren karmaşık iş akışlarına olanak tanır.

MCP iş akışı örnekleri

Veritabanı sorgu entegrasyonu

Senaryo: Veri sorunlarında hata ayıklamak için üretim veritabanını sorgulayın.

MCP yaklaşımı:

User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
        Results: 3 orders found for customer 12345
        [Displays formatted results]

MCP veritabanı sunucusu kimlik doğrulamayı, sorgu doğrulamayı ve sonuç biçimlendirmeyi yönetir.

Bulut hizmeti etkileşimi

Senaryo: Hatalar için AWS Lambda işlev günlüklerini kontrol edin.

MCP yaklaşımı:

User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
        [Retrieves CloudWatch logs for specified function]
        [Filters for ERROR level entries]
        [Presents formatted error summaries]

MCP AWS sunucusu kimlik doğrulamayı, API çağrılarını ve günlük ayrıştırmayı yönetir.

CI/CD ardışık düzen izleme

Senaryo: Değişiklikleri dağıtmadan önce derleme durumunu kontrol edin.

MCP yaklaşımı:

User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment

MCP CI/CD sunucusu ardışık düzen durumunu izler ve gerçek zamanlı geri bildirim sağlar.

Güvenlik konuları

Kimlik doğrulama ve yetkilendirme

Kimlik bilgisi yönetimi: MCP sunucuları harici hizmetlere kimlik doğrulamayı yönetir. Kimlik bilgileri MCP yapılandırmasında güvenli şekilde saklanır ve hiçbir zaman sohbet geçmişinde veya kodda açığa çıkarılmaz.

İzin kapsamı belirleme: MCP sunucularını gereken minimum izinlerle yapılandırın. Mümkün olduğunda salt okunur erişim kullanın ve yıkıcı işlemleri kısıtlayın.

Güvenli işlemler

Komut incelemesi: MCP araçlarını içeren işlemler, yürütmeden önce Manual Accept Mode içinde incelenebilir ve görünürlük ile kontrol sağlar.

Denetim günlüğü: MCP sunucu işlemleri Verdent'in sohbet geçmişinde görünür ve harici sistem etkileşimlerinin bir denetim izini oluşturur.

MCP entegrasyonunda sorun giderme

Yaygın sorunlar

Bağlantı hataları:

• MCP sunucusuna ağ bağlantısını doğrulayın
• mcp.json içindeki kimlik doğrulama bilgilerini kontrol edin
• MCP sunucusunun çalıştığından ve erişilebilir olduğundan emin olun
• Yapılandırma dosyası söz dizimini doğrulayın

İzin hataları:

• API anahtarlarının veya kimlik bilgilerinin gerekli izinlere sahip olduğunu onaylayın
• Hizmet kotalarını veya hız sınırlarını kontrol edin
• Güvenlik duvarı kurallarının MCP trafiğine izin verdiğini doğrulayın

Araç çağırma sorunları:

• MCP sunucusunun beklenen araçları doğru şekilde açığa çıkardığından emin olun
• Araç parametre biçimlerinin sunucu beklentileriyle eşleştiğini kontrol edin
• Hata ayrıntıları için MCP sunucu günlüklerini inceleyin

Yardım alma

Destek kanalları:

• Verdent desteği: support@verdent.ai
• MCP protokol belgeleri
• Gerçek zamanlı destek için Verdent Discord topluluğu

Tanılama bilgileri: MCP sorunlarını bildirirken şunları sağlayın:

• MCP sunucu türü ve sürümü
• Yapılandırma ayrıntıları (kimlik bilgilerinden arındırılmış)
• Sohbet geçmişindeki hata mesajları
• MCP sunucu günlükleri (erişilebilirse)

MCP belge kaynakları

Resmi belgeler

Yakında geliyor:

• Adım adım MCP sunucu kurulum kılavuzları
• Eklenti kurulum ve yapılandırma açıklamaları
• Özel sunucu geliştirme eğitimleri
• MCP entegrasyonu için en iyi uygulamalar
• MCP iş akışları için performans optimizasyonu

Ara dönem kaynakları

Güncel MCP bilgileri:

• MCP protokol spesifikasyonu (harici)
• Topluluk tarafından geliştirilen MCP sunucuları ve örnekleri
• MCP ekosistemi GitHub depoları

Ayrıntılar için iletişim: Anında MCP entegrasyon yardımı için belirli kullanım senaryonuz ve entegrasyon gereksinimlerinizle birlikte support@verdent.ai adresiyle iletişime geçin.

Ayrıca bkz.