MCP entegrasyonu

MCP (Model Context Protocol) nedir?

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

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

• Harici API'ler ve web hizmetleri
• Veritabanı sistemleri
• Bulut platformları (AWS, Azure, GCP)
• Proje yönetim araçları
• CI/CD hatları
• Ö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 sunar; bu, file_read veya bash gibi yerleşik araçlara benzer.

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

MCP entegrasyonunun avantajları

Genişletilmiş yetenekler

Harici sistemlere erişim: Verdent'i yerleşik işlevsellik üzerinden erişilemeyen araçlara ve hizmetlere bağlayın. Kodlama iş akışınızdan çıkmadan veritabanlarını sorgulayın, bulut hizmetleriyle etkileşime girin veya projeye özgü API'leri entegre edin.

Özel araç geliştirme: Projenizin benzersiz gereksinimlerine uygun 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 ekosistemine erişin. 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 arayüz sağlar ve yeni yeteneklerin Verdent'in mevcut araç sistemiyle sorunsuz entegre olmasını sağlar.

İş akışı otomasyonu

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

Bağlama duyarlı işlemler: MCP entegrasyonları kod tabanınızın bağlamını anlar ve mevcut geliştirme durumuna göre harici sistemlerle akıllı etkileşimlere olanak tanır.

MCP sunucularını kurma

Yapılandırma süreci

MCP ayarlarına erişme:

1. Verdent'te 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ğrulamasını ve entegrasyon parametrelerini tanımlayan ~/.verdent/mcp.json dosyası aracılığıyla yapılandırılır. Tam şema için aşağıdaki MCP yapılandırması bölümüne bakın.

Yapılandırma yönetimi

Sunucu ekleme: Yeni MCP sunucularını mcp.json dosyasına bağlantı ayrıntıları ve kimlik doğrulama bilgileriyle giriş ekleyerek yapılandırın.

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

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

Sunucu durumu

MCP ayarları panelinde bağlantı durumunu izleyin:

Araçları yenileme: Yapılandırma değişikliklerinden veya bağlantı sorunlarından sonra bir sunucudan kullanılabilir araçları yeniden keşfetmek için yenile düğmesine tıklayın.

MCP yapılandırması

Temel kurulum

Konum: Proje kökünde .mcp.json veya ~/.verdent/mcp.json (global)

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    }
  }
}

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Yapılandırma anahtarları:

• mcpServers - MCP yapılandırması için gerekli üst düzey anahtar
• command - Çalıştırılacak yürütülebilir dosya (Node.js paketleri için genellikle npx)
• args - Komuta iletilen argümanlar (paket adı, bağlantı dizeleri vb.)
• env - Kimlik doğrulama/yapılandırma için ortam değişkenleri

MCP eklentileri ve uzantıları

Kullanılabilir eklentiler

MCP eklentileri, yaygın araçlar ve hizmetler için hazır entegrasyonlar sunar. Güncel kullanılabilirlik için mcp.so/servers adresindeki topluluk kayıt defterine veya resmi MCP sunucuları deposuna göz atın.

Yaygın 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ı arayüzü ü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ümlemesini otomatik olarak gerçekleştirir.

Özel MCP sunucusu 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 belirtimini uygular ve Verdent'in çağırabileceği araç yeteneklerini sunar. Uygulama ayrıntıları ve SDK'lar için Model Context Protocol belirtimine bakın.

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

• Dahili API entegrasyonu: Şirkete özel API'lere 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 hatlarını 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 fazla araç türünü birleştiren karmaşık iş akışlarına olanak tanır.

Desktop'a özgü MCP özellikleri

Proje bazında yapılandırma

Çoklu worktree MCP

MCP sunucuları worktree'ler arasında çalışır:

• Paylaşılan sunucular: Temel çalışma alanı MCP yapılandırması tüm worktree'ler tarafından paylaşılır
• Yalıtılmış işlemler: Her worktree ayrı bir MCP oturum durumu tutar
• Paralel erişim: Birden fazla worktree aynı MCP sunucularını eşzamanlı olarak kullanabilir

Proje değiştirme

Projeler arasında geçiş yaparken:

• Mevcut projenin MCP sunucuları yüklenir
• Global MCP sunucuları kullanılabilir kalır
• Önceki projenin MCP bağlantıları arka planda korunur

MCP iş akışı örnekleri

Veritabanı sorgusu entegrasyonu

Senaryo: Veri sorunlarını ayıklamak için üretim veritabanını sorgulama.

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

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 hattı izleme

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

MCP yaklaşımı:

User: "Is the master 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 hat durumunu izler ve gerçek zamanlı geri bildirim sağlar.

Güvenlik hususları

Kimlik doğrulama ve yetkilendirme

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

İzin kapsamı belirleme: MCP sunucularını gerekli 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 konuşma geçmişinde görünür 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 entegrasyonu 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 doğrulayı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 sunduğundan 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
• 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)

SSS