Conector MCP

repo-harness incluye un servidor MCP que da a ChatGPT y Codex acceso de solo lectura a tus repositorios registrados —archivos de flujo de trabajo MÁS el árbol del repositorio, la búsqueda de texto y el contenido de los archivos— mientras que las escrituras quedan acotadas a los artefactos de flujo de trabajo (planes, sprints, contratos, traspasos). ChatGPT se conecta por HTTP con OAuth a través de un endpoint público /mcp; Codex se conecta localmente por stdio sin túnel. El sidecar no es un agente de programación remoto — prepara los artefactos de flujo de trabajo para el host del agente local.

Requisitos previos

Un repositorio adoptado

Ejecútalo desde un repositorio que ya haya ejecutado repo-harness adopt. Consulta Configuración.

repo-harness en el PATH

La CLI de repo-harness debe estar instalada y ser resoluble en el PATH de tu shell.

Modo Desarrollador de ChatGPT

Un espacio de trabajo de ChatGPT con acceso al Modo Desarrollador y a Conectores MCP personalizados.

Un endpoint público /mcp

Una URL HTTPS pública y estable de /mcp para el uso recurrente de ChatGPT. Codex local usa stdio sin túnel.

1. Inicia el servidor MCP local

1. Lanza el servidor con perfil de planificador por HTTP en localhost:

   repo-harness mcp serve --repo . --transport http --host 127.0.0.1 --port 8765 --profile planner

2. Confirma que está sano:

   curl http://127.0.0.1:8765/health

3. Lee la frase de paso de OAuth local — ChatGPT la pedirá durante la autorización:

   jq -r .passphrase .repo-harness/mcp.oauth.json

4. Haz una prueba rápida del descubrimiento de OAuth:

   curl http://127.0.0.1:8765/.well-known/oauth-protected-resource/mcp

Mantén la frase de paso fuera del control de versiones

.repo-harness/mcp.oauth.json es un archivo local ignorado. Nunca confirmes la frase de paso ni la pegues en gestores de incidencias, PR o logs compartidos.

2. Elige un endpoint de túnel

ChatGPT necesita una URL HTTPS pública que termine en /mcp. Prefiere un nombre de host estable para el uso recurrente — la URL de un túnel rápido cambia, y ChatGPT trata cada URL nueva como una aplicación de Conector distinta.

Estable (con nombre)

cloudflared tunnel login
cloudflared tunnel create repo-harness-mcp
cloudflared tunnel route dns repo-harness-mcp repo-harness-mcp.example.com
cloudflared tunnel run --url http://127.0.0.1:8765 repo-harness-mcp

Luego registra el endpoint estable en la configuración local ignorada:

repo-harness mcp setup chatgpt --repo . --endpoint <https-url>/mcp

Rápido (puntual)

cloudflared tunnel --url http://127.0.0.1:8765

Usa la URL HTTPS impresa con /mcp añadido como tu URL de Conector:

<https-tunnel-url>/mcp

3. Crea el Conector de ChatGPT

1. Abre los Ajustes de ChatGPT.
2. Activa el Modo Desarrollador si tu espacio de trabajo lo expone.
3. Ve a Conectores.
4. Crea un Conector llamado repo-harness.
5. Pega la URL HTTPS del Conector que termina en /mcp.
6. Configura la autenticación del Conector como OAuth.
7. Haz clic en Scan Tools.
8. Cuando se abra la página de autorización, introduce la frase de paso de .repo-harness/mcp.oauth.json.
9. Espera a que termine el escaneo de herramientas y luego crea el Conector.
10. Mantén las confirmaciones de escritura activadas.

4. Conecta Codex (stdio)

Codex se ejecuta localmente y no necesita túnel — habla stdio directamente. Genera la configuración automáticamente:

repo-harness mcp setup codex --repo . --scope project

Esto escribe .codex/config.toml con una entrada de servidor repo_harness por stdio y la lista de herramientas permitidas.

5. Runner de agente en modo desarrollo (opcional)

Desactivado por defecto — solo local

El Conector del planificador no ejecuta Codex ni Claude. Activa el runner de desarrollo solo si quieres intencionadamente que ChatGPT dispare un agente local a través de MCP. Mantenlo detrás del Modo Desarrollador local con confirmaciones por llamada, y nunca expongas un túnel de orquestador a usuarios no confiables.

repo-harness mcp serve --repo . --transport http --host 127.0.0.1 --port 8765 \
  --profile orchestrator --enable-dev-runner --dev-runner-agents codex

O mediante una anulación de entorno:

REPO_HARNESS_MCP_DEV_RUNNER=1 REPO_HARNESS_MCP_DEV_RUNNER_AGENTS=codex,claude \
  repo-harness mcp serve --repo . --transport http --profile orchestrator

Cuando está activado, el servidor expone run_agent_goal. Lee únicamente .ai/harness/handoff/codex-goal.md y ejecuta ese traspaso fijo a través de la CLI local permitida. No es shell arbitrario.

Qué se expone

El perfil planner es mayormente de lectura: puede leer tus repositorios registrados y escribir únicamente artefactos de planificación — nunca código fuente de la aplicación, manifiestos, lockfiles, configuración de CI, secretos ni archivos fuera de una raíz de repositorio permitida.

• Lecturas de flujo de trabajo: harness_status, harness_doctor, read_workflow_file, list_workflow_files, latest_handoff, latest_checks
• Lecturas del repositorio (solo lectura): reader_status, list_allowed_roots, open_workspace, tree, search_text, read_text — navega y busca por el repositorio, no solo por los archivos de flujo de trabajo
• Escrituras de planificación: write_prd_from_idea, write_checklist_sprint, prepare_codex_goal_from_sprint

Los globs de denegación permanecen activos incluso con las lecturas del repositorio habilitadas: .env, claves privadas, claves SSH, credenciales, secretos, .git y la salida de dependencias/compilación nunca se devuelven.

Repositorios registrados y multi-repositorio

Un único Conector puede servir todos los repositorios que hayas adoptado. repo-harness adopt y repo-harness init registran un repositorio en ~/.repo-harness/registered-repos.json; discover_harness_repos los lista, y las herramientas de lectura aceptan un repo_path para apuntar a uno específico. La lectura amplia de todo el disco está obsoleta — el antiguo fullDiskRead: true ahora falla de forma cerrada; añade raíces adicionales fuera del repositorio explícitamente con --allow-root.

La configuración de ámbito de usuario (repo-harness mcp setup chatgpt sin --repo, que guarda la configuración y la autenticación bajo ~/.repo-harness/) funciona para los despliegues en Modo Desarrollador. La autenticación HTTP admite OAuth — con rotación de tokens de actualización offline_access — y un modo de compatibilidad url-token.

La cadena de planificación esperada: idea → write_prd_from_idea → write_checklist_sprint → prepare_codex_goal_from_sprint → ejecución local de /goal en Codex.

Resolución de problemas

• Si ChatGPT no puede conectar, verifica que la URL del túnel sea HTTPS y termine en /mcp.
• Si ChatGPT devuelve no autorizado, verifica que el descubrimiento de OAuth funcione y vuelve a ejecutar el flujo de la frase de paso.
• Si faltan herramientas, reinicia repo-harness mcp serve y vuelve a escanear las herramientas.
• Si las escrituras fallan, verifica que la ruta de destino sea un PRD, sprint, plan o archivo de traspaso aprobado.
• Si ChatGPT generó prosa en lugar de tarjetas de tarea de Sprint en formato de lista de comprobación, pídele que use write_checklist_sprint.
• Si Codex no ve el servidor, ejecuta repo-harness mcp setup codex --repo . --scope project.

Próximos pasos

Planificador con ChatGPT Pro El flujo de planificación y revisión que desbloquea este sidecar.

Motor de navegador de ChatGPT Impulsa ChatGPT Web a través de Oracle — sin clave de API.