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

# Conectores

> Conectá la API de tu empresa o un servidor MCP para que los agentes consulten stock, pedidos o clientes, con la política que elijas para cada acción.

Un **conector** le da a tus agentes acceso a un sistema de tu empresa: tu propia **API HTTP** o un **servidor MCP**. Cada cosa que el agente puede hacer ahí es una **acción**, y cada acción tiene su política: si corre sola, si la confirma el cliente o si la aprueba el equipo.

La URL y la clave quedan del lado de la app: **el agente nunca las ve**.

## Crear una conexión

En **Conectores**, tocá **Nueva conexión**:

* **Nombre**: por ejemplo, Sistema de pedidos.
* **URL del servidor MCP** (Streamable HTTP, por HTTPS) o **URL base de la API** (solo HTTPS y hosts públicos; las acciones agregan su ruta a esta URL).
* **Autenticación**: **Sin autenticación**, **Token (Bearer)**, **Usuario y contraseña**, **Clave en un header** u **OAuth2 (client credentials)**. Los secretos se guardan cifrados y no se vuelven a mostrar.

## Las acciones

**Servidor MCP**

Tocá **Leer herramientas**: cada herramienta del servidor aparece como una acción, **apagada**. Revisala, elegí su política y activala.

Si el servidor cambia, volvé a tocar **Leer herramientas**. Las nuevas se agregan; las que cambiaron quedan marcadas **Cambió en el servidor** hasta que las revises; las que ya no están quedan apagadas.

**API HTTP**

Tocá **Nueva acción** para armar una a mano, o **Importar OpenAPI** para pegar un documento OpenAPI (JSON o YAML): cada operación se vuelve una acción apagada, las de lectura automáticas y las que modifican con confirmación del cliente.

En el **Pedido**, usá `{{campo}}` para lo que completa el agente, y `{{contact.phone}}`, `{{contact.email}}` o `{{contact.name}}` para el cliente de la conversación: esos los pone la app y el agente no puede cambiarlos.

En cada acción:

* **Para el agente**: su **Nombre** (minúsculas, números y \_, como `consultar_stock`) y **Cuándo usarla**: qué hace, cuándo conviene y qué devuelve. Sin descripción, el agente no sabe cuándo usarla.
* **Cuándo corre**: la política (ver abajo).
* **Datos que completa el agente**: un JSON Schema (en MCP, los define el servidor).
* **Respuesta**: los **Campos que lee** el agente (un camino por línea, como `pedido.estado` o `items[].precio`), el **Máximo de ítems** y la **Espera máxima (s)**. Menos es mejor: más rápido, más barato y sin datos de más.
* **Probar**: corre la acción con datos de prueba y muestra lo que leería el agente. Si la acción modifica tu sistema, la prueba lo hace de verdad.

## Políticas

| Política | Qué pasa |
| - | - |
| **Automática** | El agente la usa cuando hace falta. |
| **Confirma el cliente** | El agente le explica qué va a hacer y espera su sí en la conversación. |
| **Aprueba el equipo** | Queda esperando que alguien del equipo la apruebe; el agente le avisa al cliente el resultado. Ver [Aprobaciones](https://help.desk.min-ai.ar/es/atender/aprobaciones.md). |

> [!WARNING]
>
> Una acción que **modifica** tu sistema con política **Automática** corre sin que nadie la confirme. Usalo solo si es inofensiva.

## Darle acciones a un agente

Una acción activa todavía no la usa nadie: en el agente, pestaña **Herramientas → Acciones en tus sistemas**, prendé las que puede usar. Ver [Agentes](https://help.desk.min-ai.ar/es/configurar/agentes.md#herramientas).


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