Integrations-Workflows

Was Sie lernen werden

Praktische Integrations-Workflows, die benutzerdefinierte Subagents, Regeln und MCP-Server für reale Entwicklungsszenarien kombinieren.

Integrationsmethoden

Philosophie: Kombinieren Sie Methoden, um umfassende, auf Ihre Anforderungen zugeschnittene Workflows zu erstellen.

Gängige Integrationsmuster

Datenbank-Entwicklungsworkflow

Stack: Migration Reviewer Subagent + AGENTS.md-Standards + PostgreSQL-MCP-Server

Subagent:

---
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: PostgreSQL-Server für Abfrageausführung, Schemaprüfung, Migrationsvalidierung

Workflow: Migration schreiben → @migration-reviewer validiert → MCP testet auf Staging → PR-Dokumentation

API-Entwicklung mit Sicherheit

Stack: Security Auditor + AGENTS.md-Regeln + benutzerdefiniertes API-Testwerkzeug

Komponenten:

• Subagent: @api-security-auditor – Eingabevalidierung, SQL-Injection, Authentifizierung, Ratenbegrenzung
• Regeln: Alle Endpunkte erfordern eine Sicherheitsprüfung, Ratenbegrenzung bei öffentlichen APIs
• Externe Werkzeuge: Automatisierte Endpunkttests und Sicherheitsscans über benutzerdefinierte Integration

Ergebnis: Automatische Sicherheitsprüfung vor der PR-Freigabe.

Frontend-Barrierefreiheit

Stack: Accessibility Auditor + WCAG-Regeln + Lighthouse-Integration

Workflow:

Create component → @a11y-auditor reviews → Lighthouse tests accessibility → Rules enforce >90 score

MCP-Konfigurationsbeispiele

MCP verstehen

Model Context Protocol (MCP) ist ein offenes Protokoll, das standardisiert, wie Anwendungen Kontext für LLMs bereitstellen. MCP-Server sind ausführbare Programme, die das Protokoll implementieren. Es handelt sich dabei nicht um Datenbankverbindungen oder API-Endpunkte, sondern um Programme, die ausgeführt werden und über JSON-RPC 2.0 kommunizieren.

Kernkonzepte:

• MCP-Server: Ausführbare Programme (Node.js-Pakete, Python-Skripte usw.), die das MCP-Protokoll implementieren
• Konfiguration: Teilt Verdent mit, wie der Server gestartet wird (command + args)
• Kommunikation: Server übernehmen ihre eigene Geschäftslogik (Abfragen, API-Aufrufe usw.)

Grundkonfiguration

Speicherort: .mcp.json im Projektstamm

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

Erklärung:

• mcpServers – Erforderlicher oberster Schlüssel für die MCP-Konfiguration
• command – Auszuführendes Programm (typischerweise npx für Node.js-Pakete)
• args – An den Befehl übergebene Argumente (Paketname, Verbindungszeichenfolgen usw.)
• env – Umgebungsvariablen für Authentifizierung/Konfiguration

Mehrere Umgebungen

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

Best Practice: Verwenden Sie Umgebungsvariablen für Verbindungszeichenfolgen, um Zugangsdaten sicher zu halten. MCP-Server handhaben schreibgeschütztes Verhalten intern, basierend auf ihrer jeweiligen Implementierung. Ziehen Sie die Dokumentation des jeweiligen Servers für Zugriffssteuerungsoptionen zu Rate.

Integration im Arbeitsbereich

Projektspezifische Konfiguration

Einrichtung:

1. Im Projektstamm speichern: .mcp.json
2. Zur Versionskontrolle committen, um im Team zu teilen
3. Teammitglieder verwenden automatisch die Projekt-MCP-Server

Microservices-Beispiel:

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

Teamzusammenarbeit

Gemeinsame AGENTS.md-Standards

Zur Versionskontrolle committen, um teamweite Konsistenz zu gewährleisten:

# 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

Vorteile: Konsistentes Verhalten, durchgesetzte Standards, automatische Qualitätskontrollen.

Koordination mehrerer Agents

Komplexer Feature-Workflow

Beispiel: Neuer Zahlungsendpunkt

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

Ergebnis: Vollständig überprüfter Endpunkt unter Anwendung von Sicherheits- und Datenbank-Best-Practices.

Best Practices für Integrationen

Schrittweise Einführung

Phase 1: Grundlegende Regeln

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

Phase 2: Spezialisierten Subagent hinzufügen

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

Phase 3: MCP integrieren

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

Strategische Kombinationen

Best Practices für die Teamdokumentation

Berücksichtigen Sie beim Dokumentieren von Integrationen für Ihr Team Folgendes:

• Benutzerdefinierte Subagents: Listen Sie Name, Zweck und Einsatzzeitpunkt jedes Subagents auf
• AGENTS.md-Regeln: Dokumentieren Sie Regeln mit einer Begründung, die das „Warum" hinter jedem Standard erklärt
• MCP-Server: Beschreiben Sie Zweck, Zugriffsebene (schreibgeschützt/schreibend) und Einsatzzeitpunkt jedes Servers
• Integrations-Workflows: Stellen Sie Beispiel-Workflows bereit, die das Zusammenspiel der Komponenten zeigen
• Fehlerbehebung: Dokumentieren Sie häufige, für Ihr Setup spezifische Probleme und deren Lösungen

Fehlerbehebung

Siehe auch