Descripción general de OpenConnector
OpenConnector es un proyecto con código fuente disponible de OOMOL. Consulta el catálogo de conectores para ver las integraciones disponibles. Esta guía cubre el despliegue y la operación en tiempo de ejecución.
OOMOL OpenConnector es un entorno de ejecución de conexiones con código fuente disponible y autoalojable. Úsalo cuando tu organización necesite operar el almacenamiento de credenciales, las conexiones con proveedores, el acceso a la red, la política de acciones, los registros y las actualizaciones dentro de su propio entorno.
El entorno de ejecución expone las acciones de los proveedores a través de MCP, HTTP, OpenAPI y una consola web. Los Agents y los clientes trabajan con esquemas, etiquetas de conexión, ámbitos y resultados, mientras que las credenciales sin procesar de los proveedores permanecen dentro del límite de tu despliegue.
Licencia y uso comercial
OpenConnector utiliza OpenConnector License, una versión modificada de Apache 2.0 con condiciones adicionales.
La licencia permite el uso comercial, la modificación, el uso interno en tu organización y los despliegues para uso interno de la organización de un cliente. También puedes integrar OpenConnector en un producto cuyo valor principal resida en otras funciones y permitir que sus usuarios conecten sus cuentas como parte del uso del producto.
Ofrecer OpenConnector o una versión modificada a terceros como servicio alojado o gestionado cuyo valor principal sean las funciones de OpenConnector requiere una licencia comercial de OOMOL. Esto incluye pasarelas de conexión, plataformas de integración y API que permiten a terceros conectar cuentas y ejecutar operaciones de OpenConnector.
Las versiones publicadas hasta la v1.9.4 inclusive siguen bajo Apache 2.0 sin modificaciones. Las condiciones de las API de terceros y sus requisitos de autorización siguen aplicándose.
Elegir un destino de despliegue
| Destino | Úsalo cuando |
|---|---|
| Docker Compose | Quieras la vía más corta hacia un entorno de ejecución local o en un solo servidor |
| Entorno de ejecución desde el código fuente | Estés desarrollando OpenConnector o ejecutores de proveedores |
| Cloudflare Workers | Quieras registros del entorno de ejecución en D1 y archivos de tránsito temporales en R2 |
La guía de autoalojamiento cubre los tres destinos.
Qué operas
Tu equipo es responsable de:
- Los tokens de administrador y de acceso al entorno de ejecución.
- Las claves de cifrado de credenciales y el almacenamiento sensible del entorno de ejecución.
- El origen público utilizado por las URL de callback de OAuth.
- Los clientes OAuth de los proveedores o las configuraciones de claves de API.
- Las listas de acciones permitidas y bloqueadas.
- Las copias de seguridad, los controles de red, la monitorización y las actualizaciones.
Conectar proveedores
OpenConnector admite conexiones de proveedores mediante clave de API, credencial personalizada, OAuth2 y sin autenticación. Empieza con la guía general de configuración de aplicaciones OAuth, y luego abre una guía específica del proveedor cuando este requiera su propia configuración:
Empezar con un entorno de ejecución protegido
Establece un token de administrador y una clave de cifrado de credenciales antes de exponer el entorno de ejecución fuera de tu propio shell. Crea tokens de entorno de ejecución separados para los Agents y los clientes, y limita las acciones disponibles a las operaciones que requieran.
Sigue la guía de autoalojamiento de OOMOL OpenConnector para desplegar el entorno de ejecución. Luego llama a tu entorno de ejecución autoalojado con el SDK de OpenConnector desde TypeScript.