Flujos de trabajo de integración

Lo que aprenderás

Flujos de trabajo prácticos de integración que combinan subagentes personalizados, reglas y servidores MCP para escenarios de desarrollo reales.

Métodos de integración

Filosofía: Combina métodos para crear flujos de trabajo completos adaptados a tus necesidades.

Patrones comunes de integración

Flujo de trabajo de desarrollo de bases de datos

Stack: Subagente revisor de migraciones + estándares de AGENTS.md + servidor MCP de PostgreSQL

Subagente:

---
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: Servidor PostgreSQL para ejecución de consultas, inspección de esquemas y validación de migraciones

Flujo de trabajo: Escribir la migración → @migration-reviewer la valida → MCP la prueba en staging → documentación del PR

Desarrollo de API con seguridad

Stack: Auditor de seguridad + reglas de AGENTS.md + herramienta de pruebas personalizada de API

Componentes:

• Subagente: @api-security-auditor - Validación de entradas, inyección SQL, autenticación, limitación de tasa
• Reglas: Todos los endpoints requieren revisión de seguridad, limitación de tasa en los API públicos
• Herramientas externas: Pruebas automatizadas de endpoints y análisis de seguridad mediante integración personalizada

Resultado: Revisión de seguridad automática antes de aprobar el PR.

Accesibilidad del frontend

Stack: Auditor de accesibilidad + reglas WCAG + integración de Lighthouse

Flujo de trabajo:

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

Ejemplos de configuración de MCP

Entender MCP

Model Context Protocol (MCP) es un protocolo abierto que estandariza la forma en que las aplicaciones proporcionan contexto a los LLM. Los servidores MCP son ejecutables que implementan el protocolo. No son conexiones de bases de datos ni endpoints de API, sino programas que se ejecutan y se comunican mediante JSON-RPC 2.0.

Conceptos clave:

• Servidores MCP: Ejecutables (paquetes de Node.js, scripts de Python, etc.) que implementan el protocolo MCP
• Configuración: Le indica a Verdent cómo iniciar el servidor (command + args)
• Comunicación: Los servidores gestionan su propia lógica de negocio (consultas, llamadas a API, etc.)

Configuración básica

Ubicación: .mcp.json en la raíz del proyecto

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

Explicación:

• mcpServers - Clave de nivel superior requerida para la configuración de MCP
• command - Ejecutable que se va a ejecutar (normalmente npx para paquetes de Node.js)
• args - Argumentos que se pasan al comando (nombre del paquete, cadenas de conexión, etc.)
• env - Variables de entorno para autenticación/configuración

Múltiples entornos

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

Práctica recomendada: Usa variables de entorno para las cadenas de conexión y mantener las credenciales seguras. Los servidores MCP gestionan internamente el comportamiento de solo lectura según su implementación. Consulta la documentación del servidor específico para conocer las opciones de control de acceso.

Integración con el espacio de trabajo

Configuración específica del proyecto

Configuración:

1. Almacénalo en la raíz del proyecto: .mcp.json
2. Confírmalo en el control de versiones para compartirlo con el equipo
3. Los miembros del equipo usan automáticamente los servidores MCP del proyecto

Ejemplo de microservicios:

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

Colaboración en equipo

Estándares compartidos de AGENTS.md

Confírmalos en el control de versiones para mantener la consistencia en todo el equipo:

# 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

Beneficios: Comportamiento consistente, estándares aplicados y controles de calidad automáticos.

Coordinación de múltiples agentes

Flujo de trabajo de funciones complejas

Ejemplo: Nuevo endpoint de pagos

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

Resultado: Endpoint completamente revisado con las prácticas recomendadas de seguridad y bases de datos aplicadas.

Prácticas recomendadas de integración

Adopción progresiva

Fase 1: Reglas básicas

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

Fase 2: Agregar un subagente especializado

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

Fase 3: Integrar MCP

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

Combinaciones estratégicas

Prácticas recomendadas de documentación para el equipo

Cuando documentes las integraciones para tu equipo, incluye:

• Subagentes personalizados: Lista el nombre, propósito y momento de invocación de cada subagente
• Reglas de AGENTS.md: Documenta las reglas con una justificación que explique el "por qué" de cada estándar
• Servidores MCP: Describe el propósito de cada servidor, su nivel de acceso (solo lectura/escritura) y cuándo usarlo
• Flujos de trabajo de integración: Proporciona flujos de trabajo de ejemplo que muestren cómo los componentes funcionan en conjunto
• Resolución de problemas: Documenta los problemas comunes específicos de tu configuración y sus soluciones

Resolución de problemas

Véase también