claude-gpt-workflow MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Separación de roles: Claude define la estrategia, Codex ejecuta
Revisión adversarial del plan entre dos modelos
Tres bucles de retroalimentación (A: plan, B: revisión/corrección, C: lotes)
Integración basada en shell mediante ask_codex.sh
Control de calidad en cada iteración

Demo en vivo

Cómo se ve en la práctica

claude-gpt-workflow-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-gpt-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/longranger2/claude-gpt-workflow",
        "~/.claude/skills/claude-gpt-workflow"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-gpt-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/longranger2/claude-gpt-workflow",
        "~/.claude/skills/claude-gpt-workflow"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-gpt-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/longranger2/claude-gpt-workflow",
        "~/.claude/skills/claude-gpt-workflow"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-gpt-workflow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/longranger2/claude-gpt-workflow",
        "~/.claude/skills/claude-gpt-workflow"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-gpt-workflow-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/longranger2/claude-gpt-workflow",
        "~/.claude/skills/claude-gpt-workflow"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-gpt-workflow-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/longranger2/claude-gpt-workflow",
          "~/.claude/skills/claude-gpt-workflow"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add claude-gpt-workflow-skill -- git clone https://github.com/longranger2/claude-gpt-workflow ~/.claude/skills/claude-gpt-workflow

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: claude-gpt-workflow

Prueba un plan sometiendo a ataque de otro modelo

👤 Ingenieros realizando refactorizaciones de alto riesgo ⏱ ~45 min intermediate

Cuándo usarlo: Antes de tocar código en una migración o refactor riesgoso, quieres que otro modelo identifique problemas.

Requisitos previos

Codex CLI instalada y autenticada — Instala OpenAI Codex CLI con tu clave API
Skill instalada — git clone https://github.com/longranger2/claude-gpt-workflow ~/.claude/skills/claude-gpt-workflow

Flujo

Redacta un plan con Claude

Escribe un plan.md para migrar nuestro módulo de autenticación de JWT a cookies de sesión.✓ Copiado

→ Plan paso a paso escrito en plan.md
Dispara revisión adversarial

/plan-review plan.md✓ Copiado

→ Codex devuelve crítica con riesgos que Claude no detectó
Itera hasta que ambos estén de acuerdo

Incorpora la crítica de Codex, reenvía, repite hasta estar limpio.✓ Copiado

→ El plan alcanza estado estable

Resultado: Un plan que ha pasado una revisión adversarial real, no solo autoevaluación.

Errores comunes

Bucles de revisión infinitos — Limita a 3 rondas — rendimientos decrecientes después

Combinar con: filesystem · git

Delega un refactor por lotes a Codex con revisión de Claude

👤 Equipos realizando cambios mecánicos en múltiples archivos ⏱ ~60 min intermediate

Cuándo usarlo: Un cambio de nombre / firma en 50+ archivos.

Flujo

Planifica y aprueba

Planifica + revisa un cambio de nombre de <old> a <new> en todo el código.✓ Copiado

→ plan.md aprobado
Ejecuta

/plan-execute plan.md — Codex realiza las ediciones, Claude revisa cada lote.✓ Copiado

→ Los archivos cambian en lotes, cada uno pasa la revisión de Claude

Resultado: Un cambio limpio en múltiples archivos con dos pares de ojos en cada lote.

Errores comunes

Codex hace algo que Claude habría rechazado — El bucle /plan-execute lo detecta — pero solo si los criterios de calidad en el plan son explícitos

Combinar con: git

Implementa una característica con refinamiento iterativo de calidad

👤 Desarrolladores que han visto código de IA de una sola pasada fallar en casos extremos ⏱ ~90 min advanced

Cuándo usarlo: Una característica lo suficientemente compleja que una sola generación no funcionará correctamente.

Flujo

Escribe un plan con criterios de aceptación

Planifica una característica con pruebas de aceptación explícitas, luego /plan-execute.✓ Copiado

→ Plan con criterios comprobables
Observa el bucle

Deja que el bucle de revisión/corrección se ejecute — resume cada iteración.✓ Copiado

→ Las iteraciones convergen al pasar los criterios

Resultado: Una característica que pasa la aceptación explícita, no solo un commit que compila.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

claude-gpt-workflow-skill + git

Realiza un commit después de cada iteración del bucle para poder revertir si el bucle se desvía

Antes de cada iteración de /plan-execute, crea una etiqueta de git.✓ Copiado

claude-gpt-workflow-skill + filesystem

El plan y las críticas viven en el repositorio

Escribe plan.md y review-notes.md en docs/ y mantenlos en git.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
ask_codex.sh	cadena de solicitud	Delega una tarea de programación	tokens de API de Codex
/plan-review	ruta del archivo de plan	Antes de la ejecución	tokens de API de Codex
/plan-execute	ruta del plan aprobado	Después de que /plan-review pase	tokens de API de Codex por iteración

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: tokens de API de Codex — potencialmente 2–5x un flujo de un solo modelo ya que ambos modelos se ejecutan
Tokens por llamada: Alto — plan + revisión + ejecución
Monetario: Dos suscripciones de API (Claude + OpenAI)
Consejo: Reserva esto para trabajo riesgoso; no lo uses para ediciones pequeñas de un archivo

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: OPENAI_API_KEY en env para Codex CLI

Salida de datos: El código abandona tu máquina hacia ambos proveedores — verifica la política corporativa

El flujo de dos modelos duplica la superficie que ve tu código.

Resolución de problemas

Errores comunes y soluciones

ask_codex.sh: comando no encontrado

Codex CLI no está en PATH o no está instalada

Verificar: which codex

Plan-execute se ejecuta en bucle infinito

Criterios de aceptación demasiado vagos — define mejor el plan o limita las iteraciones

Los modelos no están de acuerdo y el plan nunca se estabiliza

Fuerza una ronda de desempate con un alcance más reducido

Alternativas

claude-gpt-workflow vs otros

Alternativa	Cuándo usarla	Contrapartida
Claude Code de un solo modelo	La tarea no es lo suficientemente riesgosa para justificar la sobrecarga de dos modelos	Menos señales adversariales
agent-skill-tdd	La disciplina viene de las pruebas, no de la crítica de otro modelo	Sin revisión entre modelos

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills