# Quickstart

Objetivo: menos de diez minutos desde el alta hasta un agente que contesta. Se mide, y lo que sigue es el camino que la plataforma misma te guía en el Inicio.

## 1. Registrarse

En [yorobot.ai/registrarse](https://yorobot.ai/registrarse). La organización nace con un agente llamado **Bienvenida**: corre en el ambiente `dev`, tiene un tope de US$ 1, no tiene herramientas ni credenciales. Y con la **tienda de ejemplo**: un agente (*Atención de pedidos*) que consulta un sistema de pedidos de mentira que sirve YoRobot, con dos conexiones sin llave —una lee, la otra le «avisa» al cliente y espera tu aprobación— y cuatro casos para evaluarlo. Nada de lo que hace le llega a nadie. Si tu organización es de antes, `instalar_ejemplo` la instala.

## 2. Conectar el editor

El servidor MCP habla **OAuth 2.1**: lo agregás sin token, el editor abre el navegador, elegís la organización y autorizás. El acceso actúa en tu nombre con tu rol de hoy, dura 8 horas y el editor lo renueva solo hasta 30 días.

```bash
# Claude Code
claude mcp add --transport http yorobot https://yorobot.ai/api/mcp

# Codex
codex mcp add yorobot --url https://yorobot.ai/api/mcp
codex mcp login yorobot
```

En Claude Code, después de agregarlo escribí `/mcp` y autorizá. **Si no aparece en la lista, la sesión todavía no leyó el servidor nuevo**: reiniciala (o abrí otra en el mismo proyecto) y volvé a escribir `/mcp`. En la pestaña Code de la app de escritorio de Claude, `claude` no está en el PATH (la app trae su propio Claude Code): en lugar del comando, agregá esto al `.mcp.json` de la raíz del proyecto —no lleva token, se puede commitear—:

```json
{"mcpServers":{"yorobot":{"type":"http","url":"https://yorobot.ai/api/mcp"}}}
```

Cursor: en `~/.cursor/mcp.json`

```json
{"mcpServers":{"yorobot":{"url":"https://yorobot.ai/api/mcp"}}}
```

Si tu herramienta no sabe OAuth, generás un **token MCP** en el Inicio (o Ajustes → Accesos) y lo pasás como `Authorization: Bearer`; vence a los 30 días. Los dos caminos terminan en el mismo tipo de acceso y se cortan desde Accesos.

La documentación también es un MCP, público y sin login — para que el agente de código consulte qué argumentos lleva cada herramienta mientras programa:

```bash
claude mcp add --transport http yorobot-docs https://yorobot.ai/api/mcp/docs
```

El paso se tacha solo en el Inicio la primera vez que el acceso se usa.

## 3. Probar el agente

Desde el editor:

```text
> llamá quien_soy y después probar_agente con el agente Bienvenida y la entrada "hola"
```

`probar_agente` encola la corrida, espera y devuelve la traza. Si la organización todavía no tiene modelo o worker configurado, la herramienta lo dice con un link a dónde ir en vez de quedarse esperando. La primera respuesta que reporta el worker cierra el recorrido.

## Después

- Crear tu propio agente: `crear_agente` con `nombre`, `instruccion` (en segunda persona) y `como_se_verifica`.
- Conectarle una app del catálogo: `listar_herramientas`, `cargar_credencial`, `editar_agente`.
- Llevarlo a producción: `promover_agente` con `hasta: 'prod'`. Producción exige que una persona con rol técnico o admin firme.

Todo lo que hace el MCP también está en el portal, y al revés. La [Referencia MCP](/docs/mcp) es la lista completa.
