Elige una ruta de integración
Elige la ruta según quién sea el propietario de la cuenta conectada, dónde se ejecuten las llamadas y quién opere el límite de credenciales.
Compara las cuatro rutas
| Ruta | La cuenta conectada pertenece a | Las llamadas se ejecutan a través de | Tú operas |
|---|---|---|---|
| Configuración del Agent | Ti | oo CLI u OOMOL MCP | El entorno del Agent |
| Hosted Connector SDK | Ti | OOMOL hosted gateway | Tu código de backend |
| Connector SaaS project | Cada usuario de tu producto | OOMOL hosted gateway | Tu producto y el mapeo de usuarios |
| Self-hosted OpenConnector | Tú o tu organización | Tu runtime de OpenConnector | Runtime, almacenamiento, seguridad y actualizaciones |
Usa OOMOL desde un Agent
Elige esta ruta cuando quieras que Codex, ChatGPT, Claude Code u otro Agent compatible trabaje con las Apps que conectes.
Harás lo siguiente:
- Conecta una App en OOMOL.
- Instala oo CLI en el Agent o configura un cliente MCP.
- Pide al Agent que use la App conectada.
Empieza con la Quickstart.
Llama a tus propias conexiones desde el código de backend
Elige el cliente alojado Connector cuando un backend de confianza necesite llamar a Apps conectadas a tu cuenta de OOMOL.
Esta ruta usa una clave de API personal con el formato api_…. La clave permanece en el backend y autoriza llamadas en tus propias conexiones.
Lee la guía de OOMOL Connector SDK.
Permite que los usuarios finales conecten sus cuentas
Elige Connector para SaaS cuando cada usuario de tu producto necesite autorizar su propia cuenta de Gmail, Slack, Notion u otro proveedor.
Tu backend crea enlaces de autorización, almacena tu ID de usuario junto al ID de la cuenta conectada resultante y ejecuta acciones para ese usuario. Esta ruta usa una clave de API de proyecto con el formato oo_proj_….
Lee la guía de Connector para SaaS.
Ejecuta OpenConnector tú mismo
Elige el autoalojamiento cuando tu equipo deba operar el runtime, la base de datos, el cifrado de credenciales, el acceso de red, los registros y el proceso de actualización.
Los clientes de runtime pueden usar un token con el formato oct_…. Las apps de OAuth del proveedor, las claves de cifrado, el almacenamiento, las copias de seguridad y la política de acciones siguen siendo tu responsabilidad.
Lee la guía de autoalojamiento de OOMOL OpenConnector.
Alcance de las credenciales por producto
| Credencial | Usada por | Alcance |
|---|---|---|
api_… | Cliente alojado Connector | Tus conexiones personales |
oo_proj_… | ProjectConnector y API de SaaS | Un proyecto de Connector y sus usuarios finales |
oct_… | Cliente OpenConnector, HTTP o MCP | Un runtime autoalojado |
Mantén los tres tipos de credenciales en un backend de confianza, un gestor de secretos o un entorno de Agent protegido. No los coloques en paquetes de navegador, repositorios públicos ni prompts.
Decide con tres preguntas
- ¿De quién es la cuenta que se está conectando? Tu cuenta apunta a la configuración del Agent o al SDK personal. Las cuentas de usuarios finales apuntan a un proyecto SaaS.
- ¿Quién debería operar el almacenamiento de credenciales y la renovación de tokens? Usa el alojamiento de OOMOL para reducir el trabajo de operaciones; autoaloja cuando tu equipo deba ser el propietario de ese límite.
- ¿Dónde se llamará a las acciones? Usa la configuración del Agent para trabajo interactivo con Agent y una ruta de SDK o HTTP para llamadas de backend de producto.
Después de elegir una ruta, sigue su Quickstart antes de agregar más proveedores o política de producción.
Wanta