Saltar al contenido principal
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

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.
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

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.