# Entegrasyon iş akışları (/tr/docs/verdent-for-vscode/advanced-features/integrations)

> Verdent ile harici araç ve hizmetleri entegre etmeye yönelik pratik desenler



### Neler öğreneceksiniz [#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 [#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 [#yaygın-entegrasyon-desenleri]

### Veritabanı geliştirme iş akışı [#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 [#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 [#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-yapılandırma-örnekleri]

### MCP'i anlamak [#mcpi-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 [#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 [#ç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 [#çalışma-alanı-entegrasyonu]

### Projeye özel yapılandırma [#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 [#ekip-iş-birliği]

### Paylaşılan AGENTS.md standartları [#paylaşılan-agentsmd-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 [#çoklu-aracı-koordinasyonu]

### Karmaşık özellik iş akışı [#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ı [#entegrasyon-en-iyi-uygulamaları]

### Aşamalı benimseme [#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 [#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ı [#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 [#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 [#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>