YoRobot.

Esta página en Markdown: /docs/quickstart.md

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 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—:

{"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/docs

El 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_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 es la lista completa.