Flussi di lavoro di integrazione

Cosa imparerai

Flussi di lavoro pratici di integrazione che combinano sottoagenti personalizzati, regole e server MCP per scenari di sviluppo reali.

Metodi di integrazione

Filosofia: combina i metodi per creare flussi di lavoro completi su misura per le tue esigenze.

Pattern di integrazione comuni

Flusso di lavoro per lo sviluppo di database

Stack: sottoagente Migration Reviewer + standard AGENTS.md + server PostgreSQL MCP

Sottoagente:

---
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: server PostgreSQL per l'esecuzione di query, l'ispezione dello schema e la validazione delle migrazioni

Flusso di lavoro: scrivi la migrazione → @migration-reviewer valida → MCP esegue i test in staging → documentazione della PR

Sviluppo API con sicurezza

Stack: Security Auditor + regole AGENTS.md + strumento di test API personalizzato

Componenti:

• Sottoagente: @api-security-auditor - Validazione degli input, SQL injection, autenticazione, rate limiting
• Regole: tutti gli endpoint richiedono una revisione di sicurezza, rate limiting sugli API pubblici
• Strumenti esterni: test automatizzati degli endpoint e scansioni di sicurezza tramite integrazione personalizzata

Risultato: revisione di sicurezza automatica prima dell'approvazione della PR.

Accessibilità frontend

Stack: Accessibility Auditor + regole WCAG + integrazione Lighthouse

Flusso di lavoro:

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

Esempi di configurazione MCP

Comprendere MCP

Model Context Protocol (MCP) è un protocollo aperto che standardizza il modo in cui le applicazioni forniscono contesto agli LLM. I server MCP sono eseguibili che implementano il protocollo. Non sono connessioni a database o endpoint API, ma programmi che vengono eseguiti e comunicano tramite JSON-RPC 2.0.

Concetti chiave:

• Server MCP: eseguibili (pacchetti Node.js, script Python, ecc.) che implementano il protocollo MCP
• Configurazione: indica a Verdent come avviare il server (command + args)
• Comunicazione: i server gestiscono la propria logica di business (query, chiamate API, ecc.)

Configurazione di base

Posizione: .mcp.json nella radice del progetto

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

Spiegazione:

• mcpServers - Chiave di primo livello obbligatoria per la configurazione MCP
• command - Eseguibile da avviare (tipicamente npx per i pacchetti Node.js)
• args - Argomenti passati al comando (nome del pacchetto, stringhe di connessione, ecc.)
• env - Variabili d'ambiente per autenticazione/configurazione

Multi-ambiente

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

Buona pratica: usa variabili d'ambiente per le stringhe di connessione per mantenere sicure le credenziali. I server MCP gestiscono internamente il comportamento in sola lettura in base alla loro implementazione. Consulta la documentazione specifica del server per le opzioni di controllo degli accessi.

Integrazione del workspace

Configurazione specifica per il progetto

Configurazione:

1. Salva nella radice del progetto: .mcp.json
2. Esegui il commit nel controllo di versione per la condivisione con il team
3. I membri del team usano automaticamente i server MCP del progetto

Esempio di microservizi:

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

Collaborazione di team

Standard AGENTS.md condivisi

Esegui il commit nel controllo di versione per garantire coerenza a livello di team:

# 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

Vantaggi: comportamento coerente, standard applicati, controlli qualità automatici.

Coordinamento multi-agente

Flusso di lavoro per funzionalità complesse

Esempio: nuovo endpoint di pagamento

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

Risultato: endpoint completamente revisionato con applicate le best practice di sicurezza e database.

Best practice di integrazione

Adozione progressiva

Fase 1: regole di base

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

Fase 2: aggiungi un sottoagente specializzato

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

Fase 3: integra MCP

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

Combinazioni strategiche

Best practice per la documentazione del team

Quando documenti le integrazioni per il tuo team, includi:

• Sottoagenti personalizzati: elenca il nome, lo scopo di ciascun sottoagente e quando invocarlo
• Regole AGENTS.md: documenta le regole con la motivazione che spiega il "perché" dietro ogni standard
• Server MCP: descrivi lo scopo di ciascun server, il livello di accesso (sola lettura/scrittura) e quando usarlo
• Flussi di lavoro di integrazione: fornisci flussi di lavoro di esempio che mostrano come i componenti lavorano insieme
• Risoluzione dei problemi: documenta i problemi comuni specifici della tua configurazione e le relative soluzioni

Risoluzione dei problemi

Vedi anche