Flux de travail d'intégration

Ce que vous allez apprendre

Des flux de travail d'intégration pratiques combinant des sous-agents personnalisés, des règles et des serveurs MCP pour des scénarios de développement réels.

Méthodes d'intégration

Philosophie : Combinez ces méthodes pour créer des flux de travail complets adaptés à vos besoins.

Modèles d'intégration courants

Flux de travail de développement de base de données

Pile technique : Sous-agent réviseur de migrations + standards AGENTS.md + serveur MCP PostgreSQL

Sous-agent :

---
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 : Serveur PostgreSQL pour l'exécution de requêtes, l'inspection de schémas, la validation des migrations

Flux de travail : Écrire la migration → @migration-reviewer valide → MCP teste en environnement de préproduction → documentation de la PR

Développement API sécurisé

Pile technique : Auditeur de sécurité + règles AGENTS.md + outil de test API personnalisé

Composants :

• Sous-agent : @api-security-auditor - Validation des entrées, injection SQL, authentification, limitation de débit
• Règles : Tous les points de terminaison exigent une revue de sécurité, limitation de débit sur les APIs publics
• Outils externes : Tests automatisés des points de terminaison et analyses de sécurité via une intégration personnalisée

Résultat : Revue de sécurité automatique avant l'approbation de la PR.

Accessibilité front-end

Pile technique : Auditeur d'accessibilité + règles WCAG + intégration Lighthouse

Flux de travail :

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

Exemples de configuration MCP

Comprendre MCP

Le Model Context Protocol (MCP) est un protocole ouvert qui standardise la façon dont les applications fournissent du contexte aux LLMs. Les serveurs MCP sont des exécutables qui implémentent ce protocole. Ce ne sont pas des connexions à des bases de données ni des points de terminaison API, mais des programmes qui s'exécutent et communiquent via JSON-RPC 2.0.

Concepts clés :

• Serveurs MCP : Exécutables (paquets Node.js, scripts Python, etc.) qui implémentent le protocole MCP
• Configuration : Indique à Verdent comment démarrer le serveur (command + args)
• Communication : Les serveurs gèrent leur propre logique métier (requêtes, appels API, etc.)

Configuration de base

Emplacement : .mcp.json à la racine du projet

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

Explication :

• mcpServers - Clé de premier niveau requise pour la configuration MCP
• command - Exécutable à lancer (généralement npx pour les paquets Node.js)
• args - Arguments passés à la commande (nom du paquet, chaînes de connexion, etc.)
• env - Variables d'environnement pour l'authentification/la configuration

Multi-environnement

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

Bonne pratique : Utilisez des variables d'environnement pour les chaînes de connexion afin de sécuriser les identifiants. Les serveurs MCP gèrent le comportement en lecture seule en interne selon leur implémentation. Consultez la documentation spécifique de chaque serveur pour les options de contrôle d'accès.

Intégration à l'espace de travail

Configuration spécifique au projet

Configuration :

1. Stockez à la racine du projet : .mcp.json
2. Validez dans le contrôle de version pour le partage en équipe
3. Les membres de l'équipe utilisent automatiquement les serveurs MCP du projet

Exemple de microservices :

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

Collaboration en équipe

Standards AGENTS.md partagés

Validez dans le contrôle de version pour assurer la cohérence à l'échelle de l'équipe :

# 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

Avantages : Comportement cohérent, standards appliqués, contrôles qualité automatiques.

Coordination multi-agents

Flux de travail pour une fonctionnalité complexe

Exemple : Nouveau point de terminaison de paiement

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

Résultat : Point de terminaison entièrement revu avec les bonnes pratiques de sécurité et de base de données appliquées.

Bonnes pratiques d'intégration

Adoption progressive

Phase 1 : Règles de base

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

Phase 2 : Ajouter un sous-agent spécialisé

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

Phase 3 : Intégrer MCP

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

Combinaisons stratégiques

Bonnes pratiques de documentation d'équipe

Lorsque vous documentez les intégrations pour votre équipe, incluez :

• Sous-agents personnalisés : listez le nom, l'objectif et le moment d'invocation de chaque sous-agent
• Règles AGENTS.md : documentez les règles avec une justification expliquant le « pourquoi » de chaque standard
• Serveurs MCP : décrivez l'objectif, le niveau d'accès (lecture seule/écriture) et le moment d'utilisation de chaque serveur
• Flux de travail d'intégration : fournissez des exemples de flux de travail montrant comment les composants fonctionnent ensemble
• Dépannage : documentez les problèmes courants propres à votre configuration et leurs solutions

Dépannage

Voir aussi