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. 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.
# 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 yorobotEn 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—:
{"mcpServers":{"yorobot":{"type":"http","url":"https://yorobot.ai/api/mcp"}}}Cursor: en ~/.cursor/mcp.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:
claude mcp add --transport http yorobot-docs https://yorobot.ai/api/mcp/docsEl paso se tacha solo en el Inicio la primera vez que el acceso se usa.
3. Probar el agente
Desde el editor:
> 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_agenteconnombre,instruccion(en segunda persona) ycomo_se_verifica. - Conectarle una app del catálogo:
listar_herramientas,cargar_credencial,editar_agente. - Llevarlo a producción:
promover_agenteconhasta: '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 es la lista completa.