Asistente IA (MCP)

La fábrica tiene un servidor MCP para que un asistente de IA (Claude Code, Codex…) consulte y opere la fábrica a tu nombre: crear tareas, pasarlas a un agente, preguntar qué está corriendo, cuánto se ejecutó o cuánto costó un período. Por ejemplo, con el dictado por voz de tu sistema o de tu asistente.

Dirección: /mcp
Transporte: HTTP (streamable HTTP), sin estado.
Autenticación: OAuth: al conectar el asistente inicias sesión con tu usuario y tu clave de la fábrica, y el asistente recibe un token tuyo. No hay que copiar tokens a mano.
Permisos: Los tuyos: ves los proyectos que ves en el tablero y solo modificas o ejecutas tus tareas.

Tus conexiones

Cada vez que autorizas un asistente queda aquí un token «asistente (OAuth)». Elimínalo para quitarle el acceso: el asistente te pedirá iniciar sesión de nuevo. Cambiar tu clave no los invalida: elimínalos si crees que alguien más los tiene.

Nombre	Token	Creado	Último uso

Sesión de · cerrar sesión

Claude (web y celular)

Se conecta una vez en claude.ai → Configuración → Conectores (desde la PC) y queda también en la app del celular, con la misma cuenta de Claude:

Agregar conector personalizado, con nombre ForTech Fabric y la dirección /mcp. No hace falta token.
Conectar: se abre la página de la fábrica, ingresas tu email y tu clave y autorizas.
En una conversación, activa ForTech Fabric en el menú de herramientas.

La autorización crea un token «Claude (OAuth)» en tus conexiones: para quitarle el acceso, elimínalo. ChatGPT (conectores en modo desarrollador) se conecta igual.

Claude Code

En una terminal (con --scope user queda para todos tus proyectos):

claude mcp add --transport http --scope user software-factory /mcp

Después, en Claude Code, /mcp → software-factory → Authenticate: se abre el navegador, ingresas tu email y tu clave y autorizas. Luego pregunta, p. ej. «¿Cuántas tareas están corriendo en la fábrica?».

Si lo tenías configurado con --header "Authorization: …", quítalo antes con claude mcp remove --scope user software-factory: con ese encabezado Claude Code no usa OAuth.

Codex

En una terminal:

codex mcp add software-factory --url /mcp
codex mcp login software-factory

El segundo comando abre el navegador para que inicies sesión y autorices. En Codex, con /mcp ves si quedó conectado.

Si lo tenías con bearer_token_env_var en ~/.codex/config.toml, quita esa línea (y la variable SOFTWARE_FACTORY_TOKEN).

Herramientas

El asistente elige cuál usar. Las que crean, cambian, mueven, ejecutan, comentan, archivan o borran le piden confirmación antes (así se lo indica el servidor). Los períodos son hoy, ayer, semana (desde el lunes), semana_pasada, mes (el mes calendario), mes_pasado, año o rango (desde/hasta), en la hora de la fábrica.

Herramienta	Para qué
`listar_proyectos`	Proyectos que ves y los flujos de agentes que usan (para resolver «el proyecto de…»).
`listar_agentes`	Agentes (etapas) de cada flujo y si ejecutan algo.
`mis_pcs`	Tus PCs y las que te compartieron: conectadas, si aceptan ejecuciones remotas, qué proyectos y CLIs tienen.
`buscar_tareas`	Por título o id, proyecto, agente, estado o solo las tuyas. Incluye si su PR se mezcló.
`estado_tarea`	Todo sobre una tarea: agente, si está corriendo, última ejecución, costo, PR (y si se mezcló), pedidos y comentarios.
`tareas_en_ejecucion`	Cuántas y cuáles corren ahora, cuántas esperan y los pedidos sin tomar.
`tareas_con_problemas`	Con error, rechazadas, posiblemente colgadas o con pedidos rechazados o vencidos.
`actividad`	Tareas creadas y ejecutadas, ejecuciones, PRs, costo y costo por PR de un período.
`costos_desglosados`	Costo de un período por proyecto, modelo, agente, developer o día.
`tareas_mas_caras`	Las tareas que más costaron en un período.
`ranking_developers`	Tareas creadas, ejecutadas, costo y PRs por developer.
`prs_generados`	Los PRs que generó la fábrica en un período.
`resumen_del_dia`	Lo de hoy: actividad, lo que corre y lo que tiene problemas.
`crear_tarea`	Crea una tarea tuya en el primer agente de su flujo (si el proyecto usa varios, el asistente pregunta cuál).
`editar_tarea`	Cambia el título y la descripción de una tarea tuya que nunca se ejecutó (si ya se ejecutó, solo se le agregan comentarios).
`mover_tarea`	Pasa una tarea tuya a un agente: si ejecuta, la manda a una de tus PCs; si es humano, solo la mueve (siempre dentro de su flujo).
`volver_a_ejecutar`	Vuelve a ejecutar el agente actual de una tarea tuya.
`agregar_comentario`	Deja retroalimentación para el próximo agente.
`lecciones_proyecto`	La memoria de un proyecto: lecciones propuestas, activas y descartadas, y a qué agentes aplican.
`proponer_leccion`	Propone una lección para la memoria del proyecto; la reciben los agentes cuando una persona la aprueba.
`cambiar_rama_base`	Cambia la rama base de una tarea tuya (no mientras se ejecuta); vale para las ejecuciones siguientes.
`sincronizar_con_rama_base`	Como «🔄 Sincronizar con rama base» de la aplicación: trae a la rama de una tarea tuya lo último de su rama base, en su PC (la IA resuelve los conflictos).
`archivar_tarea`	Solo administradores: archiva una tarea de cualquier usuario (conserva sus métricas).
`borrar_tarea`	Solo administradores: borra una tarea de cualquier usuario con sus ejecuciones (si ya no tiene rama ni worktree en su PC; si no, primero se archiva).

Qué preguntar

«Crea una tarea en el proyecto Mesa de ayuda: agregar filtro por fecha al listado de tickets.»
«Pasa la tarea 128 al Desarrollador.» · «Vuelve a ejecutar la 128.»
«¿Cuántas tareas están corriendo? ¿Cuáles?» · «¿La del login sigue corriendo?»
«¿Cuántas tareas ejecutamos hoy / este mes / del 1 al 15 de octubre?»
«¿Cuánto llevamos gastado este mes? ¿Por proyecto? ¿Por modelo?»
«¿Qué developer ha colocado más tareas este mes?»
«¿Qué tareas tienen problemas?» · «Dame el resumen del día.»
«Dile a la 128 que use el endpoint v2 y vuelve a ejecutarla.»
«Cambia la rama base de la 128 a develop.» · «Archiva la 97.» (administradores)

Límites

Ejecutar es pedirle a tu PC (o a una que te compartieron) que lo haga: tiene que estar conectada, con la aplicación abierta con tu usuario (o con el de quien te la compartió) y con «aceptar ejecuciones desde el tablero web» activado en Preferencias. Si la PC no lo toma en 10 minutos, el pedido vence. Una tarea que ya se ejecutó en una PC solo puede seguir en esa PC.
Detener una ejecución no se puede desde el asistente: solo desde la aplicación de la PC que la ejecuta.
Mover una tarea que puede estar en la cola de su PC se hace desde la aplicación de escritorio. Si se pasa a un agente que descarta el trabajo (p. ej. Descartados), su worktree y su rama local los elimina la aplicación de su PC la próxima vez que esté abierta.
Codex CLI no informa su costo: el asistente avisa cuántas ejecuciones quedaron sin costo; el gasto real es mayor.