---
title: Descripción general de Connector
description: Llama a las Apps conectadas a tu cuenta de OOMOL desde código de
  backend confiable con la puerta de enlace alojada de Connector.
lang: es
canonical_url: https://oomol.com/es/docs/connector/
markdown_url: https://oomol.com/es/docs/connector.md
---

# 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](/es/docs/team-management/) 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](/es/docs/saas/) |
| Operar tú mismo el entorno de ejecución y el almacenamiento de credenciales | [OpenConnector](/es/docs/openconnector/) |

## Cómo funciona una llamada

1. Conecta una cuenta de App en OOMOL.
2. Crea una clave de API personal de Connector en OOMOL Console.
3. Inicializa `@oomol-lab/connector` en código de backend de confianza.
4. Selecciona una acción y, cuando sea necesario, una conexión con nombre.
5. 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](/es/docs/connector-client/) 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](/es/docs/connector-sdk/) 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.