# MCP entegrasyonu (/tr/docs/verdent-manager/configuration/mcp)
> Verdent'i Model Context Protocol sunucuları ve eklentileriyle genişletin
## MCP (Model Context Protocol) nedir? [#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ı [#mcp-entegrasyonunun-avantajları]
### Genişletilmiş yetenekler [#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 [#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 [#i̇ş-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 [#mcp-sunucularını-kurma]
### Yapılandırma süreci [#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 [#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 [#sunucu-durumu]
MCP ayarları panelinde bağlantı durumunu izleyin:
| Durum | Açıklama |
| ----------- | -------------------------------------------------- |
| **Success** | Sunucu bağlandı ve araçlar kullanılabilir |
| **Failed** | Bağlantı hatası (ayrıntıları görmek için tıklayın) |
| **Loading** | Sunucu başlatılıyor |
**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ı [#mcp-yapılandırması]
### Temel kurulum [#temel-kurulum]
**Konum:** Proje kökünde `.mcp.json` veya `~/.verdent/mcp.json` (global)
```json PostgreSQL Server
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://localhost:5432/myapp_dev"
]
}
}
}
```
```json GitHub Server
{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
```
```json Multiple Servers
{
"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 hakkında daha fazla bilgi:**
* [Model Context Protocol Specification](https://modelcontextprotocol.io/specification)
* [MCP Server Registry](https://mcp.so/servers) - Kullanılabilir MCP sunucularına göz atın
* [Official MCP Servers](https://github.com/modelcontextprotocol) - PostgreSQL, GitHub, Filesystem ve daha fazlası
***
## MCP eklentileri ve uzantıları [#mcp-eklentileri-ve-uzantıları]
### Kullanılabilir eklentiler [#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](https://mcp.so/servers) adresindeki topluluk kayıt defterine veya [resmi MCP sunucuları deposuna](https://github.com/modelcontextprotocol) 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 [#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-mcp-sunucusu-geliştirme]
### Özel sunucular oluşturma [#ö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](https://modelcontextprotocol.io/specification) 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ı [#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 [#desktopa-özgü-mcp-özellikleri]
### Proje bazında yapılandırma [#proje-bazında-yapılandırma]
| Yapılandırma düzeyi | Konum | Kapsam |
| ------------------- | ------------------------- | ------------------------------- |
| **Global** | `~/.verdent/mcp.json` | Tüm projeler |
| **Project** | Proje kökünde `.mcp.json` | Tek proje |
| **Worktree** | Projeden devralır | Proje yapılandırmasını devralır |
### Çoklu worktree MCP [#ç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 [#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 [#mcp-iş-akışı-örnekleri]
### Veritabanı sorgusu entegrasyonu [#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 [#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 [#cicd-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ı [#güvenlik-hususları]
### Kimlik doğrulama ve yetkilendirme [#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 [#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 [#mcp-entegrasyonu-sorun-giderme]
### Yaygın sorunlar [#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 [#yardım-alma]
**Destek kanalları:**
* Verdent desteği: [support@verdent.ai](mailto:support@verdent.ai)
* [MCP protokolü belgeleri](https://modelcontextprotocol.io)
* [Verdent Discord topluluğu](https://discord.com/invite/NGjXEZcbJq)
**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 [#sss]
MCP sunucu işlemleri, sonuçları işleyen modele göre kredi tüketir. MCP sunucusunun kendisi doğrudan kredi kullanmaz.
Hayır. MCP sunucuları proje başına değil, kullanıcı düzeyinde yapılandırılır. Yapılandırılan tüm sunucular tüm projelerinizde kullanılabilir.
mcp.json içindeki kimlik bilgileri makinenizde yerel olarak saklanır ve asla Verdent sunucularına gönderilmez. Hassas değerler için ortam değişkenlerini (`${VAR_NAME}`) kullanın.
MCP sunucuları gerektiğinde başlar ve oturumunuz boyunca çalışır. Verdent kapalıyken kaynak tüketmezler.
MCP sunucuları yapılandırdığınız izinlere sahiptir. Mümkün olduğunda salt okunur erişim kullanın ve yıkıcı işlemleri kısıtlayın.
Verdent'ten MCP sunucusundaki bir aracı kullanmasını isteyin. Başarılı yanıtlar bağlantının çalıştığını gösterir. Sorun yaşarsanız Sorun Giderme bölümüne bakın.