Actúa por alguien, y se nota
Un token se liga a una persona del equipo. Lo que escribe queda a nombre de ella y con sus permisos, nunca con más. El agente es la vía; la responsable es ella.
API y agentes
No hay una API «para integraciones» distinta de la que mueve el producto: lo que hace la pantalla lo hace la API, con las mismas reglas y los mismos límites. Se conecta un agente, un script propio o el sistema que ya tengas.
Las reglas
Un agente con acceso a tu CRM da miedo por buenas razones. Estas son las líneas que no cruza, y no dependen de cómo esté escrito su prompt: las aplica el servidor.
Un token se liga a una persona del equipo. Lo que escribe queda a nombre de ella y con sus permisos, nunca con más. El agente es la vía; la responsable es ella.
Leer la bandeja de correo, contestar por WhatsApp, armar un tablero o registrar un pago son permisos distintos. Se dan de uno en uno y se quitan igual.
Cuando se agrega un módulo, sus permisos no se reparten solos entre los tokens que ya existían. Alguien tiene que darlos a propósito.
Publicar una propuesta o el portal de un proyecto acuña el enlace que verá alguien de fuera de tu empresa. Eso no lo hace un token, ni actuando por alguien.
Si un token no está ligado a nadie, no puede crear una propuesta ni contestarle a un cliente: sería una voz de la empresa que nadie firmó.
Al crear un token se muestra su clave y no vuelve a estar disponible. Se revoca cuando haga falta y deja de servir en el acto.
Se explica sola
Hay un endpoint que devuelve el contrato completo: cada recurso con sus rutas, qué significa cada estado del negocio y las reglas que un agente debe respetar. No hace falta mandarle documentación aparte ni mantenerla al día por tu cuenta.
Como herramientas MCP, el mismo contrato llega ya masticado: cada una dice para qué sirve, qué necesita y qué error va a recibir si se equivoca.
Lo que ve un agente al conectarse
GET /api/v1/auth/me
→ scopes que trae este token,
y por qué persona actúa
GET /api/v1/schema
→ los recursos, sus rutas,
el vocabulario del negocio
y las reglas para agentesLos errores dicen qué falta: un permiso, una persona detrás del token, o que eso lo hace un humano.
Para qué se usa
Creas un token, lo ligas a tu usuario, le das solo lectura y le preguntas qué puede hacer. Ampliar permisos después es una casilla.
Empezar la prueba