# Cómo funcionan los conectores

Los <Term id="connector">conectores</Term> vinculan las herramientas de su equipo con su <Term id="workspace">espacio de trabajo</Term>. Un <Term id="project">proyecto</Term> puede leer de ellas, llevar datos a <Term id="nexus">Nexus</Term> y enviar resultados de vuelta.

## Dos formas de conectar [#dos-formas-de-conectar]

| | GitHub (nativo) | Todos los demás (IA) |
| --- | --- | --- |
| **Quién lo conecta** | Un propietario o administrador del espacio de trabajo, una vez para todo el espacio | Cualquier persona que trabaje en un proyecto, con la IA de ese proyecto |
| **Cómo** | Instala la aplicación de Klarety en GitHub y elige repositorios | La IA prepara la conexión; usted la termina con su clave o inicio de sesión |
| **Dónde se usa** | Cada proyecto puede vincular uno de los repositorios elegidos | El proyecto donde se creó, más los proyectos que active un administrador |

La [guía de GitHub](/docs/es/connectors/github) cubre el conector nativo. Esta página cubre el flujo con IA.

## Cómo conecta la IA un servicio [#cómo-conecta-la-ia-un-servicio]

### 1. Usted lo pide [#1-usted-lo-pide]

<ForEveryone>
Abra un conector en <AppLink to="connectors" /> y use **Conéctelo con la IA de su Studio**: elija un **Proyecto**, revise **Lo que se le pide a la IA** y seleccione **Enviar a la IA**. O, dentro de un proyecto, vaya a **Configuración**, luego **Claves**, y use **Pedir a la IA que conecte**.

<Screenshot src="/docs/_media/connect-data-with-ai-in-dashboard-data-page.png" alt="La página de un conector con Conéctelo con la IA de su Studio, el selector de Proyecto y Enviar a la IA" />
</ForEveryone>

<ForDevelopers>
```python title="ask_ai.py"
from klarety import Nexus

nx = Nexus.connect("YOUR_API_KEY")
nx.service_connections.ask_ai("PROJECT_ID", "Connect Stripe so it can read payments")
```
</ForDevelopers>

### 2. La IA prepara la conexión [#2-la-ia-prepara-la-conexión]

La IA averigua el sitio, el tipo de clave y cómo obtenerla. El borrador no tiene clave, no llega a ninguna parte y aparece como **Esperando su respuesta**.

<Callout type="info" title="La IA nunca pide una clave en el chat">
  Nunca pegue una clave en un chat. Las claves van solo en el diálogo de conexión.
</Callout>

### 3. Usted la termina [#3-usted-la-termina]

Seleccione **Conectar**. El diálogo le pide una de:

- una **Clave**, con un enlace a la página donde obtenerla;
- un **Nombre de usuario** y una **Contraseña**, para bases de datos;
- un inicio de sesión con el proveedor, para servicios como Google y Microsoft.

Elija **Qué puede hacer la IA con ello**: **Puede leer** o **Puede leer y modificar**. Luego seleccione **Conectar**, **Probar** y **Avisar a la IA**.

<Screenshot src="/docs/_media/slack-connector-how-to-connect-in-ui.png" alt="El diálogo de conexión pidiendo una clave" />

### 4. El proyecto la usa [#4-el-proyecto-la-usa]

El <Term id="studio">Studio</Term> llama al servicio y la clave se agrega en el camino de salida. La clave nunca entra al Studio.

## Qué protege sus claves [#qué-protege-sus-claves]

- **Selladas al instante.** Se cifran con un servicio de claves administrado en cuanto selecciona **Conectar**. Nadie, ni siquiera la IA, puede volver a leerlas.
- **Un solo sitio.** El diálogo muestra el único sitio al que se envía la clave. Si no es la dirección propia del servicio, Klarety lo advierte y le pide escribirla para confirmar.
- **El acceso mínimo.** Elija **Puede leer y modificar** solo cuando el trabajo lo necesite.
- **Ajuste de internet.** Un proyecto con internet **Desactivado** no puede usar conexiones. Con **Solo permitidos**, su Studio solo llega a sus conexiones y a los sitios que usted agregue.

## Ver y administrar las conexiones [#ver-y-administrar-las-conexiones]

<ForEveryone>
En un proyecto, abra **Configuración** y luego **Claves**. Cada conexión muestra **Esperando su respuesta**, **Funciona**, **Requiere reconexión** o **En pausa**, con **Conectar** o **Reconectar**, **Probar**, **Pausar** o **Reanudar**, **Desactivar aquí** y **Quitar**.

Propietarios y administradores también ven **Sus conexiones** en <AppLink to="connectors" />. Una conexión sigue desactivada para otros proyectos hasta que un administrador la active.

<Screenshot src="/docs/_media/project-page-nexus-data-connections.png" alt="El mapa de conexiones de un proyecto, con cada conexión y tabla y su acceso" />
</ForEveryone>

<ForDevelopers>
```python title="manage_connections.py"
from klarety import Nexus

nx = Nexus.connect("YOUR_API_KEY")

listed = nx.service_connections.list("PROJECT_ID")
for connection in listed["connections"]:
    print(connection["name"], connection["health"])

result = nx.service_connections.check("PROJECT_ID", "CONNECTION_ID")
print(result["result"], result["detail"])

nx.service_connections.change("CONNECTION_ID", paused=True)
nx.service_connections.switch("CONNECTION_ID", "OTHER_PROJECT_ID", on=True)
```

`health` es `waiting`, `works`, `needs_reconnecting` o `paused`. `check` devuelve `result` como `works`, `key_rejected`, `cannot_reach`, `internet_off` o `not_connected`, con un `detail` legible, nunca la clave. `org()` lista las conexiones del espacio de trabajo y `switch` activa una para un proyecto (solo propietarios y administradores).
</ForDevelopers>

## Webhooks [#webhooks]

Un servicio puede llamar a su proyecto cuando algo ocurre. En **Configuración**, **Claves**, seleccione **Agregar webhook**, dele al servicio la dirección que muestra Klarety y pegue su secreto de firma. Klarety verifica cada llamada. Vea un ejemplo en la [guía de Stripe](/docs/es/connectors/stripe).

## Siguientes pasos [#siguientes-pasos]

- [Todos los conectores](/docs/es/connectors/catalog)
- [GitHub](/docs/es/connectors/github)
- [Amazon S3](/docs/es/connectors/amazon-s3)
- [PostgreSQL](/docs/es/connectors/postgresql)