APC define el contrato del proyecto, MCP el protocolo de herramientas

En el ecosistema actual de desarrollo con inteligencia artificial, surge con frecuencia una confusión entre dos capas fundamentales: el contrato del proyecto y el protocolo de herramientas externas. Por un lado, APC (Agreement Project Contract) define la identidad del proyecto: qué agentes lo componen, qué reglas de negocio aplican, qué habilidades se requieren, qué servidores MCP se esperan y qué información curada debe persistir entre sesiones. Por otro lado, MCP (Machine Communication Protocol) establece cómo una aplicación con IA se comunica con capacidades externas: herramientas, recursos, esquemas de transporte y flujos de solicitud-respuesta. Ambas capas resuelven problemas distintos y no deben mezclarse. Mantenerlas separadas permite que el repositorio se mantenga ligero, portable y revisable, mientras que la ejecución real de las herramientas queda en manos de una capa intermedia: APX, el runtime local que resuelve, inicia y conecta los servidores MCP según las exigencias del proyecto.

Esta arquitectura evita que un archivo de proyecto se convierta en un vertedero de claves API, tokens, logs de sesión o rutas absolutas de máquina. Lo que pertenece al contrato del proyecto son las intenciones y expectativas, no el estado transitorio. Por ejemplo, un archivo .apc/mcps.json puede declarar que se necesita un servidor de sistema de archivos, pero no debe intentar ser ese servidor ni almacenar credenciales. La resolución concreta corresponde al runtime APX en cada máquina, que lee el contrato y lo cumple usando la configuración local. Esta separación de responsabilidades reduce la deriva: cuando el significado del proyecto reside en APC, diferentes herramientas pueden interpretar la misma fuente de verdad; cuando la mecánica de ejecución se delega en APX, cambiar de máquina no exige reescribir el repositorio.

En la práctica, un proyecto típico bajo este esquema contiene en su carpeta .apc el contrato raíz en AGENTS.md, agentes estructurados, habilidades reutilizables, metadatos del proyecto y las expectativas de MCP. El runtime APX inicia un demonio, gestiona sesiones y mensajes, mantiene el estado local en ~/.apx/ y resuelve las fuentes MCP. Así, el repositorio guarda solo lo que tiene sentido compartir tras un clonado o un cambio de portátil, mientras que el runtime se encarga de lo efímero. Esta claridad de capas permite tomar decisiones de herramientas mucho más sólidas, preguntando siempre: ¿esto es significado del proyecto, capacidad externa o ejecución local?

En Q2BSTUDIO aplicamos estos principios al diseñar aplicaciones a medida para empresas que necesitan integrar inteligencia artificial de forma ordenada y escalable. Nuestro equipo desarrolla soluciones que separan claramente el contrato del proyecto de los protocolos de integración, utilizando servicios cloud AWS y Azure para alojar tanto los agentes IA como los sistemas de ejecución. Además, incorporamos prácticas de ciberseguridad para proteger las capas de comunicación y ofrecemos inteligencia artificial para empresas que potencia procesos con agentes IA autónomos. Todo ello se complementa con servicios de inteligencia de negocio mediante Power BI, permitiendo a nuestros clientes visualizar y explotar la información que fluye a través de estas arquitecturas limpias y modulares.