Fluxos de trabalho de integração

O que você vai aprender

Fluxos de trabalho práticos de integração que combinam subagentes personalizados, regras e servidores MCP para cenários reais de desenvolvimento.

Métodos de integração

Filosofia: Combine métodos para criar fluxos de trabalho abrangentes adaptados às suas necessidades.

Padrões comuns de integração

Fluxo de trabalho de desenvolvimento de banco de dados

Stack: Subagente Migration Reviewer + Padrões do AGENTS.md + Servidor MCP 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 execução de queries, inspeção de schema e validação de migrações

Fluxo de trabalho: Escrever migração → @migration-reviewer valida → MCP testa em staging → documentação do PR

Desenvolvimento de API com segurança

Stack: Security Auditor + Regras do AGENTS.md + Ferramenta personalizada de testes API

Componentes:

• Subagente: @api-security-auditor - Validação de entrada, injeção de SQL, autenticação, limitação de taxa
• Regras: Todos os endpoints exigem revisão de segurança, limitação de taxa em APIs públicas
• Ferramentas externas: Testes automatizados de endpoints e varreduras de segurança por meio de integração personalizada

Resultado: Revisão de segurança automática antes da aprovação do PR.

Acessibilidade de frontend

Stack: Accessibility Auditor + Regras WCAG + Integração com Lighthouse

Fluxo de trabalho:

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

Exemplos de configuração de MCP

Entendendo o MCP

O Model Context Protocol (MCP) é um protocolo aberto que padroniza como os aplicativos fornecem contexto aos LLMs. Os servidores MCP são executáveis que implementam o protocolo. Eles não são conexões de banco de dados nem endpoints de API, mas programas que rodam e se comunicam via JSON-RPC 2.0.

Conceitos principais:

• Servidores MCP: Executáveis (pacotes Node.js, scripts Python, etc.) que implementam o protocolo MCP
• Configuração: Informa ao Verdent como iniciar o servidor (command + args)
• Comunicação: Os servidores cuidam da própria lógica de negócio (queries, chamadas de API, etc.)

Configuração básica

Localização: .mcp.json na raiz do projeto

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

Explicação:

• mcpServers - Chave de nível superior obrigatória para a configuração do MCP
• command - Executável a ser rodado (normalmente npx para pacotes Node.js)
• args - Argumentos passados ao comando (nome do pacote, strings de conexão, etc.)
• env - Variáveis de ambiente para autenticação/configuração

Múltiplos ambientes

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

Boa prática: Use variáveis de ambiente para strings de conexão a fim de manter as credenciais seguras. Os servidores MCP tratam o comportamento somente leitura internamente, com base em sua implementação. Consulte a documentação específica do servidor para opções de controle de acesso.

Integração com o espaço de trabalho

Configuração específica do projeto

Configuração:

1. Armazene na raiz do projeto: .mcp.json
2. Faça commit no controle de versão para compartilhamento com a equipe
3. Os membros da equipe usam automaticamente os servidores MCP do projeto

Exemplo de microsserviços:

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

Colaboração em equipe

Padrões compartilhados do AGENTS.md

Faça commit no controle de versão para consistência em toda a equipe:

# 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

Benefícios: Comportamento consistente, padrões aplicados, portões de qualidade automáticos.

Coordenação multiagente

Fluxo de trabalho de funcionalidade complexa

Exemplo: Novo endpoint de 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

Resultado: Endpoint totalmente revisado com as melhores práticas de segurança e banco de dados aplicadas.

Boas práticas de integração

Adoção progressiva

Fase 1: Regras básicas

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

Fase 2: Adicione um subagente especializado

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

Fase 3: Integre o MCP

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

Combinações estratégicas

Boas práticas de documentação para a equipe

Ao documentar integrações para a sua equipe, inclua:

• Subagentes personalizados: Liste o nome, a finalidade e quando invocar cada subagente
• Regras do AGENTS.md: Documente as regras com a justificativa explicando o "porquê" de cada padrão
• Servidores MCP: Descreva a finalidade de cada servidor, o nível de acesso (somente leitura/escrita) e quando usá-lo
• Fluxos de trabalho de integração: Forneça exemplos de fluxos de trabalho mostrando como os componentes funcionam juntos
• Solução de problemas: Documente problemas comuns específicos da sua configuração e suas soluções

Solução de problemas

Veja também