> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kolmena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conecta aplicaciones a los agentes de Kolmena

> Explora el catálogo de integraciones, conecta una aplicación mediante OAuth o una clave de API, actívala para tus agentes y desconéctala cuando ya no la necesites.

Conectar aplicaciones da a tus agentes acceso a servicios reales como Gmail, Slack, Notion, GitHub y muchos más. Exploras el catálogo, conectas tu cuenta y eliges qué agentes pueden usar cada integración.

[Connecting Your Tools](https://www.youtube.com/embed/pzdY4ghJey4)

## Explorar el catálogo

Abre **Integraciones** desde la barra lateral. La página muestra dos pestañas:

* **Todas**: todas las integraciones del catálogo, agrupadas por categoría.
* **Activadas**: solo las integraciones que has activado para tu espacio de trabajo.

Usa la barra de búsqueda para encontrar una aplicación por su nombre o describe lo que quieres hacer. También puedes filtrar por categoría.

## Conectar una aplicación

La forma de conectarse depende del tipo de autenticación de la aplicación:

**1. Busca la aplicación**

Explora el catálogo o busca en él, y haz clic en la tarjeta de la integración para abrir sus detalles.

**2. Actívala**

Activa el interruptor para habilitar la integración en tu espacio de trabajo. Si la aplicación requiere una credencial, la ventana abre automáticamente la pestaña **Cuentas**.

**3. Autentícate**

> [accordion] OAuth (inicio de sesión con el proveedor)
>
> Haz clic en **Conectar** e inicia sesión con el proveedor (por ejemplo, Google para Gmail) en la ventana emergente. El token se guarda de forma segura y no vuelve a mostrarse.

> [accordion] Clave de API o token
>
> Pega la clave o el token en el formulario de credenciales. El valor se envía de forma segura y nunca se guarda en el chat.

> [accordion] Sin autenticación
>
> Algunas aplicaciones no requieren iniciar sesión. La credencial de la pasarela se gestiona automáticamente al activar la integración.

**4. Elige qué agentes pueden usarla**

En la pestaña **Agentes** de la ventana, marca los agentes a los que quieres dar acceso. Por defecto, activar una integración para el espacio de trabajo la pone a disposición de todos los agentes excepto Maya. Si quieres que Maya la use, tienes que concederle acceso de forma explícita.

**5. Acota las acciones**

En la pestaña **Acciones**, elige qué herramientas puede usar el agente. Puedes volver al conjunto predeterminado en cualquier momento con **Restablecer valores predeterminados**.

## Activar para Maya o para un solo agente

En lugar de activar una aplicación para todo el espacio de trabajo, puedes vincularla a un solo agente:

1. Abre el agente y ve a **Configurar > Integraciones**.
2. Busca la aplicación en el catálogo y actívala.
3. Conecta tu cuenta si es necesario.
4. Ajusta las acciones permitidas en la pestaña **Acciones**.

Vincular la aplicación a un agente sustituye la configuración predeterminada del espacio de trabajo para ese agente.

## Desconectar una aplicación

Para quitar una integración:

1. Abre la tarjeta de la integración desde la pestaña **Activadas** o desde la página **Integraciones** del agente.
2. Desactiva el interruptor.
3. Si también quieres revocar la credencial guardada, abre la pestaña **Cuentas** y haz clic en **Desconectar**.

> [!WARNING]
>
> Desconectar elimina la credencial guardada. Puedes volver a conectar en cualquier momento, pero tendrás que iniciar sesión o pegar la clave de nuevo.

## Estados de conexión

| Estado | Qué significa |
| - | - |
| Conectado | La aplicación está lista para usarse. |
| Requiere reconexión | La credencial existe, pero el proveedor la revocó. Desconecta y vuelve a conectar para solucionarlo. |
| No conectado | No hay ninguna credencial guardada. Conecta para activar la aplicación. |

## Próximos pasos

> [card] [Habilidades](https://docs.kolmena.ai/es/integrations/skills.md)
>
> Gestiona las habilidades que pueden usar tus agentes.

> [card] [Credenciales](https://docs.kolmena.ai/es/integrations/credentials.md)
>
> Añade y concede credenciales.

> [card] [Navegadores](https://docs.kolmena.ai/es/integrations/browsers.md)
>
> Vincula un navegador para acceder a la web en vivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.