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

# Asistentes de IA

> Conecta Atlas a Claude, ChatGPT o Codex y preguntale por tu flota con tu propia cuenta.

Atlas se puede conectar a tu asistente de IA. Una vez conectado, le preguntás por tu flota
en lenguaje natural («¿dónde está la camioneta AB-CD-12?») y el asistente responde con los
datos de Atlas, usando **tu cuenta** y viendo exactamente lo mismo que ves vos en la
plataforma.

No hace falta instalar nada ni pedirle nada a UGPS: cualquier usuario de Atlas puede
conectar su asistente desde la configuración del propio asistente.

## Qué necesitás

* Una cuenta de Atlas (la misma con la que entrás a `atlas.ugps.io`).
* Un asistente que admita conectores: **Claude**, **ChatGPT** o **Codex**. Los pasos de cada
  uno están más abajo.
* La dirección de la conexión, que es siempre la misma:

```
https://mcp.ugps.io/mcp
```

## Conectar Claude

Funciona en Claude web (`claude.ai`), en la aplicación de escritorio y en el celular con
cualquier plan, incluido el gratuito (que permite un solo conector personalizado).

<Steps>
  <Step title="Abrir los conectores">
    En Claude, entrá a **Configuración → Conectores** (en la web aparece como
    **Personalizar → Conectores**, desde el ícono de herramientas abajo a la izquierda).
  </Step>

  <Step title="Agregar el conector">
    Elegí **Agregar conector personalizado**, pegá `https://mcp.ugps.io/mcp` como dirección
    y confirmá con **Agregar**. No hace falta completar la configuración avanzada.
  </Step>

  <Step title="Autorizar con tu cuenta de Atlas">
    Claude abre una ventana de Atlas. Seguí los pasos de [la pantalla de
    autorización](#la-pantalla-de-autorizacion).
  </Step>

  <Step title="Activar Atlas en una conversación">
    En el chat, tocá el botón **+** y marcá **Atlas** en la lista de conectores. Ya podés
    preguntar.
  </Step>
</Steps>

Si tu empresa usa Claude con un plan Team o Enterprise, el conector lo agrega el
administrador del espacio de trabajo; vos solo entrás a **Conectores** y elegís **Conectar**
junto a Atlas.

## Conectar ChatGPT

Requiere un plan con conectores (Plus, Pro, Business, Enterprise o Edu). En planes Business
y Enterprise el administrador del espacio de trabajo tiene que habilitar antes los
conectores personalizados.

<Steps>
  <Step title="Activar el modo desarrollador">
    En ChatGPT, entrá a **Configuración → Aplicaciones y conectores** y activá el **Modo
    desarrollador** (en algunas versiones está bajo **Configuración → Seguridad**).
  </Step>

  <Step title="Crear el conector">
    En **Aplicaciones y conectores** elegí **Crear**. Poné **Atlas** como nombre, una
    descripción corta («Mi flota en Atlas») y `https://mcp.ugps.io/mcp` como dirección.
    Dejá la opción de autenticación que viene por defecto (la que abre una ventana para
    iniciar sesión) y confirmá.
  </Step>

  <Step title="Autorizar con tu cuenta de Atlas">
    ChatGPT abre una ventana de Atlas. Seguí los pasos de [la pantalla de
    autorización](#la-pantalla-de-autorizacion).
  </Step>

  <Step title="Usar Atlas en una conversación">
    En el chat, abrí el menú **+ → Más** y elegí **Atlas**. Ya podés preguntar.
  </Step>
</Steps>

## Conectar Codex

Codex (la línea de comandos, la aplicación y la extensión del editor) comparte una sola
configuración. Desde una terminal:

```bash theme={null}
codex mcp add atlas --url https://mcp.ugps.io/mcp
codex mcp login atlas
```

El segundo comando abre en tu navegador la ventana de Atlas. Seguí los pasos de [la
pantalla de autorización](#la-pantalla-de-autorizacion) y volvé a la terminal: Atlas queda
disponible en todas tus sesiones de Codex.

## La pantalla de autorización

Cualquiera sea el asistente, la conexión se aprueba en una ventana de Atlas con tres pasos:

1. **Conecta tu cuenta de Atlas.** Ingresá tu correo y contraseña de Atlas, los mismos de
   `atlas.ugps.io`.
2. **Verifica tu identidad.** Si tu cuenta usa verificación en dos pasos, ingresá el código
   que te llega por correo.
3. **Autoriza la conexión.** Atlas te muestra la cuenta y la empresa con las que se va a
   conectar el asistente y lo que podrá hacer: identificar tu cuenta, consultar tu nombre y
   correo, mantener la conexión cuando no estés usando Atlas y consultar los datos de Atlas
   disponibles para tu cuenta. Si todo es correcto, tocá **Autorizar conexión**; si no,
   **Cancelar**.

Al terminar, la ventana vuelve sola al asistente. La conexión dura hasta 30 días; cuando
vence, el asistente te vuelve a pedir que autorices.

<Warning>
  Aprobá la conexión solo si el nombre de la aplicación que muestra la pantalla es el del
  asistente que estás configurando. Si te aparece esa pantalla sin que hayas iniciado vos una
  conexión, elegí **Cancelar**.
</Warning>

## Qué le podés preguntar

Preguntá como le preguntarías a una persona del equipo. Algunos ejemplos:

* «¿Dónde está la camioneta AB-CD-12 ahora?»
* «¿Qué vehículos están en movimiento en este momento?»
* «¿Qué viajes hizo el camión 12 ayer?»
* «¿Cuántos kilómetros recorrió la flota esta semana?»
* «¿Hubo alertas de exceso de velocidad esta semana?»
* «¿Qué tareas de terreno quedaron pendientes hoy?»
* «¿Quién hizo check-in en el cliente Los Álamos esta mañana?»
* «Dame un resumen del trabajo de terreno del mes.»
* «Listame los vehículos del grupo Reparto.»

Si no sabés por dónde empezar, preguntale al asistente **«¿qué podés hacer con Atlas?»** y
te lo explica con sus palabras.

## Qué no hace

* **No modifica nada.** El asistente solo consulta: no crea, edita ni borra vehículos, tareas,
  alertas ni ninguna otra información de Atlas.
* **No ve más que vos.** Responde únicamente con los vehículos, grupos y datos a los que tu
  usuario tiene acceso en Atlas. Si tu cuenta no ve un vehículo, el asistente tampoco.
* **No comparte tu contraseña.** El asistente nunca recibe tu contraseña ni tu código de
  verificación; solo Atlas los ve, en su propia ventana.

## Desconectar

Para que el asistente deje de tener acceso, quitá el conector desde el propio asistente:

* **Claude:** en **Conectores**, abrí el menú del conector Atlas y elegí **Quitar**.
* **ChatGPT:** en **Aplicaciones y conectores**, abrí el conector Atlas y elegí **Eliminar**.
* **Codex:** ejecutá `codex mcp remove atlas` en una terminal.

Si sospechás que alguien más usó tu cuenta para conectar un asistente, cambiá tu contraseña
de Atlas y avisale a tu contacto de soporte de UGPS para revocar las conexiones existentes.

## Preguntas frecuentes

**¿Tiene costo?** Conectar Atlas no tiene costo adicional. El asistente sí puede exigir un
plan pago para admitir conectores; eso lo define cada proveedor.

**¿Puedo conectar más de un asistente?** Sí. Cada asistente hace su propia conexión y se
autoriza por separado.

**¿Los datos quedan guardados en el asistente?** Atlas responde cada pregunta en el momento
y no le entrega al asistente más que lo necesario para contestar. Qué hace el asistente con
esa conversación depende de las condiciones de cada proveedor.

**¿Sirve para varios usuarios de mi empresa?** Sí. Cada persona conecta su propio asistente
con su propia cuenta de Atlas y ve solo lo que su usuario puede ver.