Descripción general de Connector

OOMOL Connector es un servicio de conexión alojado para personas y equipos. Conecta Apps como Gmail, GitHub, Notion o Slack, y luego usa acciones aprobadas desde un Agent o un backend de confianza mientras OOMOL gestiona OAuth, el almacenamiento de credenciales, la actualización de tokens y la ejecución de acciones.

Esta ruta usa una clave de API personal con el formato api_…. Guarda la clave en un entorno de backend o en un gestor de secretos.

Consulta Gestión de equipos cuando necesites invitar a compañeros de trabajo, asignar roles o controlar el acceso a las conexiones.

Por qué usar OOMOL Connector

Conecta una vez, úsalo en varios lugares: llama a la misma conexión de App a través de oo CLI, MCP o el SDK, y reutilízala en los Agents compatibles.
Reduce las operaciones de autenticación: OOMOL gestiona los flujos de OAuth, el almacenamiento de credenciales y la actualización de tokens.
Mantén protegidas las credenciales de las cuentas: los Agents, Skills y el código de la aplicación usan acciones aprobadas sin recibir tokens OAuth sin procesar.
Controla el acceso con precisión: configura las acciones permitidas para cada conexión y los miembros del equipo que pueden usarla.
Admite a personas y equipos: las personas pueden conectar sus propias Apps, mientras que los equipos pueden compartir conexiones y gestionar el acceso de los miembros.

Elige la ruta correcta de Connector

Objetivo	Ruta
Llamar a Apps conectadas a tu cuenta de OOMOL	Cliente `Connector` alojado
Permitir que cada usuario del producto conecte su propia cuenta	Integración SaaS
Operar tú mismo el entorno de ejecución y el almacenamiento de credenciales	OpenConnector

Cómo funciona una llamada

Conecta una cuenta de App en OOMOL.
Crea una clave de API personal de Connector en OOMOL Console.
Inicializa @oomol-lab/connector en código de backend de confianza.
Selecciona una acción y, cuando sea necesario, una conexión con nombre.
Connector llama al proveedor y devuelve el resultado de la acción.

Tu backend recibe los resultados de las acciones sin leer el token OAuth sin procesar del proveedor. Usa executeRaw cuando también necesites los metadatos de ejecución; execute devuelve solo el resultado de la acción.

Capacidades del SDK

Necesidad	Superficie del SDK
Ejecutar una operación modelada	`execute` o `executeRaw`
Llamar a un endpoint sin una acción modelada	`proxy`
Descubrir proveedores y esquemas de acciones	`catalog`
Enumerar cuentas conectadas	`apps.list`

Empieza a crear

Sigue Llamar a Apps conectadas con el SDK para instalar el paquete, crear una clave de API, hacer la primera llamada y seleccionar una conexión. Usa la Referencia del SDK de TypeScript para la configuración compartida, el manejo de errores y la superficie completa de la API.

Mantén la clave en el backend

No incluyas una clave de API personal en paquetes del navegador, repositorios públicos, prompts ni registros del lado del cliente. Usa un proyecto de Connector SaaS cuando las solicitudes deban limitarse a usuarios individuales del producto; no compartas una clave personal entre usuarios finales no relacionados.