---
title: Entegrasyon iş akışları
description: Verdent ile harici araç ve hizmetleri entegre etmeye yönelik pratik desenler
---



### Neler öğreneceksiniz

Gerçek dünya geliştirme senaryoları için özel alt aracıları, kuralları ve MCP sunucularını birleştiren pratik entegrasyon iş akışları.

---

## Entegrasyon yöntemleri

| Yöntem | En uygun olduğu durum | Yapılandırma |
|--------|----------|---------------|
| **Özel alt aracılar** | Yapay zeka destekli özel görevler | `~/.verdent/subagents/*.md` |
| **Kurallar (AGENTS.md)** | Ekip standartları ve davranışı | Proje kök `AGENTS.md` |
| **MCP sunucuları** | Protokole uyumlu harici araçlar | `.mcp.json` (proje kökü) |

**Felsefe:** İhtiyaçlarınıza göre uyarlanmış kapsamlı iş akışları oluşturmak için yöntemleri birleştirin.

---

## Yaygın entegrasyon desenleri

### Veritabanı geliştirme iş akışı

**Yığın:** Migration Reviewer alt aracısı + AGENTS.md standartları + PostgreSQL MCP sunucusu

**Alt aracı:**
```markdown
---
name: migration-reviewer
description: Reviews database migrations for safety
---
Checks: Destructive operations, reversibility, indexing, blocking operations
```

**AGENTS.md:**
```markdown
## Database Standards
- All migrations reviewed by @migration-reviewer
- Test on staging before production
- Include rollback procedures
```

**MCP:** Sorgu yürütme, şema incelemesi ve migration doğrulaması için PostgreSQL sunucusu

**İş akışı:** Migration yaz → @migration-reviewer doğrular → MCP staging üzerinde test eder → PR belgeleme

---

### Güvenlikle birlikte API geliştirme

**Yığın:** Security Auditor + AGENTS.md kuralları + özel API test aracı

**Bileşenler:**
- **Alt aracı:** `@api-security-auditor` - Giriş doğrulaması, SQL enjeksiyonu, kimlik doğrulama, hız sınırlama
- **Kurallar:** Tüm uç noktalar güvenlik incelemesi gerektirir, herkese açık API'lerde hız sınırlama
- **Harici araçlar:** Özel entegrasyon aracılığıyla otomatik uç nokta testi ve güvenlik taramaları

**Sonuç:** PR onayından önce otomatik güvenlik incelemesi.

<Note>
API test ve güvenlik tarama araçları, araç setinize bağlı olarak özel MCP sunucu uygulamaları veya diğer entegrasyon yöntemleri aracılığıyla entegre edilebilir.
</Note>

---

### Frontend erişilebilirliği

**Yığın:** Accessibility Auditor + WCAG kuralları + Lighthouse entegrasyonu

**İş akışı:**
```
Create component → @a11y-auditor reviews → Lighthouse tests accessibility → Rules enforce >90 score
```

<Note>
Lighthouse ve diğer erişilebilirlik araçları, iş akışınıza bağlı olarak özel MCP sunucuları veya CI/CD pipeline entegrasyonu aracılığıyla entegre edilebilir.
</Note>

---

## MCP yapılandırma örnekleri

### MCP'i anlamak

**Model Context Protocol (MCP)**, uygulamaların LLM'lere nasıl bağlam sağladığını standartlaştıran açık bir protokoldür. MCP sunucuları, protokolü uygulayan çalıştırılabilir programlardır. Bunlar veritabanı bağlantıları veya API uç noktaları değil, JSON-RPC 2.0 aracılığıyla çalışan ve iletişim kuran programlardır.

**Temel kavramlar:**
- **MCP sunucuları**: MCP protokolünü uygulayan çalıştırılabilir programlar (Node.js paketleri, Python betikleri vb.)
- **Yapılandırma**: Verdent'e sunucunun nasıl başlatılacağını söyler (`command` + `args`)
- **İletişim**: Sunucular kendi iş mantıklarını yönetir (sorgular, API çağrıları vb.)

### Temel kurulum

**Konum:** Proje kökünde `.mcp.json`

<CodeGroup>
```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}"
      }
    }
  }
}
```
</CodeGroup>

**Açıklama:**
- `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 tipik olarak `npx`)
- `args` - Komuta geçirilen argümanlar (paket adı, bağlantı dizeleri vb.)
- `env` - Kimlik doğrulama/yapılandırma için ortam değişkenleri

### Çoklu ortam

```json
{
  "mcpServers": {
    "postgres-dev": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "${DEV_DATABASE_URL}"
      ]
    },
    "postgres-staging": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "${STAGING_DATABASE_URL}"
      ]
    },
    "postgres-prod": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "${PROD_DATABASE_URL}"
      ]
    }
  }
}
```

**En iyi uygulama:** Kimlik bilgilerini güvende tutmak için bağlantı dizelerinde ortam değişkenlerini kullanın. MCP sunucuları, salt okunur davranışı uygulamalarına bağlı olarak dahili olarak yönetir. Erişim kontrolü seçenekleri için ilgili sunucu belgelerine başvurun.

<Tip>
**MCP hakkında daha fazla bilgi:**
- [Model Context Protocol Spesifikasyonu](https://modelcontextprotocol.io/specification)
- [MCP Sunucu Kayıt Defteri](https://mcp.so/servers) - Mevcut MCP sunucularına göz atın
- [Resmi MCP Sunucuları](https://github.com/modelcontextprotocol) - PostgreSQL, GitHub, Filesystem ve daha fazlası
</Tip>

---

## Çalışma alanı entegrasyonu

### Projeye özel yapılandırma

**Kurulum:**
1. Proje kökünde saklayın: `.mcp.json`
2. Ekip paylaşımı için sürüm kontrolüne ekleyin
3. Ekip üyeleri otomatik olarak proje MCP sunucularını kullanır

**Mikroservis örneği:**
```json
{
  "mcpServers": {
    "users-db": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/users"
      ]
    },
    "orders-db": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5433/orders"
      ]
    }
  }
}
```

<Note>
Kafka gibi ek hizmetler için uyumlu bir MCP sunucu uygulamasına ihtiyacınız olur. [mcp.so/servers](https://mcp.so/servers) adresindeki resmi MCP sunucu kayıt defteri, mevcut topluluk sunucularını listeler.
</Note>

---

## Ekip iş birliği

### Paylaşılan AGENTS.md standartları

Ekip genelinde tutarlılık için sürüm kontrolüne ekleyin:

```markdown
# AGENTS.md

## Code Review Process
- Run @code-reviewer before PR
- Address all security warnings
- Minimum 80% test coverage

## Integration Requirements
- @migration-reviewer for database changes
- @api-security-auditor for new endpoints
- @a11y-auditor for UI components

## MCP Servers
- Use postgres-staging MCP server for queries
- Never use postgres-prod MCP server for exploratory queries
```

**Faydalar:** Tutarlı davranış, uygulanan standartlar, otomatik kalite kapıları.

---

## Çoklu aracı koordinasyonu

### Karmaşık özellik iş akışı

**Örnek:** Yeni ödeme uç noktası

```
1. Developer request → 2. Main agent generates code →
3. @api-security-auditor reviews security →
4. @migration-reviewer validates schema →
5. MCP tests on staging →
6. Main agent generates tests and PR
```

**Sonuç:** Güvenlik ve veritabanı en iyi uygulamaları uygulanmış, tam olarak incelenmiş bir uç nokta.

---

## Entegrasyon en iyi uygulamaları

### Aşamalı benimseme

**Aşama 1:** Temel kurallar
```markdown
## Code Standards
- Use TypeScript strict mode
- Run tests before commit
```

**Aşama 2:** Özel alt aracı ekleyin
```markdown
## Code Review
- Run @security-reviewer before PR
```

**Aşama 3:** MCP'i entegre edin
```markdown
## Database Access
- Use MCP postgres-staging for queries
```

### Stratejik kombinasyonlar

| Kombinasyon | Amaç | Örnek |
|-------------|---------|---------|
| Kurallar + Alt aracılar | Kurallar *ne zaman* olduğunu tanımlar, alt aracılar *analiz eder* | AGENTS.md: "@security-reviewer ile incele" |
| Kurallar + MCP | Kurallar *hangi* sunucuların kullanılacağını belirtir, MCP *erişir* | AGENTS.md: "Yalnızca db-staging kullan" |
| Alt aracılar + MCP | Alt aracı *harici veri* için MCP kullanır | Security auditor API uç noktalarını sorgular |

### Ekip belgeleme en iyi uygulamaları

Ekibiniz için entegrasyonları belgelerken şunları ekleyin:

- **Özel alt aracılar**: Her alt aracının adını, amacını ve ne zaman çağrılacağını listeleyin
- **AGENTS.md kuralları**: Her standardın ardındaki "neden"i açıklayan gerekçelerle kuralları belgeleyin
- **MCP sunucuları**: Her sunucunun amacını, erişim düzeyini (salt okunur/yazılabilir) ve ne zaman kullanılacağını açıklayın
- **Entegrasyon iş akışları**: Bileşenlerin birlikte nasıl çalıştığını gösteren örnek iş akışları sağlayın
- **Sorun giderme**: Kurulumunuza özgü yaygın sorunları ve çözümlerini belgeleyin

<Tip>
Yeni ekip üyelerinin kurulumunuzu hızlıca anlayabilmesi için entegrasyon belgelerini `.mcp.json` ve `AGENTS.md` dosyalarınızla birlikte sürüm kontrolüne ekleyin.
</Tip>

---

## Sorun giderme

<Tabs>
  <Tab title="Alt aracı sorunları">
    **Sorun:** Alt aracı beklenildiğinde çağrılmıyor

    **Kontrol edin:**

    **Konum**: Dosya `~/.verdent/subagents/[name].md` konumunda mevcut

    **YAML Frontmatter**: Gerekli `name` ve `description` alanlarıyla geçerli sözdizimi

    **Çağırma politikası**: Kullanımla eşleşir (strict, açık @-bahsi gerektirir)

    **Açıklama**: Aracının `description` alanı, alt aracının ne zaman kullanılması gerektiğini doğru şekilde tanımlar

    **Yeniden başlatma**: Alt aracı tanımlarını yeniden yüklemek için Verdent'i yeniden başlatmayı deneyin

    ---

    **Yaygın nedenler:**
    - Alt aracı dosya adında veya @-bahsinde yazım hatası
    - Frontmatter'da geçersiz YAML sözdizimi
    - Alt aracının `description` alanı görev bağlamıyla eşleşmiyor
  </Tab>

  <Tab title="AGENTS.md sorunları">
    **Sorun:** AGENTS.md kuralları uygulanmıyor

    **Kontrol edin:**

    **Konum**: Dosya proje kök dizininde

    **Sözdizimi**: Ayrıştırma hatası olmayan geçerli Markdown

    **Direktif tarzı**: Belirli komutlar kullanın ("Şunu her zaman kullan..." değil "Şunu yapmaya çalış...")

    **Oturum**: Yeni kuralların uygulanmasını test etmek için yeni bir konuşma başlatın

    **Çakışmalar**: Kullanıcı kurallarının proje kurallarını istemeden geçersiz kılıp kılmadığını kontrol edin

    ---

    **Yaygın nedenler:**
    - AGENTS.md yanlış dizinde (proje kökünde olmalı)
    - Yapay zekanın farklı yorumladığı belirsiz talimatlar
    - Kurallar uygulandı ancak sonuçlar beklendiği gibi değil (ifadeyi iyileştirin)
  </Tab>

  <Tab title="MCP sunucu sorunları">
    **Sorun:** MCP sunucusu başlatılamıyor veya bağlanamıyor

    **Kontrol edin:**

    **Sözdizimi**: `.mcp.json` geçerli JSON içerir (doğrulamak için `jq` kullanın)

    **Yapı**: Gerekli `mcpServers` anahtarı üst düzeyde mevcut

    **Sunucu yapılandırması**: Her sunucunun `command` ve `args` değerleri doğru şekilde belirtilmiş

    **Paket**: MCP sunucu paketi erişilebilir (`npx` paketleri otomatik indirir; `-y` bayrağı onay istemini atlar)

    **Ortam**: `env` nesnesindeki değişkenler kabuğunuzda doğru şekilde ayarlanmış

    **İzinler**: Sunucu yürütülebilir dosyası uygun çalıştırma izinlerine sahip

    ---

    **Yaygın nedenler:**
    - JSON'da yazım hatası (eksik virgül, kapatılmamış parantez)
    - args dizisinde yanlış paket adı
    - Eksik veya yanlış ortam değişkenleri
    - Ağ/güvenlik duvarının npx paket kurulumunu engellemesi

    ---

    **Hata ayıklama adımları:**
    1. JSON'u doğrulayın: `cat .mcp.json | jq .`
    2. Komutu manuel olarak test edin: `npx -y @modelcontextprotocol/server-postgres "postgresql://..."`
    3. Ortamı kontrol edin: `echo $GITHUB_TOKEN`
    4. Belirli hata mesajları için Verdent günlüklerini inceleyin
  </Tab>
</Tabs>

---

## Ayrıca bakın

<CardGroup cols={2}>
  <Card title="Genişletilebilirlik kılavuzu" icon="puzzle-piece" href="/docs/verdent-for-vscode/advanced-features/extensibility">
    Eksiksiz genişletme yöntemleri genel bakışı
  </Card>
  <Card title="MCP entegrasyonu" icon="plug" href="/docs/verdent-for-vscode/advanced-features/mcp">
    Model Context Protocol ayrıntıları
  </Card>
</CardGroup>