Construye para el ecosistema con tu propio agente

Construye extensiones de SOIS con el agente de IA que ya usas (Claude, ChatGPT, Cursor, Gemini, o cualquier herramienta compatible con MCP). Conectas tu agente al servidor MCP de SOIS, construyes la extensión en tu propia máquina, y luego la subes para revisión y publicación. Usas tu propia IA; SOIS no cobra nada por construir.

Este es el camino del ecosistema. Cualquiera puede construir para el mercado y ganar con sus aplicaciones. No necesitas el portal de desarrollador para construir una extensión personalizada; conectar tu agente es suficiente. El portal es donde publicas en el mercado y gestionas tus pagos. Consulta Monetiza tus aplicaciones para el modelo de ingresos.

Cómo funciona

  1. Conecta tu agente al servidor MCP de tu espacio de trabajo (OAuth, o un token).
  2. Construye localmente contra la especificación de SOIS que tu agente lee por MCP.
  3. Valida con una verificación estática gratuita hasta que quede limpia.
  4. Sube el paquete. Se endurece, se controla y se pone en cola para revisión.
  5. Revisa y publica. Una vez aprobada, tu extensión queda activa en el mercado.

Conecta tu agente

Las herramientas de construcción viven en el propio servidor MCP de tu espacio de trabajo, el mismo extremo que se describe en Servidor MCP. No hay un servidor de construcción separado que configurar: te conectas una vez y, como tu cuenta puede construir, las herramientas de construcción aparecen automáticamente en la lista de herramientas de tu agente. Están controladas por administrador, por lo que solo se muestran para cuentas con capacidad de constructor.

Server:     https://<your-workspace-host>/api/mcp
Discovery:  https://<your-workspace-host>/.well-known/mcp.json

Conexión: la ruta recomendada es OAuth. Agrega la URL de MCP a tu cliente (Claude, ChatGPT, Cursor y otros); este descubre el inicio de sesión y se conecta sin necesidad de pegar nada. Un token Bearer más un encabezado X-Api-Key también funciona para clientes que no usan OAuth. Consulta Servidor MCP para el flujo completo de conexión y los detalles de descubrimiento.

Tu agente entonces tiene las herramientas de construcción disponibles. Comienza cada construcción pidiéndole que lea las reglas.

Las herramientas de construcción

Tool What it does
getExtensionRules El manifiesto canónico, migración, permiso, kit de herramientas, i18n, interfaz de usuario y reglas de seguridad. Llama primero a esta.
getExtensionFrameSpec El contrato del marco del host para la vista previa local: la firma de montaje, los tokens de tema, la forma de la API REST y el formato del paquete.
createExtensionProject Crea un nuevo proyecto de aplicación. Devuelve un project_id.
validateExtensionBundle Ejecuta en seco la puerta estática gratuita sobre tus archivos y devuelve los problemas a corregir. Ejecútala tantas veces como quieras.
uploadExtensionBundle Envía tu paquete. Se endurece, se controla y, si pasa, se pone en cola para revisión.
getExtensionStatus El estado del ciclo de vida y el último informe de validación de un proyecto.
listExtensionProjects Tus proyectos y su estado.

Formato del paquete

Una extensión es un paquete pequeño de archivos:

File Purpose
manifest.json La única fuente de verdad: id, entidades, modelo de datos, permisos, archivos.
index.js La interfaz de usuario, escrita como un IIFE de JavaScript vainilla que se monta mediante window.AppExtension.mount. Ningún framework en el paquete.
toolkit.js Herramientas de agente opcionales, siguiendo el patrón del examinador.
permissions.json Claves de permiso que coinciden con tus nombres de ruta.
migrations/ Tablas de base de datos nombradas ext_{name}_{table} con un id y una columna JSON data.
lang/ Archivos de configuración regional, cada clave con el prefijo ext_{name}.

Reglas clave que tu agente aplica desde getExtensionRules:

  • Los campos de negocio viven dentro de la columna JSON data, no como columnas separadas.
  • Sin claves foráneas entre extensiones, sin DROP, TRUNCATE ni dropColumn en un up() de migración, sin SQL crudo, sin acceso a shell ni al sistema de archivos.
  • Da estilo a la interfaz de usuario con los tokens de tema --ext-* para que coincida con SOIS. Nunca codifiques colores ni texto visible al usuario.

Valida antes de subir

validateExtensionBundle ejecuta la misma puerta estática gratuita que el servidor ejecuta al subir, para que puedas corregir problemas localmente primero. Comprueba tipos de archivo, seguridad de migraciones, estructura del manifiesto, nomenclatura e i18n. La puerta del lado del servidor es siempre la autorizada: pasar localmente es una conveniencia, no una garantía.

Sube, revisa, publica

Cuando uploadExtensionBundle informa un pase, tu paquete se almacena en un área de revisión privada y tu proyecto pasa a revisión. Un revisor lo comprueba y, o bien lo aprueba (lo que lo publica en el mercado), o bien lo devuelve con comentarios para que lo corrijas y lo subas de nuevo.

Próximos pasos