Entegrasyon iş akışları

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

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ı:

---
name: migration-reviewer
description: Reviews database migrations for safety
---
Checks: Destructive operations, reversibility, indexing, blocking operations

AGENTS.md:

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

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

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

{
  "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}"
      }
    }
  }
}

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

{
  "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.

Ç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:

{
  "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"
      ]
    }
  }
}

Ekip iş birliği

Paylaşılan AGENTS.md standartları

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

# 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

## Code Standards
- Use TypeScript strict mode
- Run tests before commit

Aşama 2: Özel alt aracı ekleyin

## Code Review
- Run @security-reviewer before PR

Aşama 3: MCP'i entegre edin

## Database Access
- Use MCP postgres-staging for queries

Stratejik kombinasyonlar

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

Sorun giderme

Ayrıca bakın